mirror of
https://github.com/hackacad/bastille.git
synced 2025-12-14 02:40:49 +01:00
75 lines
2.7 KiB
ReStructuredText
75 lines
2.7 KiB
ReStructuredText
mount
|
|
=====
|
|
|
|
To mount storage within the container use ``bastille mount``.
|
|
|
|
Syntax follows standard ``/etc/fstab`` format:
|
|
|
|
.. code-block:: shell
|
|
|
|
Usage: bastille mount TARGET HOST_PATH JAIL_PATH [filesystem_type options dump pass_number]
|
|
|
|
The ``options`` string can include a comma-separated list of mount options, but
|
|
must include one of (rw,ro,rq,sw,xx) according to fstab documentation.
|
|
|
|
Example: Mount a tmpfs filesystem with options.
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # bastille mount azkaban tmpfs tmp tmpfs rw,nosuid,mode=01777 0 0
|
|
Detected advanced mount type tmpfs
|
|
[azkaban]:
|
|
Added: tmpfs /usr/local/bastille/jails/azkaban/root/tmp tmpfs rw,nosuid,mode=01777 0 0
|
|
|
|
Example: Mount a nullfs filesystem
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # bastille mount azkaban /storage/foo media/foo nullfs ro 0 0
|
|
[azkaban]:
|
|
Added: /media/foo /usr/local/bastille/jails/azkaban/root/media/foo nullfs ro 0 0
|
|
ishmael ~ # bastille mount azkaban /storage/bar /media/bar nullfs ro 0 0
|
|
[azkaban]:
|
|
Added: /media/bar /usr/local/bastille/jails/azkaban/root/media/bar nullfs ro 0 0
|
|
|
|
Notice the JAIL_PATH format can be /media/foo or simply media/bar. The leading
|
|
slash / is optional. The HOST_PATH howerver, must be the full path including the
|
|
leading slash /.
|
|
|
|
It is also possible to mount individual files into a jail as seen below.
|
|
Bastille will not mount if a file is already present at the specified mount
|
|
point.
|
|
If the jail file name does not match the host file name, bastille will treat the
|
|
jail path as a directory, and mount the file underneath as seen in the second
|
|
example below.
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # bastille mount azkaban /etc/rc.conf /mnt/etc/rc.conf nullfs ro 0 0
|
|
[azkaban]:
|
|
Added: /etc/rc.conf /usr/local/bastille/jails/azkaban/root/mnt/etc/rc.conf nullfs ro 0 0
|
|
ishmael ~ # bastille mount azkaban /etc/rc.conf /media/bar nullfs ro 0 0
|
|
[azkaban]:
|
|
Added: /etc/rc.conf usr/local/bastille/jails/azkaban/root/media/bar/rc.conf nullfs ro 0 0
|
|
|
|
It is also possible (but not recommended) to have spaces in the directories that
|
|
are mounted.
|
|
It is necessary to escape each space with a backslash \ and enclose the mount
|
|
point in quotes "" as seen below.
|
|
It is possible to do the same for the jail path, but again, not recommemded.
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # bastille mount azkaban "/storage/my\ directory\ with\ spaces" /media/foo nullfs ro 0 0
|
|
[azkaban]:
|
|
Added: /storage/my\040directory\040with\040spaces /usr/local/bastille/jails/azkaban/root/media/foo nullfs ro 0 0
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # bastille mount help
|
|
Usage: bastille mount [option(s)] TARGET HOST_PATH JAIL_PATH [filesystem_type options dump pass_number]
|
|
Options:
|
|
|
|
-a | --auto Auto mode. Start/stop jail(s) if required.
|
|
-x | --debug Enable debug mode.
|