Doc updates from John + some minor fixes by me
[samba.git] / docs / docbook / smbdotconf / misc / utmp.xml
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="UTMP"/>utmp (G)</term>
3                 <listitem><para>This boolean parameter is only available if
4                 Samba has been configured and compiled  with the option <command moreinfo="none">
5                 --with-utmp</command>. If set to <constant>yes</constant> then Samba will attempt
6                 to add utmp or utmpx records (depending on the UNIX system) whenever a
7                 connection is made to a Samba server. Sites may use this to record the
8                 user connecting to a Samba share.</para>
9
10                 <para>Due to the requirements of the utmp record, we
11                 are required to create a unique identifier for the
12                 incoming user.  Enabling this option creates an n^2
13                 algorithm to find this number.  This may impede
14                 performance on large installations. </para>
15
16                 <para>See also the <link linkend="UTMPDIRECTORY"><parameter moreinfo="none">
17                 utmp directory</parameter></link> parameter.</para>
18
19                 <para>Default: <command moreinfo="none">utmp = no</command></para>
20                 </listitem>
21                 </samba:parameter>