First step in converting to XML: use strict syntax
authorJelmer Vernooij <jelmer@samba.org>
Tue, 28 Jan 2003 13:52:38 +0000 (13:52 +0000)
committerJelmer Vernooij <jelmer@samba.org>
Tue, 28 Jan 2003 13:52:38 +0000 (13:52 +0000)
(This used to be commit 89f9a0a0c451a627b70c8373431e691ab964c1ef)

docs/docbook/projdoc/ADS-HOWTO.sgml
docs/docbook/projdoc/Browsing-Quickguide.sgml
docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml
docs/docbook/projdoc/Integrating-with-Windows.sgml
docs/docbook/projdoc/Samba-PDC-HOWTO.sgml
docs/docbook/projdoc/msdfs_setup.sgml
docs/docbook/projdoc/printer_driver2.sgml
docs/docbook/projdoc/winbind.sgml

index 3e34d53c0afc6876897ea92ea54bedee5146937d..abe3f24fd5bef4e7d1eaf3b8a6aef445a19b9816 100644 (file)
@@ -14,7 +14,8 @@ This is a rough guide to setting up Samba 3.0 with kerberos authentication again
 Windows2000 KDC. 
 </para>
 
-<para>Pieces you need before you begin:
+<para>Pieces you need before you begin:</para>
+<para>
 <simplelist>
 <member>a Windows 2000 server.</member>
 <member>samba 3.0 or higher.</member>
@@ -26,7 +27,8 @@ Windows2000 KDC.
 <sect1>
 <title>Installing the required packages for Debian</title>
 
-<para>On Debian you need to install the following packages:
+<para>On Debian you need to install the following packages:</para>
+<para>
 <simplelist>
 <member>libkrb5-dev</member>
 <member>krb5-user</member>
@@ -37,7 +39,8 @@ Windows2000 KDC.
 <sect1>
 <title>Installing the required packages for RedHat</title>
 
-<para>On RedHat this means you should have at least: 
+<para>On RedHat this means you should have at least: </para>
+<para>
 <simplelist>
 <member>krb5-workstation (for kinit)</member>
 <member>krb5-libs (for linking with)</member>
@@ -99,7 +102,7 @@ In case samba can't figure out your ads server using your realm name, use the
 <para>The minimal configuration for krb5.conf is:</para>
 
 <para><programlisting>
-       [realms]
+[realms]
     YOUR.KERBEROS.REALM = {
        kdc = your.kerberos.server
     }
index 8ecc7959661f653b5dd406b880264c846295ede0..8e3fbce6d3cd7c65eab40ac75b2960a06c7145e8 100644 (file)
@@ -126,8 +126,9 @@ simultaneously the LMB on it's network segment.
 
 <para>
 The syntax of the "remote browse  sync" parameter is:
+
 <programlisting>
-       remote browse sync = a.b.c.d
+remote browse sync = a.b.c.d
 </programlisting>
 
 where a.b.c.d is either the IP address of the remote LMB or else is the network broadcast address of the remote segment.
@@ -243,36 +244,35 @@ The safest rule of all to follow it this - USE ONLY ONE PROTOCOL!
 <para>
 Resolution of NetBIOS names to IP addresses can take place using a number
 of methods. The only ones that can provide NetBIOS name_type information
-are:
+are:</para>
+
 <simplelist>
 <member>WINS: the best tool!</member>
 <member>LMHOSTS: is static and hard to maintain.</member>
 <member>Broadcast: uses UDP and can not resolve names across remote segments.</member>
 </simplelist>
-</para>
 
 <para>
-Alternative means of name resolution includes:
+Alternative means of name resolution includes:</para>
 <simplelist>
 <member>/etc/hosts: is static, hard to maintain, and lacks name_type info</member>
 <member>DNS: is a good choice but lacks essential name_type info.</member>
 </simplelist>
-</para>
 
 <para>
 Many sites want to restrict DNS lookups and want to avoid broadcast name
 resolution traffic. The "name resolve order" parameter is of great help here.
 The syntax of the "name resolve order" parameter is:
 <programlisting>
-       name resolve order = wins lmhosts bcast host
+name resolve order = wins lmhosts bcast host
 </programlisting>
 _or_
 <programlisting>
-       name resolve order = wins lmhosts       (eliminates bcast and host)
+name resolve order = wins lmhosts      (eliminates bcast and host)
 </programlisting>
 The default is:
 <programlisting>
-       name  resolve order = host lmhost wins bcast
+name  resolve order = host lmhost wins bcast
 </programlisting>.
 where "host" refers the the native methods used by the Unix system
 to implement the gethostbyname() function call. This is normally
index 6d5a019fcbe03e559f7a420e166e9dbe186f1524..06c1d3a87ee14920e7092f5f871cae36b9671225 100644 (file)
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="iso8859-1"?>
 <chapter id="groupmapping">
 <chapterinfo>
        <author>
index 3b0faf81af90613a152fa6eeaeca572ce3d50e8d..a4e79fd42bbc18e9b7b0567420e538a28c2285b9 100644 (file)
@@ -295,16 +295,16 @@ The following are typical NetBIOS name/service type registrations:
 
 <para><programlisting>
        Unique NetBIOS Names:
-               MACHINENAME<00> = Server Service is running on MACHINENAME
-               MACHINENAME<03> = Generic Machine Name (NetBIOS name)
-               MACHINENAME<20> = LanMan Server service is running on MACHINENAME
-               WORKGROUP<1b> = Domain Master Browser
+               MACHINENAME&lt;00&gt;   = Server Service is running on MACHINENAME
+               MACHINENAME&lt;03&gt; = Generic Machine Name (NetBIOS name)
+               MACHINENAME&lt;20&gt; = LanMan Server service is running on MACHINENAME
+               WORKGROUP&lt;1b&gt; = Domain Master Browser
 
        Group Names:
-               WORKGROUP<03> = Generic Name registered by all members of WORKGROUP
-               WORKGROUP<1c> = Domain Controllers / Netlogon Servers
-               WORKGROUP<1d> = Local Master Browsers
-               WORKGROUP<1e> = Internet Name Resolvers
+               WORKGROUP&lt;03&gt; = Generic Name registered by all members of WORKGROUP
+               WORKGROUP&lt;1c&gt; = Domain Controllers / Netlogon Servers
+               WORKGROUP&lt;1d&gt; = Local Master Browsers
+               WORKGROUP&lt;1e&gt; = Internet Name Resolvers
 </programlisting></para>
 
 <para>
@@ -323,7 +323,7 @@ be needed. An example of this is what happens when an MS Windows client
 wants to locate a domain logon server. It find this service and the IP 
 address of a server that provides it by performing a lookup (via a 
 NetBIOS broadcast) for enumeration of all machines that have 
-registered the name type *<1c>. A logon request is then sent to each 
+registered the name type *&lt;1c&gt;. A logon request is then sent to each 
 IP address that is returned in the enumerated list of IP addresses. Which 
 ever machine first replies then ends up providing the logon services.
 </para>
index 7cf3e5735c394fba918d09c31fdd386721e40224..e6d657392472639eb4a299daab8fd5ecb257ca93 100644 (file)
@@ -142,7 +142,7 @@ Implementing a Samba PDC can basically be divided into 2 broad
 steps.
 </para>
 
-<orderedlist numeration="Arabic">
+<orderedlist numeration="arabic">
        <listitem><para>
        Configuring the Samba PDC
        </para></listitem>
@@ -426,7 +426,7 @@ be created manually.
 
 <para><programlisting>
 [global]
-   # <...remainder of parameters...>
+   # &lt;...remainder of parameters...&gt;
    add user script = /usr/sbin/useradd -d /dev/null -g 100 -s /bin/false -M %u 
 </programlisting></para>
 
@@ -496,7 +496,7 @@ version of Windows.
        </para>
     
        <para>
-       A 'machine name' in (typically) <filename>/etc/passwd</>        
+       A 'machine name' in (typically) <filename>/etc/passwd</filename>        
        of the machine name with a '$' appended. FreeBSD (and other BSD 
        systems?) won't create a user with a '$' in their name.
        </para>
@@ -504,7 +504,7 @@ version of Windows.
        <para>
        The problem is only in the program used to make the entry, once 
        made, it works perfectly. So create a user without the '$' and 
-       use <command>vipw</> to edit the entry, adding the '$'. Or create 
+       use <command>vipw</command> to edit the entry, adding the '$'. Or create 
        the whole entry with vipw if you like, make sure you use a 
        unique User ID !
        </para>
@@ -673,8 +673,8 @@ Here are some additional details:
        Policy Editor can be installed on an NT Workstation/Server, it will not
        work with NT policies because the registry key that are set by the policy templates. 
        However, the files from the NT Server will run happily enough on an NTws.       
-       You need <filename>poledit.exe, common.adm</> and <filename>winnt.adm</>. It is convenient
-       to put the two *.adm files in <filename>c:\winnt\inf</> which is where
+       You need <filename>poledit.exe, common.adm</filename> and <filename>winnt.adm</filename>. It is convenient
+       to put the two *.adm files in <filename>c:\winnt\inf</filename> which is where
        the binary will look for them unless told otherwise. Note also that that 
        directory is 'hidden'.
        </para>
@@ -928,7 +928,7 @@ general SMB topics such as browsing.</para>
  
        <listitem><para>See how Scott Merrill simulates a BDC behavior at 
         <ulink url="http://www.skippy.net/linux/smb-howto.html">
-        http://www.skippy.net/linux/smb-howto.html</>. </para></listitem>
+        http://www.skippy.net/linux/smb-howto.html</ulink>. </para></listitem>
 
        <listitem><para>Although 2.0.7 has almost had its day as a PDC, David Bannon will
         keep the 2.0.7 PDC pages at <ulink url="http://bioserve.latrobe.edu.au/samba">
@@ -958,8 +958,8 @@ general SMB topics such as browsing.</para>
        <para>
        There are a number of Samba related mailing lists. Go to <ulink 
        url="http://samba.org">http://samba.org</ulink>, click on your nearest mirror
-       and then click on <command>Support</> and then click on <command>
-       Samba related mailing lists</>.
+       and then click on <command>Support</command> and then click on <command>
+       Samba related mailing lists</command>.
        </para>
 
        <para>
@@ -1028,8 +1028,8 @@ general SMB topics such as browsing.</para>
        <para>To have your name removed from a samba mailing list, go to the
        same place you went to to get on it. Go to <ulink 
        url="http://lists.samba.org/">http://lists.samba.org</ulink>, 
-       click on your nearest mirror and then click on <command>Support</> and 
-       then click on <command> Samba related mailing lists</>. Or perhaps see 
+       click on your nearest mirror and then click on <command>Support</command> and 
+       then click on <command> Samba related mailing lists</command>. Or perhaps see 
        <ulink url="http://lists.samba.org/mailman/roster/samba-ntdom">here</ulink>
        </para>
 
@@ -1112,7 +1112,7 @@ worthwhile lookingat how a Windows 9x/ME client performs a logon:
 <listitem>
        <para>
        The client broadcasts (to the IP broadcast address of the subnet it is in)
-       a NetLogon request. This is sent to the NetBIOS name DOMAIN<1c> at the
+       a NetLogon request. This is sent to the NetBIOS name DOMAIN&lt;1c&gt; at the
        NetBIOS layer.  The client chooses the first response it receives, which
        contains the NetBIOS name of the logon server to use in the format of 
        \\SERVER.
@@ -1704,7 +1704,7 @@ contrast to w95, where it _does_ transfer / update profiles correctly].
 
 <sect1>
 <title>
-DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba
+DOMAIN_CONTROL.txt : Windows NT Domain Control &amp; Samba
 </title>
 
 <warning>
index 6e1609460fc6f6c56cbaef11a54731bd8f888c63..a86cd74235c4dcd96998e4fb1c4eeb5d6f44c6b0 100644 (file)
@@ -4,7 +4,7 @@
        <author>
                <firstname>Shirish</firstname><surname>Kalele</surname>
                <affiliation>
-                       <orgname>Samba Team & Veritas Software</orgname>
+                       <orgname>Samba Team &amp; Veritas Software</orgname>
                        <address>
                                <email>samba@samba.org</email>
                        </address>
index 7bca8dc6f57b1e2fa3974a6678cc5eb10f0fd99f..8d15e437b27fc4501621856705f7f757b2112671 100644 (file)
@@ -409,8 +409,8 @@ echo "  :sd=/var/spool/lpd/$2:\\"                   >> $PRINTCAP
 echo "  :mx=0:ml=0:sh:\\"                              >> $PRINTCAP
 echo "  :lp=/usr/local/samba/var/print/$5.prn:"        >> $PRINTCAP
 
-touch "/usr/local/samba/var/print/$5.prn" >> /tmp/printadd.$$ 2>&1
-chown $LP "/usr/local/samba/var/print/$5.prn" >> /tmp/printadd.$$ 2>&1
+touch "/usr/local/samba/var/print/$5.prn" >> /tmp/printadd.$$ 2>&amp;1
+chown $LP "/usr/local/samba/var/print/$5.prn" >> /tmp/printadd.$$ 2>&amp;1
 
 mkdir /var/spool/lpd/$2
 chmod 700 /var/spool/lpd/$2
@@ -757,7 +757,7 @@ be:
     /usr/bin/id -p >/tmp/tmp.print
     # we run the command and save the error messages
     # replace the command with the one appropriate for your system
-    /usr/bin/lpr -r -P$1 $2 2>>&/tmp/tmp.print
+    /usr/bin/lpr -r -P$1 $2 2>>&amp;/tmp/tmp.print
 </programlisting></para>
 
 <para>
index d2bfb8ab679c1855c69991a633afbca17d74a165..b144c5e06b894cc95bc9e3219586665c6fca3257 100644 (file)
@@ -2,6 +2,7 @@
 
 
 <chapterinfo>
+       <authorgroup>
        <author>
                <firstname>Tim</firstname><surname>Potter</surname>
                <affiliation>
@@ -10,7 +11,7 @@
                </affiliation>
        </author>
        <author>
-               <firstname>Andrew</firstname><surname>Trigdell</surname>
+               <firstname>Andrew</firstname><surname>Tridgell</surname>
                <affiliation>
                        <orgname>Samba Team</orgname>
                        <address><email>tridge@linuxcare.com.au</email></address>
@@ -35,6 +36,7 @@
                        <address><email>jelmer@nl.linux.org</email></address>
                </affiliation>
        </author>
+       </authorgroup>
        <pubdate>27 June 2002</pubdate>
 </chapterinfo>
 
@@ -552,7 +554,7 @@ include the following entries in the [global] section:
 
 <para><programlisting>
 [global]
-     <...>
+     &lt;...&gt;
      # separate domain and username with '+', like DOMAIN+username
      <ulink url="winbindd.8.html#WINBINDSEPARATOR">winbind separator</ulink> = +
      # use uids from 10000 to 20000 for domain users
@@ -733,7 +735,7 @@ start() {
         daemon /usr/local/samba/bin/winbindd
         RETVAL3=$?
         echo
-        [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && touch /var/lock/subsys/smb || \
+        [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] &amp;&amp; touch /var/lock/subsys/smb || \
            RETVAL=1
         return $RETVAL
 }
@@ -760,7 +762,7 @@ stop() {
         echo -n $"Shutting down $KIND services: "
         killproc winbindd
         RETVAL3=$?
-        [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && rm -f /var/lock/subsys/smb
+        [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] &amp;&amp; rm -f /var/lock/subsys/smb
         echo ""
         return $RETVAL
 }
@@ -791,7 +793,7 @@ killproc() {            # kill the named process(es)
         pid=`/usr/bin/ps -e |
              /usr/bin/grep -w $1 |
              /usr/bin/sed -e 's/^  *//' -e 's/ .*//'`
-        [ "$pid" != "" ] && kill $pid
+        [ "$pid" != "" ] &amp;&amp; kill $pid
 }
  
 # Start/stop processes required for samba server
@@ -1042,7 +1044,7 @@ annoying double prompts for passwords.
 </para>
 
 <para>
-Now restart your Samba & try connecting through your application that you
+Now restart your Samba and try connecting through your application that you
 configured in the pam.conf.
 </para>