Fix samba-docs build after svn conversion and Samba3 By Example addition.
[Samba.git] / docs / howto / index.xml
blob79d7c24617f197da1240d810ed7fdbbbf984a4b5
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4 <!ENTITY % globalentities SYSTEM '../entities/global.entities'> %globalentities;
5 ]>
7 <book id="Samba-HOWTO-Collection">
8 <title>The Official Samba-3 HOWTO and Reference Guide</title>
10 <bookinfo>
11         <authorgroup>
12         <editor>&person.jelmer;</editor>
13         <editor>&person.jht;</editor>
14         <editor>&person.jerry;</editor>
15         </authorgroup>
16         <pubdate><?latex \today ?></pubdate>
18 </bookinfo>
20 <?latex \setcounter{page}{5} ?>
22 <preface>
23         <title>Attribution</title>
24         <para>
25                 &attributions;
26         </para>
27 </preface>
29 <?latex \cleardoublepage ?>
31 <preface>
32         <title>Abstract</title>
34 <para>
35 The editors wish to thank you for your decision to purchase this book.
36 The Official Samba-3 HOWTO and Reference Guide is the result of many years
37 of accumulation of information, feedback, tips, hints, and happy solutions.
38 </para>
40 <para>
41 Please note that this book is a living document, the contents of which are
42 constantly being updated. We encourage you to contribute your tips, techniques,
43 helpful hints, and your special insight into the Windows networking world to
44 help make the next generation of this book even more valuable to Samba users.
45 </para>
47 <para>
48 We have made a concerted effort to document more comprehensively than has been
49 done previously the information that may help you to better deploy Samba and to
50 gain more contented network users.
51 </para>
53 <para>
54 This book provides example configurations, it documents key aspects of Microsoft
55 Windows networking, provides in-depth insight into the important configuration of
56 Samba-3, and helps to put all of these into a useful framework.
57 </para>
59 <para>
60 The most recent electronic versions of this document can be found at
61 <ulink noescape="1" url="http://www.samba.org/">http://www.samba.org/</ulink>
62 on the <quote>Documentation</quote> page.
63 </para>
65 <para>
66 Updates, patches and corrections are most welcome. Please email your contributions
67 to any one of the following:
68 </para>
70 <para>
71 <simplelist>
72 <member><ulink noescape="1" url="mailto:jelmer@samba.org">Jelmer Vernooij (jelmer@samba.org)</ulink></member>
73 <member><ulink noescape="1" url="mailto:jht@samba.org">John H. Terpstra (jht@samba.org)</ulink></member>
74 <member><ulink noescape="1" url="mailto:jerry@samba.org">Gerald (Jerry) Carter (jerry@samba.org)</ulink></member>
75 </simplelist>
76 </para>
78 <para>
79 We wish to advise that only original and unencumbered material can be published. Please do not submit
80 content that is not your own work unless proof of consent from the copyright holder accompanies your
81 submission.
82 </para>
84 </preface>
86 <?latex \cleardoublepage ?>
88 &foreword-tridge;
90 <?latex \cleardoublepage ?>
91 <!-- Contents -->
92 <toc/>
93 <?latex \cleardoublepage ?>
95 <lot/>
97 &IntroSMB;
99 <!-- Chapters -->
100 <part id="introduction">
101 <title>General Installation</title>
102 <?latex \pagenumbering{arabic} ?>
103 <partintro>
104 <title>Preparing Samba for Configuration</title>
105 <para>This section of the Samba-HOWTO-Collection contains general info on how to install Samba 
106 and how to configure the parts of Samba you will most likely need.
107 PLEASE read this.</para>
108 </partintro>
109 &UNIX-INSTALL;
110 &FastStart;
111 </part>
113 <part id="type">
114 <title>Server Configuration Basics</title>
115 <partintro>
116 <title>First Steps in Server Configuration</title>
117 <para>
118 Samba can operate in various modes within SMB networks. This HOWTO section contains information on
119 configuring Samba to function as the type of server your network requires. Please read this
120 section carefully.
121 </para>
122 </partintro>
123 &ServerType;
124 &Samba-PDC-HOWTO;
125 &Samba-BDC-HOWTO;
126 &DOMAIN-MEMBER;
127 &StandAloneServer;
128 &ClientConfig;
129 </part>
131 <part id="optional">
132 <title>Advanced Configuration</title>
133 <partintro>
134 <title>Valuable Nuts and Bolts Information</title>
135 <para>
136 Samba has several features that you might want or might not want to use. The chapters in this part each cover specific Samba features.
137 </para>
138 </partintro>
139 &NetworkBrowsing;
140 &Passdb;
141 &GROUP-MAPPING-HOWTO;
142 &AccessControls;
143 &locking;
144 &SecuringSamba;
145 &Trusts;
146 &MS-Dfs-Setup;
147 &PRINTER-DRIVER2;
148 &CUPS;
149 &VFS;
150 &WINBIND;
151 &AdvancedNetworkAdmin;
152 &PolicyMgmt;
153 &ProfileMgmt;
154 &Samba-PAM;
155 &IntegratingWithWindows;
156 &unicode;
157 &Backup;
158 &HighAvailability;
159 </part>
161 <part id="migration">
162 <title>Migration and Updating</title>
163 &upgrading;
164 &NT4Migration;
165 &SWAT;
166 </part>
168 <part id="troubleshooting">
169 <title>Troubleshooting</title>
170 &Diagnosis;
171 &problems;
172 &BUGS;
173 </part>
175 <part id="Appendix">
176 <title>Appendixes</title>
177 &Compiling;
178 &Portability;
179 &Other-Clients;
180 &SPEED;
181 &DNS-DHCP-Configuration;
182 </part>
186 <?latex \include{gpl}?>
188 &glossary;
190 <?latex \chaptermark{Subject index} ?>
191 <index/>
193 </book>