docs-xml: Update documentation for removal of NIS support
authorAndreas Schneider <asn@samba.org>
Wed, 21 Apr 2021 08:30:56 +0000 (10:30 +0200)
committerJeremy Allison <jra@samba.org>
Thu, 22 Apr 2021 17:57:30 +0000 (17:57 +0000)
Signed-off-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
docs-xml/manpages/smb.conf.5.xml
docs-xml/smbdotconf/misc/homedirmap.xml [deleted file]
docs-xml/smbdotconf/misc/nishomedir.xml [deleted file]
docs-xml/smbdotconf/protocol/nameresolveorder.xml
docs-xml/smbdotconf/security/hostsallow.xml
docs-xml/smbdotconf/security/invalidusers.xml
docs-xml/smbdotconf/security/passwdchat.xml
docs-xml/smbdotconf/security/usernamemap.xml
docs-xml/smbdotconf/security/usernamemapscript.xml
docs-xml/smbdotconf/security/validusers.xml
docs-xml/smbdotconf/winbind/winbindseparator.xml

index b12f67c633450d711ac7509215259e568974628b..eb4bcba3ee51339eec668235054d0c48d0ed633a 100644 (file)
@@ -627,13 +627,6 @@ chmod 1770 /usr/local/samba/lib/usershares
                <term>%N</term>
                <listitem><para>This value is the same as %L.</para></listitem>
                </varlistentry>
-       
-               <varlistentry>
-               <term>%p</term>
-               <listitem><para>
-                       the path of the service's home directory, obtained from your NIS auto.map entry. The NIS
-                       auto.map entry is split up as <literal>%N:%p</literal>.</para></listitem>
-               </varlistentry>
        </variablelist>
        
        <para>
diff --git a/docs-xml/smbdotconf/misc/homedirmap.xml b/docs-xml/smbdotconf/misc/homedirmap.xml
deleted file mode 100644 (file)
index ba70730..0000000
+++ /dev/null
@@ -1,28 +0,0 @@
-<samba:parameter name="homedir map"
-                 context="G"
-                 type="string"
-                 substitution="1"
-                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
- <description>
-       <para>
-       If <smbconfoption name="nis homedir"/> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
-       <manvolnum>8</manvolnum></citerefentry> is also acting  as a Win95/98 <parameter moreinfo="none">logon server</parameter> 
-       then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted.  
-       At present, only the Sun auto.home map format is understood. The form of the map is:
-<programlisting>
-<command moreinfo="none">username server:/some/file/system</command>
-</programlisting>
-       and the program will extract the servername from before the first ':'.  There should probably be a better parsing system 
-       that copes with different map formats and also Amd (another automounter) maps.
-       </para>
-               
-       <note><para>
-       A working NIS client is required on the system for this option to work.
-       </para></note>
-</description>
-<related>nis homedir</related>
-<related>domain logons</related>
-
-<value type="default"></value>
-<value type="example">amd.homedir</value>
-</samba:parameter>
diff --git a/docs-xml/smbdotconf/misc/nishomedir.xml b/docs-xml/smbdotconf/misc/nishomedir.xml
deleted file mode 100644 (file)
index ace8475..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-<samba:parameter name="NIS homedir"
-                 context="G"
-                 type="boolean"
-                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
-<description>
-       <para>Get the home share server from a NIS map. For 
-       UNIX systems that use an automounter, the user's home directory 
-       will often be mounted on a workstation on demand from a remote 
-       server. </para>
-
-       <para>When the Samba logon server is not the actual home directory 
-       server, but is mounting the home directories via NFS then two 
-       network hops would be required to access the users home directory 
-       if the logon server told the client to use itself as the SMB server 
-       for home directories (one over SMB and one over NFS). This can 
-       be very slow.</para>
-
-       <para>This option allows Samba to return the home share as 
-       being on a different server to the logon server and as 
-       long as a Samba daemon is running on the home directory server, 
-       it will be mounted on the Samba client directly from the directory 
-       server. When Samba is returning the home share to the client, it 
-       will consult the NIS map specified in
-       <smbconfoption name="homedir map"/> and return the server 
-       listed there.</para>
-
-       <para>Note that for this option to work there must be a working 
-       NIS system and the Samba server with this option must also 
-       be a logon server.</para>
-</description>
-<value type="default">no</value>
-</samba:parameter>
index e29eabb87df6d696c14e33e3e6bd22e8005033c3..b85d060e7cefb654d12759595075d46791657153 100644 (file)
@@ -26,7 +26,7 @@
        <listitem>
            <para>
                <constant>host</constant> : Do a standard host name to IP address resolution, using the system
-               <filename moreinfo="none">/etc/hosts </filename>, NIS, or DNS lookups. This method of name resolution is
+               <filename moreinfo="none">/etc/hosts </filename> or DNS lookups. This method of name resolution is
                operating system depended for instance on IRIX or Solaris this may be controlled by the <filename
                moreinfo="none">/etc/nsswitch.conf</filename> file.  Note that this method is used only if the NetBIOS name
                type being queried is the 0x20 (server) name type or 0x1c (domain controllers).  The latter case is only
index 8b4b62268a37c361f320b1a91299f6760b24887d..a052e7f79cdb1ef0a90f8e050ec14e79edf0d459 100644 (file)
 
     <para><command moreinfo="none">hosts allow = lapland, arvidsjaur</command></para>
 
-    <para>Example 4: allow only hosts in NIS netgroup &quot;foonet&quot;, but 
-    deny access from one particular host</para>
-
-    <para><command moreinfo="none">hosts allow = @foonet</command></para>
-
-    <para><command moreinfo="none">hosts deny = pirate</command></para>
-
     <note><para>Note that access still requires suitable user-level passwords.</para></note>
 
     <para>See <citerefentry><refentrytitle>testparm</refentrytitle>
index b2fb2b9d293a4f0557b4d90b6c31a387bb03bd12..268cdfad5603782f6ce79d97bb620b9624bbc727 100644 (file)
@@ -7,21 +7,8 @@
     to login to this service. This is really a <emphasis>paranoid</emphasis> 
     check to absolutely ensure an improper setting does not breach 
     your security.</para>
-               
-    <para>A name starting with a '@' is interpreted as an NIS 
-    netgroup first (if your system supports NIS), and then as a UNIX 
-    group if the name was not found in the NIS netgroup database.</para>
 
-    <para>A name starting with '+' is interpreted only 
-    by looking in the UNIX group database via the NSS getgrnam() interface. A name starting with 
-    '&amp;' is interpreted only by looking in the NIS netgroup database 
-    (this requires NIS to be working on your system). The characters 
-    '+' and '&amp;' may be used at the start of the name in either order 
-    so the value <parameter moreinfo="none">+&amp;group</parameter> means check the 
-    UNIX group database, followed by the NIS netgroup database, and 
-    the value <parameter moreinfo="none">&amp;+group</parameter> means check the NIS
-    netgroup database, followed by the UNIX group database (the 
-    same as the '@' prefix).</para>
+    <para>A name starting with a '@' is interpreted UNIX group.</para>
 
     <para>The current servicename is substituted for <parameter moreinfo="none">%S</parameter>. 
                This is useful in the [homes] section.</para>
index 23f8e6e1570eb01efa585a0ca4e1a911888b0e5d..a04fc62fdf6e1c1b9629ffad32b8302f03284dd4 100644 (file)
     received then the password is not changed.</para>
 
     <para>This chat sequence is often quite site specific, depending 
-    on what local methods are used for password control (such as NIS 
-    etc).</para>
+    on what local methods are used for password control.</para>
 
     <para>Note that this parameter only is used if the <smbconfoption
     name="unix password sync"/> parameter is set  to <constant>yes</constant>. This sequence is 
     then called <emphasis>AS ROOT</emphasis> when the SMB password  in the 
     smbpasswd file is being changed, without access to the old password
     cleartext. This means that root must be able to reset the user's password without
-    knowing the text of the previous password. In the presence of
-    NIS/YP,  this means that the <smbconfoption name="passwd program"/> must
-    be executed on the NIS master.
+    knowing the text of the previous password.
     </para>
 
     <para>The string can contain the macro <parameter
index 809a54c1e2ff170663b80426c60c682dc55e7cf0..eab72bb8672c3d984476f524d038d77eeb8f63e4 100644 (file)
        </para>
 
 
-    <para>
-       If your system supports the NIS NETGROUP option then the netgroup database is checked before the <filename
-       moreinfo="none">/etc/group </filename> database for matching groups.
-       </para>
-
     <para>
        You can map Windows usernames that have spaces in them by using double quotes around the name. For example:
 <programlisting>
index 86118f305bc6119dacff137de205c386e801f285..7b797cbae1c9463f0d28327ab2d751a1f7e1ab17 100644 (file)
@@ -10,7 +10,7 @@
        command line option (the username transmitted in the authentication
        request) and return a line on standard output (the name to which
        the account should mapped).  In this way, it is possible to store
-       username map tables in an LDAP or NIS directory services.
+       username map tables in an LDAP directory services.
        </para>
 </description>
 
index 0b681a1fef57a0e406a68c35b10c66295c95ddb2..6b0bacfd78a6257ce2389a9202a68a0109223762 100644 (file)
@@ -4,9 +4,10 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
     <para>
-    This is a list of users that should be allowed to login to this service. Names starting with 
-    '@', '+' and  '&amp;' are interpreted using the same rules as described in the 
-    <parameter moreinfo="none">invalid users</parameter> parameter.
+        This is a list of users that should be allowed to login to this service.
+        Names starting with an '@' are interpreted using the same rules as
+        described in the
+        <parameter moreinfo="none">invalid users</parameter> parameter.
     </para>
 
     <para>
index eda14f4e03a6f9b456b1409ad7fadc41f2a3f142..9be46109cd6403e484c729875d63f4238ad2fe75 100644 (file)
@@ -10,9 +10,9 @@
        and <filename moreinfo="none">nss_winbind.so</filename> modules for UNIX services.
        </para>
 
-       <para>Please note that setting this parameter to + causes problems
+       <para>Please note that setting this parameter to + can cause problems
        with group membership at least on glibc systems, as the character +
-       is used as a special character for NIS in /etc/group.</para>
+       was used as a special character for NIS in /etc/group.</para>
 </description>
 
 <value type="default">\</value>