This commit was manufactured by cvs2svn to create tagsamba-1.9.17p4

'release-1-9-17p4'.

11 files changed, 67 insertions, 104 deletions

diff --git a/docs/manpages/nmbd.8 b/docs/manpages/nmbd.8
index 148e53478c2..100cbcc5087 100644
--- a/docs/manpages/nmbd.8
+++ b/docs/manpages/nmbd.8
@@ -1,4 +1,4 @@
-.TH NMBD 8 nmbd nmbd
+.TH NMBD 8 "22 Oct 1997" "nmbd 1.9.17p4"
 .SH NAME
 nmbd \- provide netbios nameserver support to clients
 .SH SYNOPSIS
diff --git a/docs/manpages/samba.7 b/docs/manpages/samba.7
index 7e98c850d41..a15c4a0041e 100644
--- a/docs/manpages/samba.7
+++ b/docs/manpages/samba.7
@@ -1,4 +1,4 @@
-.TH SAMBA 7 Samba Samba
+.TH SAMBA 7 "22 Oct 1997" "samba 1.9.17p4"
 .SH NAME
 Samba \- a LanManager like fileserver for UNIX
 .SH SYNOPSIS
@@ -65,7 +65,7 @@ the mailing list are given in the README file that comes with Samba.
 
 If you have access to a WWW viewer (such as Netscape or Mosaic) then
 you will also find lots of useful information, including back issues
-of the Samba mailing list, at http://samba.canberra.edu.au/pub/samba/
+of the Samba mailing list, at http://samba.anu.edu.au/samba/
 .SH AUTHOR
 
 The main author of the Samba suite is Andrew Tridgell. He may be
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5
index 989a395c159..1bd5ab26cf4 100644
--- a/docs/manpages/smb.conf.5
+++ b/docs/manpages/smb.conf.5
@@ -1,4 +1,4 @@
-.TH SMB.CONF 5 smb.conf smb.conf
+.TH SMB.CONF 5 "22 Oct 1997" "smb.conf 1.9.17p4"
 .SH NAME
 smb.conf \- configuration file for smbd
 .SH SYNOPSIS
@@ -282,9 +282,9 @@ substitutions and other smb.conf options.
 
 .SS NAME MANGLING
 
-Samba supports "name mangling" so that DOS and Windows clients can use
-files that don't conform to the 8.3 format. It can also be set to adjust
-the case of 8.3 format filenames.
+Samba supports "name mangling" so that older DOS and Windows 3 clients
+can use files that don't conform to the 8.3 format. It can also be set
+to adjust the case of 8.3 format filenames.
 
 There are several options that control the way mangling is performed,
 and they are grouped here rather than listed separately. For the
@@ -477,8 +477,6 @@ time server
 
 unix realname
 
-username level
-
 username map
 
 use rhosts
@@ -522,8 +520,6 @@ default case
 
 delete readonly
 
-delete veto files
-
 deny hosts
 
 directory
@@ -534,6 +530,8 @@ directory mode
 
 dont descend
 
+dos filetimes
+
 exec
 
 fake oplocks
@@ -869,9 +867,11 @@ See also : "valid chars".
 	client code page = 437
 
 .SS comment (S)
-This is a text field that is seen when a client does a net view to
-list what shares are available. It will also be used when browsing is
-fully supported.
+This is a text field that is seen next to a share when a client does a
+net view to list what shares are available.
+
+If you want to set the string that is displayed next to the machine
+name then see the server string command.
 
 .B Default:
 	No comment string
@@ -1040,34 +1040,6 @@ override this one. Where the lists conflict, the 'allow' list takes precedence.
 
 .B Example:
   	deny hosts = 150.203.4. badhost.mynet.edu.au
-
-.SS delete veto files (S)
-
-This option is used when Samba is attempting to delete a directory
-that contains one or more vetoed directories (see the 'veto files' option).
-If this option is set to False (the default) then if a vetoed directory
-contains any non-vetoed files or directories then the directory delete 
-will fail. This is usually what you want. 
-
-If this option is set to True, then Samba will attempt
-to recursively delete any files and directories within the vetoed
-directory. This can be useful for integration with file serving
-systems such as Netatalk, which create meta-files within directories
-you might normally veto DOS/Windows users from seeing (eg. .AppleDouble)
-
-Setting 'delete veto files = True' allows these directories to be 
-transparently deleted when the parent directory is deleted (so long
-as the user has permissions to do so).
-
-.B Default:
-    delete veto files = False
-
-.B Example:
-    delete veto files = True
-
-See
-.B veto files
-
 .SS dfree command (G)
 The dfree command setting should only be used on systems where a
 problem occurs with the internal disk space calculations. This has
@@ -1216,6 +1188,22 @@ descend" entries. For example you may need "./proc" instead of just
 .B Example:
   	dont descend = /proc,/dev
 
+.SS dos filetimes (S)
+Under DOS and Windows, if a user can write to a file they can change
+the timestamp on it. Under POSIX semantics, only the owner of the file
+or root may change the timestamp. By default, Samba runs with POSIX
+semantics and refuses to change the timestamp on a file if the user
+smbd is acting on behalf of is not the file owner. Setting this option
+to True allows DOS semantics and smbd will change the file timstamp as 
+DOS requires. This is a correct implementation of a previous compile-time
+options (UTIME_WORKAROUND) which was broken and is now removed.
+
+.B Default:
+        dos filetimes = False
+
+.B Example:
+        dos filetimes = True
+
 .SS encrypt passwords (G)
 
 This boolean controls whether encrypted passwords will be negotiated
@@ -1236,12 +1224,11 @@ only one accessing the file and it will aggressively cache file
 data. With some oplock types the client may even cache file open/close
 operations. This can give enormous performance benefits.
 
-Samba does not support opportunistic locks because they are very
-difficult to do under Unix. Samba can fake them, however, by granting
-a oplock whenever a client asks for one. This is controlled using the
-smb.conf option "fake oplocks". If you set "fake oplocks = yes" then
-you are telling the client that it may aggressively cache the file
-data.
+Samba does not support opportunistic locks in this release. Samba can
+fake them, however, by granting a oplock whenever a client asks for
+one. This is controlled using the smb.conf option "fake oplocks". If
+you set "fake oplocks = yes" then you are telling the client that it
+may aggressively cache the file data.
 
 By enabling this option on all read-only shares or shares that you know
 will only be accessed from one client at a time you will see a big
@@ -1555,10 +1542,10 @@ A boolean variable that controls whether all printers in the printcap
 will be loaded for browsing by default. 
 
 .B Default:
-	load printers = yes
+	load printers = no
 
 .B Example:
-	load printers = no
+	load printers = yes
 
 .SS local master (G)
 This option allows the nmbd to become a local master browser on a
@@ -2368,6 +2355,11 @@ If you list several hosts in the "password server" option then smbd
 will try each in turn till it finds one that responds. This is useful
 in case your primary server goes down.
 
+If you are using a WindowsNT server as your password server then you
+will have to ensure that your users are able to login from the Samba 
+server, as the network logon will appear to come from there rather
+than from the users workstation.
+
 .SS path (S)
 A synonym for this parameter is 'directory'.
 
@@ -3202,26 +3194,6 @@ on how this parameter determines access to the services.
  	username = fred
  	username = fred, mary, jack, jane, @users, @pcgroup
 
-.SS username level (G)
-
-This option helps Samba to try and 'guess' at the real UNIX username,
-as many DOS clients send an all-uppercase username. By default Samba
-tries all lowercase, followed by the username with the first letter
-capitalized, and fails if the username is not found on the UNIX machine.
-
-If this parameter is set to non-zero the behaviour changes. This 
-parameter is a number that specifies the number of uppercase combinations 
-to try whilst trying to determine the UNIX user name. The higher the number
-the more combinations will be tried, but the slower the discovery
-of usernames will be. Use this parameter when you have strange
-usernames on your UNIX machine, such as 'AstrangeUser'.
-
-.B Default:
-    username level = 0
-
-.B Example:
-    username level = 5
-
 .SS username map (G)
 
 This option allows you to to specify a file containing a mapping of
@@ -3258,6 +3230,14 @@ would use
 
 You can have as many mappings as you like in a username map file.
 
+You can map Windows usernames that have spaces in them by using double
+quotes around the name. For example:
+
+	tridge = "Andrew Tridgell"
+
+would map the windows username "Andrew Tridgell" to the unix username
+tridge.
+
 Note that the remapping is applied to all occurrences of
 usernames. Thus if you connect to "\e\eserver\efred" and "fred" is
 remapped to "mary" then you will actually be connecting to
diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1
index af36e4a3763..e8c7c291e37 100644
--- a/docs/manpages/smbclient.1
+++ b/docs/manpages/smbclient.1
@@ -1,4 +1,4 @@
-.TH SMBCLIENT 1 smbclient smbclient
+.TH SMBCLIENT 1 "22 Oct 1997" "smbclient 1.9.17p4"
 .SH NAME
 smbclient \- ftp-like Lan Manager client program
 .SH SYNOPSIS
@@ -257,13 +257,6 @@ If no
 is supplied and neither environment variable exists the user name will
 be empty.
 
-If the USER environment variable containts a '%' character, everything
-after that will be treated as a password. This allows you to set the
-environment variable to be
-.B USER=username%password
-so that a password is not passed on the command line (where it may
-be seen by the ps command).
-
 If the service you are connecting to requires a password, it can be supplied
 using the
 .B \-U
diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8
index 434844822a4..8f9aeb54a91 100644
--- a/docs/manpages/smbd.8
+++ b/docs/manpages/smbd.8
@@ -1,4 +1,4 @@
-.TH SMBD 8 smbd smbd
+.TH SMBD 8 "22 Oct 1997" "smbd 1.9.17p4"
 .SH NAME
 smbd \- provide SMB (aka LanManager) services to clients
 .SH SYNOPSIS
@@ -27,11 +27,10 @@ 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.  These include MSCLIENT 3.0 for DOS, Windows for Workgroups,
-Windows 95, Windows NT, OS/2, DAVE for Macintosh, and smbfs for Linux.
+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.
 
 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
@@ -51,11 +50,8 @@ 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, 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.
+The configuration file is automatically reloaded if it changes. You
+can force a reload by sending a SIGHUP to the server.
 .SH OPTIONS
 .B \-D
 
@@ -78,7 +74,7 @@ new connection. By default, the log files will be appended to.
 .I debuglevel
 .RS 3
 
-debuglevel is an integer from 0 to 10.
+debuglevel is an integer from 0 to 5.
 
 The default value if this parameter is not specified is zero.
 
@@ -142,10 +138,6 @@ 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
 
@@ -382,8 +374,8 @@ 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 
@@ -396,8 +388,6 @@ rectification.
 .BR smbclient (1),
 .BR testparm (1), 
 .BR testprns (1)
-.BR rfc1001.txt
-.BR rfc1002.txt
 .SH DIAGNOSTICS
 [This section under construction]
 
diff --git a/docs/manpages/smbpasswd.8 b/docs/manpages/smbpasswd.8
index 176534b04f6..ff4c10a721a 100644
--- a/docs/manpages/smbpasswd.8
+++ b/docs/manpages/smbpasswd.8
@@ -1,4 +1,4 @@
-.TH SMBPASSWD 1 smbpasswd smbpasswd
+.TH SMBPASSWD 8 "22 Oct 1997" "smbpasswd 1.9.17p4"
 .SH NAME
 smbpasswd \- change a users smb password in the smbpasswd file.
 .SH SYNOPSIS
diff --git a/docs/manpages/smbrun.1 b/docs/manpages/smbrun.1
index bc265ebf7f5..194ef45457f 100644
--- a/docs/manpages/smbrun.1
+++ b/docs/manpages/smbrun.1
@@ -1,4 +1,4 @@
-.TH SMBRUN 1 smbrun smbrun
+.TH SMBRUN 1 "22 Oct 1997" "smbrun 1.9.17p4"
 .SH NAME
 smbrun \- interface program between smbd and external programs
 .SH SYNOPSIS
diff --git a/docs/manpages/smbstatus.1 b/docs/manpages/smbstatus.1
index e59f815b78b..c28f7282611 100644
--- a/docs/manpages/smbstatus.1
+++ b/docs/manpages/smbstatus.1
@@ -1,4 +1,4 @@
-.TH SMBSTATUS 1 smbstatus smbstatus
+.TH SMBSTATUS 1 "22 Oct 1997" "smbstatus 1.9.17p4"
 .SH NAME
 smbstatus \- report on current Samba connections
 .SH SYNOPSIS
diff --git a/docs/manpages/smbtar.1 b/docs/manpages/smbtar.1
index a03b8a6a668..b21af230962 100644
--- a/docs/manpages/smbtar.1
+++ b/docs/manpages/smbtar.1
@@ -1,4 +1,4 @@
-.TH SMBTAR 1 smbtar smbtar
+.TH SMBTAR 1 "22 Oct 1997" "smbtar 1.9.17p4"
 .SH NAME
 smbtar \- shell script for backing up SMB shares directly to UNIX tape drive
 .SH SYNOPSIS
diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1
index 0b6e6e84c0b..812d417ead8 100644
--- a/docs/manpages/testparm.1
+++ b/docs/manpages/testparm.1
@@ -1,4 +1,4 @@
-.TH TESTPARM 1 testparm testparm
+.TH TESTPARM 1 "22 Oct 1997" "testparm 1.9.17p4"
 .SH NAME
 testparm \- check an smbd configuration file for internal correctness
 .SH SYNOPSIS
diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1
index 9819a679d84..bc0744d14c7 100644
--- a/docs/manpages/testprns.1
+++ b/docs/manpages/testprns.1
@@ -1,4 +1,4 @@
-.TH TESTPRNS 1 testprns testprns
+.TH TESTPRNS 1 "22 Oct 1997" "testprns 1.9.17p4"
 .SH NAME
 testprns \- check printer name for validity with smbd
 .SH SYNOPSIS