ld-iamroot.so - execute the program in an iamroot environment
Executes the PROGRAM in an iamroot environment ready to emulate the chroot(2) syscall for unprivileged users.
Under the hood, /usr/lib/iamroot/ld-iamroot.so runs the PROGRAM with its ARGUMENTS by rewriting the command-line using the dynamic loader stored in the .interp section of the PROGRAM.
For a more thorough description of ld.so(8), ld-linux.so(8), or any other dynamic loader, please refers to their manuals.
- -A or --argv0 string
-
Set argv[0] to the value string before running the PROGRAM.
- -P or --preload list
-
Preload the objects specified in list.
- -L or --library-path path
-
Use path instead of LD_LIBRARY_PATH environment variable setting.
- -O or --origin dir
-
Set origin directory to dir.
- -M or --multiarch
-
Use multiarch library path in chroot.
- -R or --root dir
-
Set root directory to dir.
- -C or --cwd dir
-
Set current working directory to dir.
- -D or --debug
-
Turn on debug mode.
- -h or --help
-
Display this message.
- -V or --version
-
Display the version.
- IAMROOT_ORIGIN
-
Set absolute path to origin directory of iamroot. Equivalent to --origin DIR.
- IAMROOT_MULTIARCH
-
Use multiarch default library path in chroot. Equivalent to --multiarch.
- IAMROOT_ROOT
-
Set absolute path to root directory to chroot in. Equivalent to --root DIR.
- LD_LIBRARY_PATH
-
A list of directories in which to search for ELF libraries at execution time. The items in the list are separated by either colons or semicolons, and there is no support for escaping either separator. A zero-length directory name indicates the current working directory.
- LD_PRELOAD
-
A list of additional, user-specified, ELF shared objects to be loaded before all others. This feature can be used to selectively override functions in other shared objects.
Report bugs at https://github.com/gportay/iamroot/issues
Copyright (c) 2024 Gaël PORTAY
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.