diff options
author | Balint Reczey <balint.reczey@canonical.com> | 2019-03-03 23:31:24 +0100 |
---|---|---|
committer | Balint Reczey <balint.reczey@canonical.com> | 2019-03-03 23:31:24 +0100 |
commit | b0729855e8fb744192a0395ea24673557818172c (patch) | |
tree | f2c3f13b5ba33b0b1f3627c24cd4005e0972ff86 /man/su.1.xml | |
parent | 589f97ade4610b98cc532c8142343d4c33694e72 (diff) | |
download | shadow-b0729855e8fb744192a0395ea24673557818172c.tar.gz |
New upstream version 4.6upstream/4.6
Diffstat (limited to 'man/su.1.xml')
-rw-r--r-- | man/su.1.xml | 41 |
1 files changed, 20 insertions, 21 deletions
diff --git a/man/su.1.xml b/man/su.1.xml index 24143c38..4b413fc8 100644 --- a/man/su.1.xml +++ b/man/su.1.xml @@ -85,12 +85,16 @@ <cmdsynopsis> <command>su</command> <arg choice='opt'> - <replaceable>options</replaceable> + <replaceable>options</replaceable> </arg> <arg choice='opt'> - <arg choice='plain'> - <replaceable>username</replaceable> - </arg> + <replaceable>-</replaceable> + </arg> + <arg choice='opt'> + <replaceable>username</replaceable> + <arg choice='opt'> + <replaceable>args</replaceable> + </arg> </arg> </cmdsynopsis> </refsynopsisdiv> @@ -98,26 +102,21 @@ <refsect1 id='description'> <title>DESCRIPTION</title> <para> - The <command>su</command> command is used to become another user during - a login session. Invoked without a <option>username</option>, - <command>su</command> defaults to - becoming the superuser. The optional argument <option>-</option> may - be used to provide an environment similar to what the user would - expect had the user logged in directly. - </para> - - <para> - Additional arguments may be provided after the username, in which case - they are supplied to the user's login shell. In particular, an - argument of <option>-c</option> will cause the next argument to be - treated as a command by most command interpreters. The command will be - executed by the shell specified in <filename>/etc/passwd</filename> - for the target user. + The <command>su</command> command is used to become another user during a + login session. Invoked without a <option>username</option>, + <command>su</command> defaults to becoming the superuser. The + <option>-</option> option may be used to provide an environment similar + to what the user would expect had the user logged in directly. The + <option>-c</option> option may be used to treat the next argument as a + command by most shells. </para> <para> - You can use the <option>--</option> argument to separate - <command>su</command> options from the arguments supplied to the shell. + Options are recognized everywhere in the argument list. You can use the + <option>--</option> argument to stop option parsing. The + <option>-</option> option is special: it is also recognized after + <option>--</option>, but has to be placed before + <option>username</option>. </para> <para>The user will be prompted for a password, if appropriate. Invalid |