mirror of
https://github.com/hackacad/bastille.git
synced 2025-12-17 15:50:11 +01:00
48 lines
2.3 KiB
ReStructuredText
48 lines
2.3 KiB
ReStructuredText
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.
|
|
|
|
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``.
|
|
|
|
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_ADDRESS]
|
|
Options:
|
|
|
|
-a | --auto Start/stop the jail(s) if required.
|
|
-B | --bridge Add a bridged VNET interface to an existing jail.
|
|
-C | --classic Add an interface to a classic (non-VNET) jail.
|
|
-M | --static-mac Generate a static MAC address for the interface.
|
|
-n | --no-ip Create interface without an IP (VNET only).
|
|
-P | --passthrough Pass the entire interface through to the jail.
|
|
-V | --vnet Add a VNET interface to an existing jail.
|
|
-v | --vlan VLANID Add interface with specified VLAN ID (VNET only).
|
|
-x | --debug Enable debug mode.
|