diff options
Diffstat (limited to 'docs/manpages')
| -rw-r--r-- | docs/manpages/smb.conf.5 | 81 | ||||
| -rw-r--r-- | docs/manpages/smbclient.1 | 7 | ||||
| -rw-r--r-- | docs/manpages/smbd.8 | 28 |
3 files changed, 24 insertions, 92 deletions
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index 989a395c159..b5fe0fd1a00 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -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 @@ -869,9 +865,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 +1038,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 @@ -1236,12 +1206,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 +1524,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 @@ -3202,26 +3171,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 diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1 index af36e4a3763..6ae454f2f24 100644 --- a/docs/manpages/smbclient.1 +++ b/docs/manpages/smbclient.1 @@ -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..6c26c83c0d1 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -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] |