RGBCube/serenity
1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-07-25 06:37:43 +00:00
Code Issues Activity Actions

Base: Document new chroot abilities

Browse source
This commit is contained in:
Sergey Bugaev 2020-01-12 21:54:06 +03:00 • committed by Andreas Kling
parent 33c0dc08a7
commit 9513f54932
2 changed files with 12 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Base/usr/share/man/man2/chroot.md
View file

@ -1,6 +1,6 @@
## Name ## Name
chroot - change filesystem root chroot, chroot_with_mount_flags - change filesystem root
## Synopsis ## Synopsis
@ -8,12 +8,18 @@ chroot - change filesystem root
#include <unistd.h> #include <unistd.h>
int chroot(const char* path); int chroot(const char* path);
int chroot_with_mount_flags(const char* path, int mount_flags);
``` ```
## Description ## Description
`chroot()` changes the filesystem root of the current process to a new directory specified by `path`. `chroot()` changes the filesystem root of the current process to a new directory specified by `path`.
`chroot_with_mount_flags()` additionally applies the given `mount_flags` to the new root directory
of the current process as if it was a separate mount. All the same flags as for [`mount`(2)](mount.md)
are accepted, except `MS_BIND` doesn't make sense for chroots. Additionally, the value -1 is accepted,
and makes `chroot_with_mount_flags()` behave like regular `chroot()`.
## Errors ## Errors
* `EPERM`: The current process does not have superuser privileges. * `EPERM`: The current process does not have superuser privileges.
@ -24,3 +30,4 @@ All of the usual path resolution errors may also occur.
## See also ## See also
* [`chroot`(8)](../man8/chroot.md) * [`chroot`(8)](../man8/chroot.md)
* [`mount`(2)](mount.md)

6
Base/usr/share/man/man8/chroot.md
View file

@ -5,7 +5,7 @@ chroot - run a shell with a different filesystem root
## Synopsis ## Synopsis
```**sh ```**sh
# chroot # chroot <path> [program] [-o options]
``` ```
## Description ## Description
@ -13,7 +13,8 @@ chroot - run a shell with a different filesystem root
This program uses the [`chroot`(2)](../man2/chroot.md) syscall to switch into a This program uses the [`chroot`(2)](../man2/chroot.md) syscall to switch into a
different filesystem root and spawn a shell inside it. different filesystem root and spawn a shell inside it.
It will not work unless there is a `/bin/Shell` available inside the new root. It runs the given *program* (by default, `/bin/Shell`) inside the new root.
Mount options can be given in the same format as for [`mount`(8)](mount.md).
## Examples ## Examples
@ -26,3 +27,4 @@ It will not work unless there is a `/bin/Shell` available inside the new root.
## See also ## See also
* [`chroot`(2)](../man2/chroot.md) * [`chroot`(2)](../man2/chroot.md)
* [`mount`(8)](mount.md)