summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSamba Release Account <samba-bugs@samba.org>1997-01-08 22:49:59 +0000
committerSamba Release Account <samba-bugs@samba.org>1997-01-08 22:49:59 +0000
commitf743ffb347e905dedae7be9aad9698b02ee682bf (patch)
treeb2ecff1c3f307bdc672821398c3b4087e7809ccc /docs
parent68f96d46630d8860530952533f95b78fc3bcb227 (diff)
downloadsamba-f743ffb347e905dedae7be9aad9698b02ee682bf.tar.gz
samba-f743ffb347e905dedae7be9aad9698b02ee682bf.tar.bz2
samba-f743ffb347e905dedae7be9aad9698b02ee682bf.zip
Added patches from Paul Eggert.
(This used to be commit 89526ed50cf6236211723170403899f0efd2d7ae)
Diffstat (limited to 'docs')
-rw-r--r--docs/manpages/smb.conf.559
-rw-r--r--docs/manpages/smbclient.125
-rw-r--r--docs/manpages/smbd.85
-rw-r--r--docs/manpages/smbtar.12
4 files changed, 45 insertions, 46 deletions
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5
index f56ff8ce2c..7f4cb9cda7 100644
--- a/docs/manpages/smb.conf.5
+++ b/docs/manpages/smb.conf.5
@@ -593,7 +593,7 @@ write list
.SS admin users (G)
-This is a list of users who will be granted administrative privilages
+This is a list of users who will be granted administrative privileges
on the share. This means that they will do all file operations as the
super-user (root).
@@ -1107,7 +1107,7 @@ See also "valid users"
.SS include (G)
-This allows you to include one config file inside another. the file is
+This allows you to include one config file inside another. The file is
included literally, as though typed in place.
It takes the standard substitutions, except %u, %P and %S
@@ -1351,7 +1351,7 @@ Magic scripts are EXPERIMENTAL and should NOT be relied upon.
.SS mangled map (S)
This is for those who want to directly map UNIX file names which are
not representable on DOS. The mangling of names is not always what is
-needed. In particular you may have documents with file extensiosn
+needed. In particular you may have documents with file extensions
that differ between DOS and UNIX. For example, under UNIX it is common
to use .html for HTML files, whereas under DOS .htm is more commonly
used.
@@ -1389,7 +1389,7 @@ the filename are preserved, forced to upper case, and appear as the first (up
to) five characters of the mangled name.
- a tilde ("~") is appended to the first part of the mangled name, followed
-by a two-character unique sequence, based on the origonal root name
+by a two-character unique sequence, based on the original root name
(i.e., the original filename minus its final extension). The final
extension is included in the hash calculation only if it contains any upper
case characters or is longer than three characters.
@@ -1576,7 +1576,7 @@ of the user.
Oplocks are the way that SMB clients get permission from a server to
locally cache file operations. If a server grants an oplock
(opportunistic lock) then the client is free to assume that it is the
-only one accessing the file and it will agressively cache file
+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.
@@ -1584,7 +1584,7 @@ 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 agressively cache the file
+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
@@ -1700,8 +1700,8 @@ This chat sequence is often quite site specific, depending on what
local methods are used for password control (such as NIS+ etc).
The string can contain the macros %o and %n which are substituted for
-the old and new passwords respectively. It can aso contain the
-standard macros \\n \\r \\t and \\s to give line-feed, carriage-return,
+the old and new passwords respectively. It can also contain the
+standard macros \en \er \et and \es to give line-feed, carriage-return,
tab and space.
The string can also contain a * which matches any sequence of
@@ -1715,17 +1715,18 @@ then no string is sent. Similarly, is the expect string is a fullstop
then no string is expected.
.B Example:
- passwd chat = "*Enter OLD password*" %o\\n "*Enter NEW password*" %n\\n \\
- "*Reenter NEW password*" %n\\n "*Password changed*"
+ passwd chat = "*Enter OLD password*" %o\en "*Enter NEW password*" %n\en \e
+ "*Reenter NEW password*" %n\en "*Password changed*"
+
.B Default:
- passwd chat = *old*password* %o\\n *new*password* %n\\n *new*password* %n\\n *changed*
+ passwd chat = *old*password* %o\en *new*password* %n\en *new*password* %n\en *changed*
.SS passwd program (G)
The name of a program that can be used to set user passwords.
This is only necessary if you have enabled remote password changing at
-compile time. Any occurances of %u will be replaced with the user
+compile time. Any occurrences of %u will be replaced with the user
name.
Also note that many passwd programs insist in "reasonable" passwords,
@@ -1740,7 +1741,7 @@ Workgroups) uppercase the password before sending it.
passwd program = /sbin/passwd %u
.SS password level (G)
-Some client/server conbinations have difficulty with mixed-case passwords.
+Some client/server combinations have difficulty with mixed-case passwords.
One offending client is Windows for Workgroups, which for some reason forces
passwords to upper case when using the LANMAN1 protocol, but leaves them alone
when using COREPLUS!
@@ -1822,8 +1823,8 @@ and the path should be world-writable and have the sticky bit set. This is not
mandatory of course, but you probably won't get the results you expect if you
do otherwise.
-Any occurances of %u in the path will be replaced with the username
-that the client is connecting as. Any occurances of %m will be
+Any occurrences of %u in the path will be replaced with the username
+that the client is connecting as. Any occurrences of %m will be
replaced by the name of the machine they are connecting from. These
replacements are very useful for setting up pseudo home directories
for users.
@@ -1851,7 +1852,7 @@ See also preexec
none (no command executed)
.B Example:
- postexec = echo \"%u disconnected from %S from %m (%I)\" >> /tmp/log
+ postexec = echo \e"%u disconnected from %S from %m (%I)\e" >> /tmp/log
.SS postscript (S)
This parameter forces a printer to interpret the print files as
@@ -1875,7 +1876,7 @@ connected to. It takes the usual substitutions.
An interesting example is to send the users a welcome message every
time they log in. Maybe a message of the day? Here is an example:
-preexec = csh -c 'echo \"Welcome to %S!\" | \
+preexec = csh -c 'echo \e"Welcome to %S!\e" | \e
/usr/local/samba/bin/smbclient -M %m -I %I' &
Of course, this could get annoying after a while :-)
@@ -1886,7 +1887,7 @@ See also postexec
none (no command executed)
.B Example:
- preexec = echo \"%u connected to %S from %m (%I)\" >> /tmp/log
+ preexec = echo \e"%u connected to %S from %m (%I)\e" >> /tmp/log
.SS preferred master (G)
This boolean parameter controls if Samba is a preferred master browser
@@ -1927,7 +1928,7 @@ below.
The full path name will be used for the filename if %s is not preceded
by a /. If you don't like this (it can stuff up some lpq output) then
-use %f instead. Any occurances of %f get replaced by the spool
+use %f instead. Any occurrences of %f get replaced by the spool
filename without the full path at the front.
The print command MUST contain at least one occurrence of "%s" or %f -
@@ -2173,7 +2174,7 @@ This option allows you to setup nmbd to periodically announce itself
to arbitrary IP addresses with an arbitrary workgroup name.
This is useful if you want your Samba server to appear in a remote
-workgroup for which the normal browse propogation rules don't
+workgroup for which the normal browse propagation rules don't
work. The remote workgroup can be anywhere that you can send IP
packets to.
@@ -2196,7 +2197,7 @@ This option replaces similar functionality from the nmbd lmhosts file.
This options controls whether Samba will allow a previously validated
username/password pair to be used to attach to a share. Thus if you
-connect to \\\\server\\share1 then to \\\\server\\share2 it won't
+connect to \e\eserver\eshare1 then to \e\eserver\eshare2 it won't
automatically allow the client to request connection to the second
share as the same username as the first without a password.
@@ -2328,7 +2329,7 @@ a connection is closed.
If 'set directory = no', then users of the service may not use the setdir
command to change directory.
-The setdir comand is only implemented in the Digital Pathworks client. See the
+The setdir command is only implemented in the Digital Pathworks client. See the
Pathworks documentation for details.
.B Default:
@@ -2350,7 +2351,7 @@ directory" specified in smb.conf must be readable by all users.
The share modes that are enabled by this option are DENY_DOS,
DENY_ALL, DENY_READ, DENY_WRITE, DENY_NONE and DENY_FCB.
-Enabling this option gives full share compatability but may cost a bit
+Enabling this option gives full share compatibility but may cost a bit
of processing time on the UNIX server. They are enabled by default.
.B Default:
@@ -2530,7 +2531,7 @@ supplied password will be tested against each username in turn (left to right).
The username= line is needed only when the PC is unable to supply its own
username. This is the case for the coreplus protocol or where your
users have different WfWg usernames to UNIX usernames. In both these
-cases you may also be better using the \\\\server\\share%user syntax
+cases you may also be better using the \e\eserver\eshare%user syntax
instead.
The username= line is not a great solution in many cases as it means Samba
@@ -2601,10 +2602,10 @@ would use
You can have as many mappings as you like in a username map file.
-Note that the remapping is applied to all occurances of
-usernames. Thus if you connect to "\\\\server\\fred" and "fred" is
+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
-"\\\\server\\mary" and will need to supply a password suitable for
+"\e\eserver\emary" and will need to supply a password suitable for
"mary" not "fred". The only exception to this is the username passed
to the "password server" (if you have one). The password server will
receive whatever username the client supplies without modification.
@@ -2632,7 +2633,7 @@ between them then it will be taken as an lowercase:uppercase pair.
If you have an editor capable of entering the characters into the
config file then it is probably easiest to use this method. Otherwise
-you can specify the characters in octal, decimal or hexidecimal form
+you can specify the characters in octal, decimal or hexadecimal form
using the usual C notation.
For example to add the single character 'Z' to the charset (which is a
@@ -2800,7 +2801,7 @@ If the service is marked "guest only = yes" then steps 1 to 5 are skipped
Step 1: If the client has passed a username/password pair and that
username/password pair is validated by the UNIX system's password
programs then the connection is made as that username. Note that this
-includes the \\\\server\\service%username method of passing a username.
+includes the \e\eserver\eservice%username method of passing a username.
Step 2: If the client has previously registered a username with the
system and now supplies a correct password for that username then the
diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1
index 284213d814..6ae454f2f2 100644
--- a/docs/manpages/smbclient.1
+++ b/docs/manpages/smbclient.1
@@ -72,7 +72,7 @@ the server, retrieving directory information from the server and so on.
.B servicename
is the name of the service you want to use on the server. A service
name takes the form
-.B "\\\\\\\\server\\\\service"
+.B "\e\eserver\eservice"
where
.B server
is the netbios name of the Lan Manager server offering the desired service and
@@ -81,7 +81,7 @@ is the name of the service offered. Thus to connect to the service "printer"
on the Lan Manager server "lanman", you would use the servicename
.RS 10
-.B "\\\\\\\\lanman\\\\printer"
+.B "\e\elanman\eprinter"
.RE
Note that the server name required is NOT necessarily the host name of the
@@ -384,7 +384,7 @@ or
used as:
.LP
smbclient
-.B "\\\\\\\\server\\\\share"
+.B "\e\eserver\eshare"
\-TcxIXbgNa
[
.IR blocksize
@@ -459,15 +459,15 @@ flags.
.B Examples
-smbclient \\\\mypc\\myshare "" -N -Tx backup.tar
+smbclient \e\emypc\emyshare "" -N -Tx backup.tar
Restore from tar file backup.tar into myshare on mypc (no password on share).
-smbclient \\\\mypc\\myshare "" -N -TXx backup.tar users/docs
+smbclient \e\emypc\emyshare "" -N -TXx backup.tar users/docs
Restore everything except users/docs
-smbclient \\\\mypc\\myshare "" -N -Tc backup.tar users/docs
+smbclient \e\emypc\emyshare "" -N -Tc backup.tar users/docs
Create a tar file of the files beneath users/docs.
.RE
@@ -497,8 +497,8 @@ This is particularly useful in scripts and for printing stdin to
the server, e.g. \-c 'print \-'.
.RE
.SH OPERATIONS
-Once the client is running, the user is presented with a prompt, "smb: \\>".
-The backslash ("\\") indicates the current working directory on the server,
+Once the client is running, the user is presented with a prompt, "smb: \e>".
+The backslash ("\e") indicates the current working directory on the server,
and will change if the current working directory is changed.
The prompt indicates that the client is ready and waiting to carry out a user
@@ -1000,13 +1000,12 @@ None.
Toggle directory recursion for the commands
.B mget
and
-.B mput
-.
+.BR mput .
When toggled ON, these commands will process all directories in the source
-directory (ie., the directory they are copying
-.I from
-) and will recurse into any that match the mask specified to the command. Only
+directory (i.e., the directory they are copying
+.IR from )
+and will recurse into any that match the mask specified to the command. Only
files that match the mask specified using the
.B mask
command will be retrieved. See also the
diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8
index 7dc9ee1b2f..6c26c83c0d 100644
--- a/docs/manpages/smbd.8
+++ b/docs/manpages/smbd.8
@@ -190,7 +190,6 @@ clients. See
.BR smb.conf (5)
for more information.
.RE
-.RE
.SH LIMITATIONS
On some systems
@@ -223,7 +222,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,7 +368,7 @@ 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
diff --git a/docs/manpages/smbtar.1 b/docs/manpages/smbtar.1
index 70a16afe6f..75fbac1795 100644
--- a/docs/manpages/smbtar.1
+++ b/docs/manpages/smbtar.1
@@ -137,7 +137,7 @@ flag of
.RE
.SH ENVIRONMENT VARIABLES
The TAPE variable specifies the default tape device to write to. May
-be overidden with the
+be overridden with the
.B \-t
option.
.SH BUGS