More doco updates. Another few days and it will be cooked.
[sfrench/samba-autobuild/.git] / docs / docbook / projdoc / samba-doc.sgml
1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2 <!ENTITY UNIX-INSTALL SYSTEM "UNIX_INSTALL.sgml">
3 <!ENTITY MS-Dfs-Setup SYSTEM "msdfs_setup.sgml">
4 <!ENTITY PRINTER-DRIVER2 SYSTEM "printer_driver2.sgml">
5 <!ENTITY DOMAIN-MEMBER SYSTEM "DOMAIN_MEMBER.sgml">
6 <!ENTITY WINBIND SYSTEM "winbind.sgml">
7 <!ENTITY NT-Security SYSTEM "NT_Security.sgml">
8 <!ENTITY ServerType SYSTEM "ServerType.sgml">
9 <!ENTITY Samba-PDC-HOWTO SYSTEM "Samba-PDC-HOWTO.sgml">
10 <!ENTITY Samba-BDC-HOWTO SYSTEM "Samba-BDC-HOWTO.sgml">
11 <!ENTITY IntegratingWithWindows SYSTEM "Integrating-with-Windows.sgml">
12 <!ENTITY Samba-PAM SYSTEM "PAM-Authentication-And-Samba.sgml">
13 <!ENTITY Diagnosis SYSTEM "Diagnosis.sgml">
14 <!ENTITY BUGS SYSTEM "Bugs.sgml">
15 <!ENTITY SECURITY-LEVEL SYSTEM "security_level.sgml">
16 <!ENTITY SPEED SYSTEM "Speed.sgml">
17 <!ENTITY BROWSING SYSTEM "Browsing.sgml">
18 <!ENTITY BROWSING-Quick SYSTEM "Browsing-Quickguide.sgml">
19 <!ENTITY GROUP-MAPPING-HOWTO SYSTEM "GROUP-MAPPING-HOWTO.sgml">
20 <!ENTITY Portability SYSTEM "Portability.sgml">
21 <!ENTITY Other-Clients SYSTEM "Other-Clients.sgml">
22 <!ENTITY ADS-HOWTO SYSTEM "ADS-HOWTO.sgml">
23 <!ENTITY Passdb SYSTEM "passdb.sgml">
24 <!ENTITY VFS SYSTEM "VFS.sgml">
25 <!ENTITY SecuringSamba SYSTEM "securing-samba.sgml">
26 <!ENTITY Compiling SYSTEM "Compiling.sgml">
27 <!ENTITY unicode SYSTEM "unicode.sgml">
28 <!ENTITY CUPS SYSTEM "CUPS-printing.sgml">
29 <!ENTITY AdvancedNetworkAdmin SYSTEM "AdvancedNetworkAdmin.sgml">
30 <!ENTITY PolicyMgmt SYSTEM "PolicyMgmt.sgml">
31 <!ENTITY ProfileMgmt SYSTEM "ProfileMgmt.sgml">
32 ]>
33
34 <book id="Samba-HOWTO-Collection">
35
36 <title>SAMBA Project Documentation</title>
37
38 <bookinfo>
39         <author>
40                 <surname>SAMBA Team</surname>
41         </author>
42         <address><email>samba@samba.org</email></address>
43 </bookinfo>
44
45 <dedication>
46 <title>Abstract</title>
47
48 <para>
49 <emphasis>Last Update</emphasis> : Wed Jan 15
50 </para>
51
52 <para>
53 This book is a collection of HOWTOs added to Samba documentation over the years.
54 I try to ensure that all are current, but sometimes the is a larger job
55 than one person can maintain.  The most recent version of this document
56 can be found at <ulink url="http://www.samba.org/">http://www.samba.org/</ulink>
57 on the "Documentation" page.  Please send updates to <ulink 
58 url="mailto:jerry@samba.org">jerry@samba.org</ulink> or 
59 <ulink url="mailto:jelmer@samba.org">jelmer@samba.org</ulink>.
60 </para>
61
62 <para>
63 This documentation is distributed under the GNU General Public License (GPL) 
64 version 2.  A copy of the license is included with the Samba source
65 distribution.  A copy can be found on-line at <ulink 
66 url="http://www.fsf.org/licenses/gpl.txt">http://www.fsf.org/licenses/gpl.txt</ulink>
67 </para>
68
69 <para>
70 Cheers, jerry
71 </para>
72
73 </dedication>
74
75 <!-- Chapters -->
76 <part id="introduction">
77 <title>General installation</title>
78 <partintro>
79 <title>Introduction</title>
80 <para>This part contains general info on how to install samba 
81 and how to configure the parts of samba you will most likely need.
82 PLEASE read this.</para>
83 </partintro>
84 &UNIX-INSTALL;
85 &BROWSING-Quick;
86 &Passdb;
87 </part>
88
89 <part id="type">
90 <title>Type of installation</title>
91 <partintro>
92 <title>Introduction</title>
93 <para>
94 Samba can operate in various SMB networks. This part contains information on configuring samba 
95 for various environments.
96 </para>
97 </partintro>
98 &ServerType;
99 &SECURITY-LEVEL;
100 &Samba-PDC-HOWTO;
101 &Samba-BDC-HOWTO;
102 &ADS-HOWTO;
103 &DOMAIN-MEMBER;
104 </part>
105
106 <part id="optional">
107 <title>Advanced Configuration</title>
108 <partintro>
109 <title>Introduction</title>
110 <para>Samba has several features that you might want or might not want to use. The chapters in this 
111 part each cover one specific feature.</para>
112 </partintro>
113 &AdvancedNetworkAdmin;
114 &NT-Security;
115 &GROUP-MAPPING-HOWTO;
116 &Samba-PAM;
117 &PRINTER-DRIVER2;
118 &CUPS;
119 &WINBIND;
120 &PolicyMgmt;
121 &ProfileMgmt;
122 &IntegratingWithWindows;
123 &BROWSING;
124 &MS-Dfs-Setup;
125 &VFS;
126 &SecuringSamba;
127 &unicode;
128 </part>
129
130 <part id="Appendixes">
131 <title>Appendixes</title>
132 &SPEED;
133 &Portability;
134 &Other-Clients;
135 &Compiling;
136 &BUGS;
137 &Diagnosis;
138 </part>
139
140