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
7 Print a summary of command line options\&.
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\&.
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:
19 -/usr/local/samba/sbin/swat
22 -/usr/local/samba/swat/images/*
25 -/usr/local/samba/swat/help/*
28 -.SS "Inetd Installation"
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\&.
34 -In \fI/etc/services\fR you need to add a line like this:
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\&.
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)\&.
46 -In \fI/etc/inetd\&.conf\fR you should add a line like this:
49 -\fBswat stream tcp nowait\&.400 root /usr/local/samba/sbin/swat swat\fR
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\&.
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)\&.
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\&.
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
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\&.
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\&.
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)\&.
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\&.
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\&.
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\&.
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\&.
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
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)\&.
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\&.
114 This file describes all the services the server is to make available to clients\&. See \fBsmb\&.conf\fR(5) for more information\&.
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
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\&.
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
134 The \fBwinbindd\fR(8) daemon must be operational for many of these commands to function\&.
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\&.
143 squid\-2\&.5\-ntlmssp
144 Server\-side helper for use with Squid 2\&.5's NTLMSSP authentication\&.
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)\&.
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\&.
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\&.
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
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\&.
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\&.
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\&.
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\&.
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\&.
195 /lib/libnss_winbind\&.so\&.X
196 Implementation of name service switch library\&.
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\&.
205 -$LOCKDIR/winbindd_cache\&.tdb
206 +/var/run/samba/winbindd_cache\&.tdb
207 Storage for cached user and group information\&.