* man/su.1.xml: Use <option> for the login.defs options.
* man/su.1.xml: Improve the documentation of the su behavior regarding environment variables. * man/su.1.xml: Document that the login.defs file is used.
This commit is contained in:
parent
ae69e6da5a
commit
5cd975acbf
@ -1,3 +1,10 @@
|
|||||||
|
2009-06-04 Nicolas François <nicolas.francois@centraliens.net>
|
||||||
|
|
||||||
|
* man/su.1.xml: Use <option> for the login.defs options.
|
||||||
|
* man/su.1.xml: Improve the documentation of the su behavior
|
||||||
|
regarding environment variables.
|
||||||
|
* man/su.1.xml: Document that the login.defs file is used.
|
||||||
|
|
||||||
2009-06-04 Nicolas François <nicolas.francois@centraliens.net>
|
2009-06-04 Nicolas François <nicolas.francois@centraliens.net>
|
||||||
|
|
||||||
* man/login.1.xml: Document that the login.defs file is used.
|
* man/login.1.xml: Document that the login.defs file is used.
|
||||||
|
114
man/su.1.xml
114
man/su.1.xml
@ -108,7 +108,7 @@
|
|||||||
<envar>$PATH</envar> is reset to <filename>/bin:/usr/bin</filename>
|
<envar>$PATH</envar> is reset to <filename>/bin:/usr/bin</filename>
|
||||||
for normal users, or <filename>/sbin:/bin:/usr/sbin:/usr/bin</filename>
|
for normal users, or <filename>/sbin:/bin:/usr/sbin:/usr/bin</filename>
|
||||||
for the superuser. This may be changed with the
|
for the superuser. This may be changed with the
|
||||||
<emphasis>ENV_PATH</emphasis> and <emphasis>ENV_SUPATH</emphasis>
|
<option>ENV_PATH</option> and <option>ENV_SUPATH</option>
|
||||||
definitions in <filename>/etc/login.defs</filename>.
|
definitions in <filename>/etc/login.defs</filename>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@ -162,30 +162,31 @@
|
|||||||
<para>The shell that will be invoked.</para>
|
<para>The shell that will be invoked.</para>
|
||||||
<para>
|
<para>
|
||||||
The invoked shell is chosen from (highest priority first):
|
The invoked shell is chosen from (highest priority first):
|
||||||
<itemizedlist>
|
<!--This should be an orderedlist, but lists inside another
|
||||||
<listitem>
|
list does not work well with current docbook.
|
||||||
|
- nekral - 2009.06.03 -->
|
||||||
|
<variablelist>
|
||||||
|
<varlistentry><term></term><listitem>
|
||||||
<para>The shell specified with --shell.</para>
|
<para>The shell specified with --shell.</para>
|
||||||
</listitem>
|
</listitem></varlistentry>
|
||||||
<listitem>
|
<varlistentry><term></term><listitem>
|
||||||
<para>
|
<para>
|
||||||
If <option>--preserve-environment</option> is used, the
|
If <option>--preserve-environment</option> is used, the
|
||||||
shell specified by the <envar>$SHELL</envar> environment
|
shell specified by the <envar>$SHELL</envar> environment
|
||||||
variable.
|
variable.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem></varlistentry>
|
||||||
<listitem>
|
<varlistentry><term></term><listitem>
|
||||||
<para>
|
<para>
|
||||||
The shell indicated in the <filename>/etc/passwd</filename>
|
The shell indicated in the <filename>/etc/passwd</filename>
|
||||||
entry for the target user.
|
entry for the target user.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem></varlistentry>
|
||||||
<listitem>
|
<varlistentry><term></term><listitem>
|
||||||
<para>
|
<para><filename>/bin/sh</filename> if a shell could not be
|
||||||
<filename>/bin/sh</filename> if a shell could not be
|
found by any above method.</para>
|
||||||
found by any above method.
|
</listitem></varlistentry>
|
||||||
</para>
|
</variablelist>
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
If the target user has a restricted shell (i.e. the shell field of
|
If the target user has a restricted shell (i.e. the shell field of
|
||||||
@ -203,11 +204,84 @@
|
|||||||
<option>--preserve-environment</option>
|
<option>--preserve-environment</option>
|
||||||
</term>
|
</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Preserve the current environment.</para>
|
<para>
|
||||||
|
Preserve the current environment, except for:
|
||||||
|
<variablelist>
|
||||||
|
<varlistentry>
|
||||||
|
<term><envar>$PATH</envar></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
reset according to the
|
||||||
|
<filename>/etc/login.defs</filename> options
|
||||||
|
<option>ENV_PATH</option> or
|
||||||
|
<option>ENV_SUPATH</option> (see below);
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
<varlistentry>
|
||||||
|
<term><envar>$IFS</envar></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
reset to
|
||||||
|
<quote><space><tab><newline></quote>,
|
||||||
|
if it was set.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
</para>
|
||||||
<para>
|
<para>
|
||||||
If the target user has a restricted shell, this option has no
|
If the target user has a restricted shell, this option has no
|
||||||
effect (unless <command>su</command> is called by root).
|
effect (unless <command>su</command> is called by root).
|
||||||
</para>
|
</para>
|
||||||
|
<para>
|
||||||
|
Note that the default behavior for the environment is the
|
||||||
|
following:
|
||||||
|
<variablelist>
|
||||||
|
<varlistentry><term></term><listitem>
|
||||||
|
<para>
|
||||||
|
The <envar>$HOME</envar>, <envar>$SHELL</envar>,
|
||||||
|
<envar>$USER</envar>, <envar>$LOGNAME</envar>,
|
||||||
|
<envar>$PATH</envar>, and <envar>$IFS</envar>
|
||||||
|
environment variables are reset.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
<varlistentry><term></term><listitem>
|
||||||
|
<para>
|
||||||
|
If <option>--login</option> is used, the
|
||||||
|
<envar>$TERM</envar>, <envar>$COLORTERM</envar>,
|
||||||
|
<envar>$DISPLAY</envar>, and
|
||||||
|
<envar>$XAUTHORITY</envar> environment variables are
|
||||||
|
kept if they were set.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
<varlistentry condition="no_pam"><term></term><listitem>
|
||||||
|
<para>
|
||||||
|
If <option>--login</option> is used, the
|
||||||
|
<envar>$TZ</envar>, <envar>$HZ</envar>, and
|
||||||
|
<envar>$MAIL</envar> environment
|
||||||
|
variables are set according to the
|
||||||
|
<filename>/etc/login.defs</filename>
|
||||||
|
options <option>ENV_TZ</option>,
|
||||||
|
<option>ENV_HZ</option>, <option>MAIL_DIR</option>, and
|
||||||
|
<option>MAIL_FILE</option> (see below).
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
<varlistentry><term></term><listitem>
|
||||||
|
<para>
|
||||||
|
Other environment variables might be set by
|
||||||
|
<phrase condition="no_pam">the
|
||||||
|
<option>ENVIRON_FILE</option> file (see
|
||||||
|
below)</phrase><phrase condition="pam">PAM
|
||||||
|
modules</phrase>.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
@ -264,6 +338,12 @@
|
|||||||
<para>Secure user account information.</para>
|
<para>Secure user account information.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
<varlistentry>
|
||||||
|
<term><filename>/etc/login.defs</filename></term>
|
||||||
|
<listitem>
|
||||||
|
<para>Shadow password suite configuration.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
@ -280,7 +360,7 @@
|
|||||||
</citerefentry>,
|
</citerefentry>,
|
||||||
<citerefentry>
|
<citerefentry>
|
||||||
<refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum>
|
<refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum>
|
||||||
</citerefentry>
|
</citerefentry>.
|
||||||
</para>
|
</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
</refentry>
|
</refentry>
|
||||||
|
Loading…
Reference in New Issue
Block a user