network
=======

Add or remove interfaces to existing jails.

You can only add an interface once to a jail, with two exceptions.

1. For classic jails, you can add an interface as many times as you want, but
   each time with a different IP. All this does is add the IP as another alias
   on that interface. This is the default if no option is given. See help output
   below.

2. For VNET jails, if the ``-v|--vlan`` switch is given along with a numerical
   VLAN ID, Bastille will add the VLAN ID to the jail as a vnetX.X interface,
   depending on which interface is specified.

Bridges and VNET interfaces can be added to VNET jails, no matter if they were
created with ``-V`` or ``-B``.

If no option is given, Bastille will assume a standard/classic jail.

It is possible to passthrough an entire interface from the host to the jail
using the ``-P|--passthrough`` option. This will make the interface fully
available without the need for additional configuration. It will be available
inside the jail just like it would be on the host. Adding an interface using
this method will render it only available inside the jail. It will not be
present on the host until the jail is stopped.

When cloning a jail that has a ``-P|--passthrough`` interface, you will have
warnings when running both jails at the same time. The first jail to start will
be assigned the interface, and since it will no longer be available to the host,
it will not be possible to add it to the second jail. To solve this, you must
manually remove the interface from the jail.conf file, or running ``bastille
network TARGET remove INTERFACE`` while both jails are stopped.

.. code-block:: shell

  ishmael ~ # bastille network help
  Usage: bastille network [option(s)] TARGET [remove|add] INTERFACE [IP]

      Options:

      -a | --auto                 Start/stop jail(s) if required.
      -B | --bridge               Add a bridge VNET interface.
      -M | --static-mac           Generate a static MAC address for the interface (VNET only).
      -n | --no-ip                Create interface without an IP (VNET only).
      -P | --passthrough          Add a raw interface.
      -V | --vnet                 Add a VNET interface.
      -v | --vlan VLANID          Assign VLAN ID to interface (VNET only).
      -x | --debug                Enable debug mode.