summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2003-01-28 13:52:38 +0000
committerJelmer Vernooij <jelmer@samba.org>2003-01-28 13:52:38 +0000
commit218cb945032d2aee21948fe5e6e4418ba648f82d (patch)
tree56893569f8b5133b1f5bfe737b90635f7b44004e /docs
parentf2b57195e0e3f84477b40d60fd8da81f421475b3 (diff)
downloadsamba-218cb945032d2aee21948fe5e6e4418ba648f82d.tar.gz
samba-218cb945032d2aee21948fe5e6e4418ba648f82d.tar.bz2
samba-218cb945032d2aee21948fe5e6e4418ba648f82d.zip
First step in converting to XML: use strict syntax
(This used to be commit 89f9a0a0c451a627b70c8373431e691ab964c1ef)
Diffstat (limited to 'docs')
-rw-r--r--docs/docbook/projdoc/ADS-HOWTO.sgml11
-rw-r--r--docs/docbook/projdoc/Browsing-Quickguide.sgml16
-rw-r--r--docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml1
-rw-r--r--docs/docbook/projdoc/Integrating-with-Windows.sgml18
-rw-r--r--docs/docbook/projdoc/Samba-PDC-HOWTO.sgml26
-rw-r--r--docs/docbook/projdoc/msdfs_setup.sgml2
-rw-r--r--docs/docbook/projdoc/printer_driver2.sgml6
-rw-r--r--docs/docbook/projdoc/winbind.sgml14
8 files changed, 50 insertions, 44 deletions
diff --git a/docs/docbook/projdoc/ADS-HOWTO.sgml b/docs/docbook/projdoc/ADS-HOWTO.sgml
index 3e34d53c0a..abe3f24fd5 100644
--- a/docs/docbook/projdoc/ADS-HOWTO.sgml
+++ b/docs/docbook/projdoc/ADS-HOWTO.sgml
@@ -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
}
diff --git a/docs/docbook/projdoc/Browsing-Quickguide.sgml b/docs/docbook/projdoc/Browsing-Quickguide.sgml
index 8ecc795966..8e3fbce6d3 100644
--- a/docs/docbook/projdoc/Browsing-Quickguide.sgml
+++ b/docs/docbook/projdoc/Browsing-Quickguide.sgml
@@ -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
diff --git a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml
index 6d5a019fcb..06c1d3a87e 100644
--- a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml
+++ b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="iso8859-1"?>
<chapter id="groupmapping">
<chapterinfo>
<author>
diff --git a/docs/docbook/projdoc/Integrating-with-Windows.sgml b/docs/docbook/projdoc/Integrating-with-Windows.sgml
index 3b0faf81af..a4e79fd42b 100644
--- a/docs/docbook/projdoc/Integrating-with-Windows.sgml
+++ b/docs/docbook/projdoc/Integrating-with-Windows.sgml
@@ -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>
diff --git a/docs/docbook/projdoc/Samba-PDC-HOWTO.sgml b/docs/docbook/projdoc/Samba-PDC-HOWTO.sgml
index 7cf3e5735c..e6d6573924 100644
--- a/docs/docbook/projdoc/Samba-PDC-HOWTO.sgml
+++ b/docs/docbook/projdoc/Samba-PDC-HOWTO.sgml
@@ -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>
diff --git a/docs/docbook/projdoc/msdfs_setup.sgml b/docs/docbook/projdoc/msdfs_setup.sgml
index 6e1609460f..a86cd74235 100644
--- a/docs/docbook/projdoc/msdfs_setup.sgml
+++ b/docs/docbook/projdoc/msdfs_setup.sgml
@@ -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>
diff --git a/docs/docbook/projdoc/printer_driver2.sgml b/docs/docbook/projdoc/printer_driver2.sgml
index 7bca8dc6f5..8d15e437b2 100644
--- a/docs/docbook/projdoc/printer_driver2.sgml
+++ b/docs/docbook/projdoc/printer_driver2.sgml
@@ -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>
diff --git a/docs/docbook/projdoc/winbind.sgml b/docs/docbook/projdoc/winbind.sgml
index d2bfb8ab67..b144c5e06b 100644
--- a/docs/docbook/projdoc/winbind.sgml
+++ b/docs/docbook/projdoc/winbind.sgml
@@ -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>