docs/docbook/smbdotconf/misc/nishomedir.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="NISHOMEDIR"/>nis homedir (G)</term>
   3                 <listitem><para>Get the home share server from a NIS map. For
   4                 UNIX systems that use an automounter, the user's home directory
   5                 will often be mounted on a workstation on demand from a remote
   6                 server. </para>
   7
   8                 <para>When the Samba logon server is not the actual home directory
   9                 server, but is mounting the home directories via NFS then two
  10                 network hops would be required to access the users home directory
  11                 if the logon server told the client to use itself as the SMB server
  12                 for home directories (one over SMB and one over NFS). This can
  13                 be very slow.</para>
  14
  15                 <para>This option allows Samba to return the home share as
  16                 being on a different server to the logon server and as
  17                 long as a Samba daemon is running on the home directory server,
  18                 it will be mounted on the Samba client directly from the directory
  19                 server. When Samba is returning the home share to the client, it
  20                 will consult the NIS map specified in <link linkend="HOMEDIRMAP">
  21                 <parameter moreinfo="none">homedir map</parameter></link> and return the server
  22                 listed there.</para>
  23
  24                 <para>Note that for this option to work there must be a working
  25                 NIS system and the Samba server with this option must also
  26                 be a logon server.</para>
  27
  28                 <para>Default: <command moreinfo="none">nis homedir = no</command></para>
  29                 </listitem>
  30                 </samba:parameter>