]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
runuser.1.adoc: Move -m|-p|--preserve-environment in order
authorSebastian Pipping <sebastian@pipping.org>
Fri, 5 Jan 2024 23:43:20 +0000 (00:43 +0100)
committerSebastian Pipping <sebastian@pipping.org>
Mon, 8 Jan 2024 18:46:50 +0000 (19:46 +0100)
.. for alphabetical order and to match sibling file su.1.adoc.

login-utils/runuser.1.adoc

index 3872d8d5a8c5bc8590be3ae62582e7b5a319845b..4708e02a1b70fbc469d9e737ed0cdd81f8843d24 100644 (file)
@@ -52,14 +52,14 @@ Start the shell as a login shell with an environment similar to a real login:
 * changes to the target user's home directory
 * sets argv[0] of the shell to '*-*' in order to make the shell a login shell
 
+*-m*, *-p*, *--preserve-environment*::
+Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or *LOGNAME*. The option is ignored if the option *--login* is specified.
+
 *-P*, *--pty*::
 Create a pseudo-terminal for the session. The independent terminal provides better security as the user does not share a terminal with the original session. This can be used to avoid TIOCSTI ioctl terminal injection and other security attacks against terminal file descriptors. The entire session can also be moved to the background (e.g., *runuser --pty* *-u* _username_ *--* _command_ *&*). If the pseudo-terminal is enabled, then *runuser* works as a proxy between the sessions (sync stdin and stdout).
 +
 This feature is mostly designed for interactive sessions. If the standard input is not a terminal, but for example a pipe (e.g., *echo "date" | runuser --pty -u* _user_), then the *ECHO* flag for the pseudo-terminal is disabled to avoid messy output.
 
-*-m*, *-p*, *--preserve-environment*::
-Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or *LOGNAME*. The option is ignored if the option *--login* is specified.
-
 *-s*, *--shell*=_shell_::
 Run the specified _shell_ instead of the default. The shell to run is selected according to the following rules, in order: