Added fixes for become_user braindamage.
[kai/samba.git] / docs / manpages / smbd.8
index 116b24693d7759e85c3a7cf3511dbdea08dab9fe..434844822a4bcb04849912c33e02fc81aead5802 100644 (file)
@@ -27,10 +27,11 @@ smbd \- provide SMB (aka LanManager) services to clients
 This program is part of the Samba suite.
 
 .B smbd
-is a server that can provide most SMB services. The 
-server provides filespace and printer services to clients using the SMB 
-protocol. This is compatible with the LanManager protocol, and can
-service LanManager clients.
+is a server that can provide most SMB services. The server provides
+filespace and printer services to clients using the SMB protocol. This
+is compatible with the LanManager protocol, and can service LanManager
+clients.  These include MSCLIENT 3.0 for DOS, Windows for Workgroups,
+Windows 95, Windows NT, OS/2, DAVE for Macintosh, and smbfs for Linux.
 
 An extensive description of the services that the server can provide is given
 in the man page for the configuration file controlling the attributes of those
@@ -50,8 +51,11 @@ of the server for each session. This copy then services all connections made
 by the client during that session. When all connections from its client are
 are closed, the copy of the server for that client terminates.
 
-The configuration file is automatically reloaded if it changes. You
-can force a reload by sending a SIGHUP to the server.
+The configuration file, and any files that it includes, are automatically
+reloaded every minute, if they change.  You can force a reload by sending a
+SIGHUP to the server.  Reloading the configuration file will not affect
+connections to any service that is already established.  Either the user
+will have to disconnect from the service, or smbd killed and restarted.
 .SH OPTIONS
 .B \-D
 
@@ -74,7 +78,7 @@ new connection. By default, the log files will be appended to.
 .I debuglevel
 .RS 3
 
-debuglevel is an integer from 0 to 5.
+debuglevel is an integer from 0 to 10.
 
 The default value if this parameter is not specified is zero.
 
@@ -138,6 +142,10 @@ user rather than as root, most systems will require you to use a port number
 greater than 1024 - ask your system administrator for help if you are in this
 situation.
 
+In order for the server to be useful by most clients, should you configure
+it on a port other than 139, you will require port redirection services
+on port 139, details of which are outlined in rfc1002.txt section 4.3.5.
+
 This parameter is not normally specified except in the above situation.
 .RE
 
@@ -190,7 +198,6 @@ clients. See
 .BR smb.conf (5)
 for more information.
 .RE
-.RE
 .SH LIMITATIONS
 
 On some systems
@@ -223,7 +230,7 @@ setuid. On some systems it may be worthwhile to make smbd setgid to an
 empty group. This is because some systems may have a security hole where
 daemon processes that become a user can be attached to with a
 debugger. Making the smbd file setgid to an empty group may prevent
-this hole from being exploited. This secrity hole and the suggested
+this hole from being exploited. This security hole and the suggested
 fix has only been confirmed on Linux at the time this was written. It
 is possible that this hole only exists in Linux, as testing on other
 systems has thus far shown them to be immune.
@@ -369,14 +376,14 @@ meta-daemon. Some versions of inetd will reread their configuration tables if
 they receive a HUP signal.
 
 If your machine's name is "fred" and your name is "mary", you should now be
-able to connect to the service "\\\\fred\\mary".
+able to connect to the service "\e\efred\emary".
 
 To properly test and experiment with the server, we recommend using the
 smbclient program (see
 .BR smbclient (1)).
 .SH VERSION
-This man page is (mostly) correct for version 1.9.00 of the Samba suite, plus some
-of the recent patches to it. These notes will necessarily lag behind 
+This man page is (mostly) correct for version 1.9.00 of the Samba suite,
+plus some of the recent patches to it. These notes will necessarily lag behind 
 development of the software, so it is possible that your version of 
 the server has extensions or parameter semantics that differ from or are not 
 covered by this man page. Please notify these to the address below for 
@@ -389,6 +396,8 @@ rectification.
 .BR smbclient (1),
 .BR testparm (1), 
 .BR testprns (1)
+.BR rfc1001.txt
+.BR rfc1002.txt
 .SH DIAGNOSTICS
 [This section under construction]
 
@@ -412,7 +421,6 @@ The original Samba software and related utilities were created by
 Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper
 of the Source for this project.
 
-This man page was written by Karl Auer (Karl.Auer@anu.edu.au).
 
 See
 .BR smb.conf (5)