Initial import
[samba] / debian / patches / documentation.patch
1 Index: samba-3.0.21c/docs/manpages/swat.8
2 ===================================================================
3 --- samba-3.0.21c.orig/docs/manpages/swat.8     2006-02-25 11:57:11.752327087 +0100
4 +++ samba-3.0.21c/docs/manpages/swat.8  2006-02-25 11:58:14.717622783 +0100
5 @@ -81,51 +81,6 @@
6  \-h|\-\-help
7  Print a summary of command line options\&.
8  
9 -.SH "INSTALLATION"
10 -
11 -.PP
12 -Swat is included as binary package with most distributions\&. The package manager in this case takes care of the installation and configuration\&. This section is only for those who have compiled swat from scratch\&.
13 -
14 -.PP
15 -After you compile SWAT you need to run \fBmake install \fR to install the \fBswat\fR binary and the various help files and images\&. A default install would put these in:
16 -
17 -.TP 3
18 -\(bu
19 -/usr/local/samba/sbin/swat
20 -.TP
21 -\(bu
22 -/usr/local/samba/swat/images/*
23 -.TP
24 -\(bu
25 -/usr/local/samba/swat/help/*
26 -.LP
27 -
28 -.SS "Inetd Installation"
29 -
30 -.PP
31 -You need to edit your \fI/etc/inetd\&.conf \fR and \fI/etc/services\fR to enable SWAT to be launched via \fBinetd\fR\&.
32 -
33 -.PP
34 -In \fI/etc/services\fR you need to add a line like this:
35 -
36 -.PP
37 -\fBswat 901/tcp\fR
38 -
39 -.PP
40 -Note for NIS/YP and LDAP users \- you may need to rebuild the NIS service maps rather than alter your local \fI /etc/services\fR file\&.
41 -
42 -.PP
43 -the choice of port number isn't really important except that it should be less than 1024 and not currently used (using a number above 1024 presents an obscure security hole depending on the implementation details of your\fBinetd\fR daemon)\&.
44 -
45 -.PP
46 -In \fI/etc/inetd\&.conf\fR you should add a line like this:
47 -
48 -.PP
49 -\fBswat stream tcp nowait\&.400 root /usr/local/samba/sbin/swat swat\fR
50 -
51 -.PP
52 -Once you have edited \fI/etc/services\fR and \fI/etc/inetd\&.conf\fR you need to send a HUP signal to inetd\&. To do this use \fBkill \-1 PID \fR where PID is the process ID of the inetd daemon\&.
53 -
54  .SH "LAUNCHING"
55  
56  .PP
57 @@ -145,8 +100,8 @@
58  This file must contain a mapping of service name (e\&.g\&., swat) to service port (e\&.g\&., 901) and protocol type (e\&.g\&., tcp)\&.
59  
60  .TP
61 -\fI/usr/local/samba/lib/smb\&.conf\fR
62 -This is the default location of the \fBsmb\&.conf\fR(5) server configuration file that swat edits\&. Other common places that systems install this file are \fI /usr/samba/lib/smb\&.conf\fR and \fI/etc/smb\&.conf \fR\&. This file describes all the services the server is to make available to clients\&.
63 +\fI/etc/samba/smb\&.conf\fR
64 +This is the default location of the \fBsmb\&.conf\fR(5) server configuration file that swat edits\&. This file describes all the services the server is to make available to clients\&.
65  
66  .SH "WARNINGS"
67  
68 Index: samba-3.0.21c/docs/manpages/nmbd.8
69 ===================================================================
70 --- samba-3.0.21c.orig/docs/manpages/nmbd.8     2006-02-25 11:57:11.753326885 +0100
71 +++ samba-3.0.21c/docs/manpages/nmbd.8  2006-02-25 11:58:14.719622379 +0100
72 @@ -74,7 +74,7 @@
73  \-H <filename>
74  NetBIOS lmhosts file\&. The lmhosts file is a list of NetBIOS names to IP addresses that is loaded by the nmbd server and used via the name resolution mechanism name resolve order described in \fBsmb\&.conf\fR(5) to resolve any NetBIOS name queries needed by the server\&. Note that the contents of this file are \fBNOT\fR used by \fBnmbd\fR to answer any name queries\&. Adding a line to this file affects name NetBIOS resolution from this host \fBONLY\fR\&.
75  
76 -The default path to this file is compiled into Samba as part of the build process\&. Common defaults are \fI/usr/local/samba/lib/lmhosts\fR,\fI/usr/samba/lib/lmhosts\fR or\fI/etc/samba/lmhosts\fR\&. See the \fBlmhosts\fR(5) man page for details on the contents of this file\&.
77 +The default path to this file is \fI/etc/samba/lmhosts\fR\&. See the \fBlmhosts\fR(5) man page for details on the contents of this file\&.
78  
79  .TP
80  \-V
81 @@ -119,8 +119,8 @@
82  If running the server via the meta\-daemon \fBinetd\fR, this file must contain a mapping of service name (e\&.g\&., netbios\-ssn) to service port (e\&.g\&., 139) and protocol type (e\&.g\&., tcp)\&.
83  
84  .TP
85 -\fI/usr/local/samba/lib/smb\&.conf\fR
86 -This is the default location of the \fBsmb\&.conf\fR(5) server configuration file\&. Other common places that systems install this file are \fI/usr/samba/lib/smb\&.conf\fR and \fI/etc/samba/smb\&.conf\fR\&.
87 +\fI/etc/samba/smb\&.conf\fR
88 +This is the default location of the \fBsmb\&.conf\fR(5) server configuration file\&.
89  
90  When run as a WINS server (see thewins support parameter in the \fBsmb\&.conf\fR(5) man page),\fBnmbd\fR will store the WINS database in the file \fIwins\&.dat\fR in the \fIvar/locks\fR directory configured under wherever Samba was configured to install itself\&.
91  
92 @@ -132,7 +132,7 @@
93  To shut down an \fBnmbd\fR process it is recommended that SIGKILL (\-9) \fBNOT\fR be used, except as a last resort, as this may leave the name database in an inconsistent state\&. The correct way to terminate \fBnmbd\fR is to send it a SIGTERM (\-15) signal and wait for it to die on its own\&.
94  
95  .PP
96 -\fBnmbd\fR will accept SIGHUP, which will cause it to dump out its namelists into the file \fInamelist\&.debug \fR in the \fI/usr/local/samba/var/locks\fR directory (or the \fIvar/locks\fR directory configured under wherever Samba was configured to install itself)\&. This will also cause \fBnmbd\fR to dump out its server database in the \fIlog\&.nmb\fR file\&.
97 +\fBnmbd\fR will accept SIGHUP, which will cause it to dump out its namelists into the file \fInamelist\&.debug \fR in the \fI/var/run/samba\fR directory (or the \fIvar/locks\fR directory configured under wherever Samba was configured to install itself)\&. This will also cause \fBnmbd\fR to dump out its server database in the \fIlog\&.nmb\fR file\&.
98  
99  .PP
100  The debug log level of nmbd may be raised or lowered using \fBsmbcontrol\fR(1) (SIGUSR[1|2] signals are no longer used since Samba 2\&.2)\&. This is to allow transient problems to be diagnosed, whilst still running at a normally low log level\&.
101 Index: samba-3.0.21c/docs/manpages/smbd.8
102 ===================================================================
103 --- samba-3.0.21c.orig/docs/manpages/smbd.8     2006-02-25 11:57:11.754326683 +0100
104 +++ samba-3.0.21c/docs/manpages/smbd.8  2006-02-25 11:58:14.721621976 +0100
105 @@ -119,8 +119,8 @@
106  If running the server via the meta\-daemon \fBinetd\fR, this file must contain a mapping of service name (e\&.g\&., netbios\-ssn) to service port (e\&.g\&., 139) and protocol type (e\&.g\&., tcp)\&.
107  
108  .TP
109 -\fI/usr/local/samba/lib/smb\&.conf\fR
110 -This is the default location of the \fBsmb\&.conf\fR(5) server configuration file\&. Other common places that systems install this file are \fI/usr/samba/lib/smb\&.conf\fR and \fI/etc/samba/smb\&.conf\fR\&.
111 +\fI/etc/samba/smb\&.conf\fR
112 +This is the default location of the \fBsmb\&.conf\fR(5) server configuration file\&.
113  
114  This file describes all the services the server is to make available to clients\&. See \fBsmb\&.conf\fR(5) for more information\&.
115  
116 Index: samba-3.0.21c/docs/manpages/lmhosts.5
117 ===================================================================
118 --- samba-3.0.21c.orig/docs/manpages/lmhosts.5  2006-02-25 11:57:11.755326481 +0100
119 +++ samba-3.0.21c/docs/manpages/lmhosts.5       2006-02-25 11:58:14.722621774 +0100
120 @@ -73,7 +73,7 @@
121  .SH "FILES"
122  
123  .PP
124 -lmhosts is loaded from the configuration directory\&. This is usually \fI/etc/samba\fR or \fI/usr/local/samba/lib\fR\&.
125 +lmhosts is loaded from the configuration directory\&. This is \fI/etc/samba\fR\&.
126  
127  .SH "VERSION"
128  
129 Index: samba-3.0.21c/docs/manpages/ntlm_auth.1
130 ===================================================================
131 --- samba-3.0.21c.orig/docs/manpages/ntlm_auth.1        2006-02-25 11:57:11.756326280 +0100
132 +++ samba-3.0.21c/docs/manpages/ntlm_auth.1     2006-02-25 11:58:14.723621572 +0100
133 @@ -42,7 +42,7 @@
134  The \fBwinbindd\fR(8) daemon must be operational for many of these commands to function\&.
135  
136  .PP
137 -Some of these commands also require access to the directory \fIwinbindd_privileged\fR in \fI$LOCKDIR\fR\&. This should be done either by running this command as root or providing group access to the \fIwinbindd_privileged\fR directory\&. For security reasons, this directory should not be world\-accessable\&.
138 +Some of these commands also require access to the directory \fIwinbindd_privileged\fR in \fI/var/run/samba\fR\&. This should be done either by running this command as root or providing group access to the \fIwinbindd_privileged\fR directory\&. For security reasons, this directory should not be world\-accessable\&.
139  
140  .SH "OPTIONS"
141  
142 @@ -64,7 +64,7 @@
143  squid\-2\&.5\-ntlmssp
144  Server\-side helper for use with Squid 2\&.5's NTLMSSP authentication\&.
145  
146 -Requires access to the directory \fIwinbindd_privileged\fR in\fI$LOCKDIR\fR\&. The protocol used is described here: http://devel\&.squid\-cache\&.org/ntlm/squid_helper_protocol\&.html\&. This protocol has been extended to allow the NTLMSSP Negotiate packet to be included as an argument to the \fBYR\fR command\&. (Thus avoiding loss of information in the protocol exchange)\&.
147 +Requires access to the directory \fIwinbindd_privileged\fR in \fI/var/run/samba\fR\&. The protocol used is described here: http://devel\&.squid\-cache\&.org/ntlm/squid_helper_protocol\&.html\&. This protocol has been extended to allow the NTLMSSP Negotiate packet to be included as an argument to the \fBYR\fR command\&. (Thus avoiding loss of information in the protocol exchange)\&.
148  
149  .TP
150  ntlmssp\-client\-1
151 @@ -76,7 +76,7 @@
152  gss\-spnego
153  Server\-side helper that implements GSS\-SPNEGO\&. This uses a protocol that is almost the same as\fBsquid\-2\&.5\-ntlmssp\fR, but has some subtle differences that are undocumented outside the source at this stage\&.
154  
155 -Requires access to the directory \fIwinbindd_privileged\fR in\fI$LOCKDIR\fR\&.
156 +Requires access to the directory \fIwinbindd_privileged\fR in \fI/var/run/samba\fR\&.
157  
158  .TP
159  gss\-spnego\-client
160 Index: samba-3.0.21c/docs/manpages/tdbbackup.8
161 ===================================================================
162 --- samba-3.0.21c.orig/docs/manpages/tdbbackup.8        2006-02-25 11:57:11.757326078 +0100
163 +++ samba-3.0.21c/docs/manpages/tdbbackup.8     2006-02-25 11:58:14.724621371 +0100
164 @@ -72,13 +72,13 @@
165  
166  .TP 3
167  \(bu
168 -\fBsecrets\&.tdb\fR \- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&.
169 +\fBsecrets\&.tdb\fR \- in the /var/lib/samba directory\&.
170  .TP
171  \(bu
172 -\fBpassdb\&.tdb\fR \- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&.
173 +\fBpassdb\&.tdb\fR \- in the /var/lib/samba directory\&.
174  .TP
175  \(bu
176 -\fB*\&.tdb\fR located in the /usr/local/samba/var directory or on some systems in the /var/cache or /var/lib/samba directories\&.
177 +\fB*\&.tdb\fR located in the /var/lib/samba and /var/run/samba directories\&.
178  .LP
179  
180  .SH "VERSION"
181 Index: samba-3.0.21c/docs/manpages/winbindd.8
182 ===================================================================
183 --- samba-3.0.21c.orig/docs/manpages/winbindd.8 2006-02-25 11:57:11.758325876 +0100
184 +++ samba-3.0.21c/docs/manpages/winbindd.8      2006-02-25 11:58:14.726620967 +0100
185 @@ -298,19 +298,19 @@
186  The UNIX pipe over which clients communicate with the \fBwinbindd\fR program\&. For security reasons, the winbind client will only attempt to connect to the winbindd daemon if both the \fI/tmp/\&.winbindd\fR directory and \fI/tmp/\&.winbindd/pipe\fR file are owned by root\&.
187  
188  .TP
189 -$LOCKDIR/winbindd_privileged/pipe
190 -The UNIX pipe over which 'privileged' clients communicate with the \fBwinbindd\fR program\&. For security reasons, access to some winbindd functions \- like those needed by the \fBntlm_auth\fR utility \- is restricted\&. By default, only users in the 'root' group will get this access, however the administrator may change the group permissions on $LOCKDIR/winbindd_privileged to allow programs like 'squid' to use ntlm_auth\&. Note that the winbind client will only attempt to connect to the winbindd daemon if both the \fI$LOCKDIR/winbindd_privileged\fR directory and \fI$LOCKDIR/winbindd_privileged/pipe\fR file are owned by root\&.
191 +/var/run/samba/winbindd_privileged/pipe
192 +The UNIX pipe over which 'privileged' clients communicate with the \fBwinbindd\fR program\&. For security reasons, access to some winbindd functions \- like those needed by the \fBntlm_auth\fR utility \- is restricted\&. By default, only users in the 'root' group will get this access, however the administrator may change the group permissions on /var/run/samba/winbindd_privileged to allow programs like 'squid' to use ntlm_auth\&. Note that the winbind client will only attempt to connect to the winbindd daemon if both the \fI/var/run/samba/winbindd_privileged\fR directory and \fI/var/run/samba/winbindd_privileged/pipe\fR file are owned by root\&.
193  
194  .TP
195  /lib/libnss_winbind\&.so\&.X
196  Implementation of name service switch library\&.
197  
198  .TP
199 -$LOCKDIR/winbindd_idmap\&.tdb
200 -Storage for the Windows NT rid to UNIX user/group id mapping\&. The lock directory is specified when Samba is initially compiled using the \fI\-\-with\-lockdir\fR option\&. This directory is by default \fI/usr/local/samba/var/locks \fR\&.
201 +/var/run/samba/winbindd_idmap\&.tdb
202 +Storage for the Windows NT rid to UNIX user/group id mapping\&.
203  
204  .TP
205 -$LOCKDIR/winbindd_cache\&.tdb
206 +/var/run/samba/winbindd_cache\&.tdb
207  Storage for cached user and group information\&.
208  
209  .SH "VERSION"