| 1 | schroot |
|---|
| 2 | ======= |
|---|
| 3 | |
|---|
| 4 | Securely enter a chroot and run a command or login shell. |
|---|
| 5 | |
|---|
| 6 | Note that giving untrusted users root access to chroots is a serious |
|---|
| 7 | security risk! Although the untrusted user will only have root access |
|---|
| 8 | to files inside the chroot, in practice there are many obvious ways of |
|---|
| 9 | breaking out of the chroot and of disrupting services on the host |
|---|
| 10 | system. As always, this boils down to trust. Don't give chroot root |
|---|
| 11 | access to users you would not trust with root access to the host |
|---|
| 12 | system. |
|---|
| 13 | |
|---|
| 14 | For compatibility with existing tools and scripts, wrapper binaries |
|---|
| 15 | for dchroot and DSA dchroot are provided. |
|---|
| 16 | |
|---|
| 17 | |
|---|
| 18 | Build Dependencies |
|---|
| 19 | ------------------ |
|---|
| 20 | |
|---|
| 21 | An ISO C++ compiler supporting TR1 (e.g. GCC 4.x), or an ISO C++ |
|---|
| 22 | compiler and the Boost libraries |
|---|
| 23 | libstdc++ (GNU libstdc++) |
|---|
| 24 | libpam0g-dev (Linux-PAM) |
|---|
| 25 | liblockdev1-dev |
|---|
| 26 | libboost-dev } |
|---|
| 27 | libboost-program-options-dev } The Boost C++ libraries |
|---|
| 28 | libboost-regex-dev } |
|---|
| 29 | uuid-dev (e2fsprogs) |
|---|
| 30 | |
|---|
| 31 | If building from GIT, you will also need: |
|---|
| 32 | gettext (0.16) |
|---|
| 33 | doxygen |
|---|
| 34 | |
|---|
| 35 | |
|---|
| 36 | Translation |
|---|
| 37 | ----------- |
|---|
| 38 | |
|---|
| 39 | If you would like to see the schroot messages output in your own |
|---|
| 40 | language, please consider translating the pot file (po/schroot.pot). |
|---|
| 41 | |
|---|
| 42 | |
|---|
| 43 | Building and installation |
|---|
| 44 | ------------------------- |
|---|
| 45 | |
|---|
| 46 | Please see the INSTALL file for generic installation instructions. |
|---|
| 47 | Note that the testsuite ("make check") should be run under fakeroot or |
|---|
| 48 | real root in order to work correctly. There are the following |
|---|
| 49 | additional options: |
|---|
| 50 | |
|---|
| 51 | --enable-dchroot: Build dchroot |
|---|
| 52 | --enable-dchroot-dsa: Build DSA dchroot |
|---|
| 53 | --enable-debug: Enable debugging features (not recommended) |
|---|
| 54 | |
|---|
| 55 | |
|---|
| 56 | Configuration |
|---|
| 57 | ------------- |
|---|
| 58 | |
|---|
| 59 | See schroot.conf(5) and schroot-setup(5). |
|---|
| 60 | |
|---|
| 61 | |
|---|
| 62 | Running |
|---|
| 63 | ------- |
|---|
| 64 | |
|---|
| 65 | See schroot(1). |
|---|
