1
0
mirror of https://github.com/samba-team/samba.git synced 2025-08-03 04:22:09 +03:00

first pass at updating head branch to be to be the same as the SAMBA_2_0 branch

(This used to be commit 453a822a76)
This commit is contained in:
Andrew Tridgell
1999-12-13 13:27:58 +00:00
parent f6276724ba
commit 3db52feb1f
322 changed files with 41942 additions and 48523 deletions

View File

@ -6,7 +6,7 @@ naming services to clients
.PP
.SH "SYNOPSIS"
.PP
\fBnmbd\fP [-D] [-o] [-a] [-H lmhosts file] [-d debuglevel] [-l log file basename] [-n primary NetBIOS name] [-p port number] [-s configuration file] [-i NetBIOS scope] [-h]
\fBnmbd\fP [-D] [-a] [-o] [-h] [-V] [-H lmhosts file] [-d debuglevel] [-l log file basename] [-n primary NetBIOS name] [-p port number] [-s configuration file] [-i NetBIOS scope]
.PP
.SH "DESCRIPTION"
.PP
@ -59,6 +59,12 @@ If this parameter is specified, the log files will be
overwritten when opened\&. By default, the log files will be appended
to\&.
.IP
.IP "\fB-h\fP"
Prints the help information (usage) for \fBnmbd\fP\&.
.IP
.IP "\fB-V\fP"
Prints the version number for \fBnmbd\fP\&.
.IP
.IP "\fB-H filename\fP"
NetBIOS lmhosts file\&.
.IP
@ -138,9 +144,6 @@ are \fIvery\fP rarely used, only set this parameter if you are the
system administrator in charge of all the NetBIOS systems you
communicate with\&.
.IP
.IP "\fB-h\fP"
Prints the help information (usage) for \fBnmbd\fP\&.
.IP
.PP
.SH "FILES"
.PP

View File

@ -5,7 +5,7 @@ nmblookup \- NetBIOS over TCP/IP client used to lookup NetBIOS names
.PP
.SH "SYNOPSIS"
.PP
\fBnmblookup\fP [-M] [-R] [-S] [-r] [-A] [-h] [-B broadcast address] [-U unicast address] [-d debuglevel] [-s smb config file] [-i NetBIOS scope] name
\fBnmblookup\fP [-M] [-R] [-S] [-r] [-A] [-h] [-B broadcast address] [-U unicast address] [-d debuglevel] [-s smb config file] [-i NetBIOS scope] [-T] name
.PP
.SH "DESCRIPTION"
.PP
@ -20,8 +20,9 @@ or to a particular machine\&. All queries are done over UDP\&.
.PP
.IP
.IP "\fB-M\fP"
Searches for a master browser\&. This is done by doing a
broadcast lookup on the special name \f(CW__MSBROWSE__\fP\&.
Searches for a master browser by looking up the
NetBIOS name \fBname\fP with a type of 0x1d\&. If \fBname\fP
is \f(CW"-"\fP then it does a lookup on the special name \f(CW__MSBROWSE__\fP\&.
.IP
.IP "\fB-R\fP"
Set the recursion desired bit in the packet to do a
@ -55,8 +56,8 @@ Print a help (usage) message\&.
.IP "\fB-B broadcast address\fP"
Send the query to the given broadcast
address\&. Without this option the default behavior of nmblookup is to
send the query to the broadcast address of the primary network
interface as either auto-detected or defined in the
send the query to the broadcast address of the network
interfaces as either auto-detected or defined in the
\fBinterfaces\fP parameter of the
\fBsmb\&.conf (5)\fP file\&.
.IP
@ -97,6 +98,12 @@ are \fIvery\fP rarely used, only set this parameter if you are the
system administrator in charge of all the NetBIOS systems you
communicate with\&.
.IP
.IP "\fB-T\fP"
This causes any IP addresses found in the lookup to be
looked up via a reverse DNS lookup into a DNS name, and printed out
before each \f(CW"IP address NetBIOS name"\fP pair that is the normal
output\&.
.IP
.IP "\fBname\fP"
This is the NetBIOS name being queried\&. Depending upon
the previous options this may be a NetBIOS name or IP address\&. If a

View File

@ -50,18 +50,6 @@ servers (such as Windows NT), and can also be used to allow a UNIX box
to print to a printer attached to any SMB server (such as a PC running
Windows NT)\&.
.IP
.IP "\fBrpcclient\fP"
.br
.br
The \fBrpcclient\fP
(1) program is a client that can \'talk\' to an
SMB/CIFS MSRPC server\&. Operations include things like managing a SAM
Database (users, groups and aliases) in the same way as the Windows NT
programs \fBUser Manager for Domains\fP and \fBServer Manager for Domains\fP;
managing a remote registry in the same way as the Windows NT programs
\fBREGEDT32\&.EXE\fP and \fBREGEDIT\&.EXE\fP; viewing a remote event log (same
as \fBEVENTVWR\&.EXE\fP)\&.
.IP
.IP "\fBtestparm\fP"
.br
.br

File diff suppressed because it is too large Load Diff

View File

@ -5,7 +5,7 @@ smbclient \- ftp-like client to access SMB/CIFS resources on servers
.PP
.SH "SYNOPSIS"
.PP
\fBsmbclient\fP servicename [password] [-s smb\&.conf] [-B IP addr] [-O socket options][-R name resolve order] [-M NetBIOS name] [-i scope] [-N] [-n NetBIOS name] [-d debuglevel] [-P] [-p port] [-l log basename] [-h] [-I dest IP] [-E] [-U username] [-L NetBIOS name] [-t terminal code] [-m max protocol] [-W workgroup] [-T<c|x>IXFqgbNan] [-D directory] [-c command string]
\fBsmbclient\fP servicename [-s smb\&.conf] [-O socket options][-R name resolve order] [-M NetBIOS name] [-i scope] [-N] [-n NetBIOS name] [-d debuglevel] [-P] [-p port] [-l log basename] [-h] [-I dest IP] [-E] [-U username] [-L NetBIOS name] [-t terminal code] [-m max protocol] [-b buffersize] [-W workgroup] [-T<c|x>IXFqgbNan] [-D directory] [-c command string]
.PP
.SH "DESCRIPTION"
.PP
@ -65,9 +65,6 @@ Samba configuration file, smb\&.conf\&. This file controls all aspects of
the Samba setup on the machine and smbclient also needs to read this
file\&.
.IP
.IP "\fB-B IP addr\fP"
The IP address to use when sending a broadcast packet\&.
.IP
.IP "\fB-O socket options\fP"
TCP socket options to set on the client
socket\&. See the socket options
@ -104,8 +101,7 @@ no WINS server has been specified this method will be ignored\&.
listed in the \fBinterfaces\fP parameter
in the smb\&.conf file\&. This is the least reliable of the name resolution
methods as it depends on the target host being on a locally connected
subnet\&. To specify a particular broadcast address the \fB-B\fP option
may be used\&.
subnet\&.
.IP
.IP
If this parameter is not set then the name resolve order defined
@ -284,7 +280,7 @@ nothing before or nothing after the percent symbol will cause an empty
username or an empty password to be used, respectively\&.
.IP
The password may also be specified by setting up an environment
variable called \f(CWPASSWORD\fP that contains the users password\&. Note
variable called \f(CWPASSWD\fP that contains the users password\&. Note
that this may be very insecure on some systems but on others allows
users to script smbclient commands without having a password appear in
the command line of a process listing\&.
@ -294,7 +290,7 @@ on an uppercase password\&. Lowercase or mixed case passwords may be
rejected by these servers\&.
.IP
Be cautious about including passwords in scripts or in the
\f(CWPASSWORD\fP environment variable\&. Also, on many systems the command
\f(CWPASSWD\fP environment variable\&. Also, on many systems the command
line of a running process may be seen via the \f(CWps\fP command to be
safe always allow smbclient to prompt for a password and type it in
directly\&.
@ -326,6 +322,12 @@ protocols level the server supports\&. This parameter is
preserved for backwards compatibility, but any string
following the \fB-m\fP will be ignored\&.
.IP
.IP "\fB-b buffersize\fP"
This option changes the transmit/send buffer
size when getting or putting a file from/to the server\&. The default
is 65520 bytes\&. Setting this value smaller (to 1200 bytes) has been
observed to speed up file transfers to and from a Win9x server\&.
.IP
.IP "\fB-W WORKGROUP\fP"
Override the default workgroup specified in the
\fBworkgroup\fP parameter of the
@ -717,7 +719,7 @@ The variable \fBUSER\fP may contain the username of the person using the
client\&. This information is used only if the protocol level is high
enough to support session-level passwords\&.
.PP
The variable \fBPASSWORD\fP may contain the password of the person using
The variable \fBPASSWD\fP may contain the password of the person using
the client\&. This information is used only if the protocol level is
high enough to support session-level passwords\&.
.PP

View File

@ -5,7 +5,7 @@ smbd \- server to provide SMB/CIFS services to clients
.PP
.SH "SYNOPSIS"
.PP
\fBsmbd\fP [-D] [-a] [-o] [-d debuglevel] [-l log file] [-p port number] [-O socket options] [-s configuration file] [-i scope] [-P] [-h]
\fBsmbd\fP [-D] [-a] [-o] [-P] [-h] [-V] [-d debuglevel] [-l log file] [-p port number] [-O socket options] [-s configuration file] [-i scope]
.PP
.SH "DESCRIPTION"
.PP
@ -65,6 +65,16 @@ If this parameter is specified, the log files will be
overwritten when opened\&. By default, the log files will be appended
to\&.
.IP
.IP "\fB-P\fP"
Passive option\&. Causes smbd not to send any network traffic
out\&. Used for debugging by the developers only\&.
.IP
.IP "\fB-h\fP"
Prints the help information (usage) for \fBsmbd\fP\&.
.IP
.IP "\fB-V\fP"
Prints the version number for \fBsmbd\fP\&.
.IP
.IP "\fB-d debuglevel\fP"
debuglevel is an integer from 0 to 10\&.
.IP
@ -135,13 +145,6 @@ are \fIvery\fP rarely used, only set this parameter if you are the
system administrator in charge of all the NetBIOS systems you
communicate with\&.
.IP
.IP "\fB-h\fP"
Prints the help information (usage) for smbd\&.
.IP
.IP "\fB-P\fP"
Passive option\&. Causes smbd not to send any network traffic
out\&. Used for debugging by the developers only\&.
.IP
.PP
.SH "FILES"
.PP
@ -409,16 +412,11 @@ performance\&.
.PP
.SH "SEE ALSO"
.PP
\fBhosts_access (5)\fP,
\fBinetd (8)\fP,
\fBnmbd (8)\fP,
\fBsmb\&.conf (5)\fP,
\fBsmbclient (1)\fP,
\fBtestparm (1)\fP,
\fBtestprns (1)\fP,
\fBrpcclient (1)\fP,
and the Internet RFC\'s \fBrfc1001\&.txt\fP, \fBrfc1002\&.txt\fP\&.
In addition the CIFS (formerly SMB)
\fBhosts_access (5)\fP, \fBinetd (8)\fP, \fBnmbd (8)\fP,
\fBsmb\&.conf (5)\fP, \fBsmbclient
(1)\fP, \fBtestparm (1)\fP,
\fBtestprns (1)\fP, and the Internet RFC\'s
\fBrfc1001\&.txt\fP, \fBrfc1002\&.txt\fP\&. In addition the CIFS (formerly SMB)
specification is available as a link from the Web page :
http://samba\&.org/cifs/\&.
.PP

View File

@ -1,96 +1,37 @@
.TH SMBMNT 8 "13 Nov 1998" "smbmnt 2.0.0-beta1"
.SH NAME
smbmnt \- mount smb file system
.SH SYNOPSIS
.B smbmnt
.B mount-point
[
.B -u
.I uid
] [
.B -g
.I gid
] [
.B -f
.I file mode
] [
.B -d
.I dir mode
]
.SH DESCRIPTION
.B smbmnt
is a helper application used by the
.BI smbmount (8)
program to do the actual mounting.
.B smbmnt
is meant to be installed setuid root so that normal users can mount
their smb shares. It checks whether the user has write permissions
on the mount point and then mounts the directory.
The
.B smbmnt
program is normally invoked by a mount command to
.BI smbmount ,
and the command line arguments are passed directly to
.B smbmnt.
.SH OPTIONS
.B -u
.I uid,
.B -g
.I gid
.RS 3
A Lan Manager server does not tell us anything about the owner of a
file, but Unix requires that each file have an owner and a group it belongs
to. With
.B -u
and
.B -g
you can tell smbmount which id's it should assign to the files in the
mounted directory.
The defaults for these values are the current uid and gid.
.RE
.B -f
.I file mode,
.B -d
.I dir mode
.RS 3
Like
.B -u
and
.B -g,
these options are also used to bridge differences in concepts between
Lan Manager and Unix. Lan Manager does not know anything about file
permissions, so
.B smbmnt
must be told which permissions it should assign to the mounted files
and directories.
The values must be given as octal numbers. The default values are taken
from the current umask, where the file mode is the current umask,
and the dir mode adds execute permissions where the file mode gives
read permissions.
Note that these permissions can differ from the rights the server
gives to us. If you do not have write permissions on the server,
you should choose a file mode that matches your actual permissions.
This certainly cannot override the restrictions imposed by the server.
In addition to specifying the file mode, the
.B -f
argument can be used to specify certain bug-fix workarounds.
This allows bug fixes to be enabled on a per mount-point basis,
rather than being compiled into the kernel.
The required bug fixes are specified by prepending an (octal) value
to the file mode.
For information on the available bug workarounds, refer to the
.B smbfs.txt
file in the Linux kernel Documentation directory.
.RE
.SH SEE ALSO
.B smbmount(8)
.TH "smbmnt " "1" "25 September 1999" "Samba" "SAMBA"
.PP
.SH "NAME"
smbmnt \- helper utility for mounting SMB filesystems
.PP
.SH "SYNOPSIS"
\fBsmbmnt\fP mount-point [ -s share ] [ -r ] [ -u uid ] [ -g gid ] [ -f mask ] [ -d mask ]
.PP
.SH "DESCRIPTION"
.PP
smbmnt is a helper application used by the smbmount program to do the
actual mounting of SMB shares\&. smbmnt is meant to be installed setuid
root so that normal users can mount their smb shares\&. It checks
whether the user has write permissions on the mount point and then
mounts the directory\&.
.PP
The smbmnt program is normally invoked by smbmount\&. It should not be
invoked directly by users\&.
.PP
.IP "\fB-r\fP"
mount the filesystem read-only
.PP
.IP "\fB-u uid\fP"
specify the uid that the files will be owned by
.PP
.IP "\fB-g gid\fP"
specify the gid that the files will be owned by
.PP
.IP "\fB-f mask\fP"
specify the octal file mask applied
.PP
.IP "\fB-d mask\fP"
specify the octal directory mask applied
.PP
.SH "AUTHOR"
The maintainer of smbfs, smbmnt and smbmount is Andrew Tridgell
\fItridge@samba\&.org\fP

View File

@ -1,44 +1,87 @@
.TH SMBMOUNT 8 "13 Nov 1998" "smbmount 2.0.0-beta1"
.SH NAME
smbmount \- mount smb file system
.SH SYNOPSIS
.B smbmount
[
.B options
]
.SH DESCRIPTION
.B smbmount
is a stripped-down version of the
.BI smbclient (1)
program used to mount smbfs shares. It implements only the mount command,
which then calls the
.BI smbmnt (8)
program to do the actual mount.
.B smbmount
itself accepts most of the options that
.B smbclient
does. See the
.BI smbclient (1)
manpage for details.
To mount an smb file system, I suggest using the option
.B -c
for smbmount to pass the mount command. For example, use
smbmount '\\\\server\\tmp' -c 'mount /mnt -u 123 -g 456'
to mount the tmp share of server on /mnt, giving it a local uid 123
and a local gid 456.
The arguments supplied to the mount command are passed directly to the
.B smbmnt
utility for processing.
Refer to the
.BI smbmnt (8)
manpage for details.
.SH SEE ALSO
.BI smbmnt (8),
.BI smbclient (1)
.TH "smbmount " "1" "25 September 1999" "Samba" "SAMBA"
.PP
.SH "NAME"
smbmount \- mount an SMB filesystem
.PP
.SH "SYNOPSIS"
\fBsmbmount\fP service mountpoint [ -o options ]
.PP
.SH "DESCRIPTION"
.PP
smbmount mounts a SMB filesystem\&. It is usually invoked as mount\&.smb
from the mount(8) command when using the "-t smb" option\&. The kernel
must support the smbfs filesystem\&.
.PP
Options to smbmount are specified as a comma separated list of
key=value pairs\&.
.PP
NOTE: smbmount calls smbmnt to do the actual mount\&. You must make sure
that smbmnt is in the path so that it can be found\&.
.PP
.IP "\fBusername=<arg>\fP"
specifies the username to connect as\&. If this is
not given then the environment variable USER is used\&. This option can
also take the form user%password or user/workgroup or
user/workgroup%password to allow the password and workgroup to be
specified as part of the username\&.
.IP
.IP "\fBpassword=<arg>\fP"
specifies the SMB password\&. If not given then
smbmount will prompt for a passeword, unless the guest option is
given\&.
.IP
.IP "\fBnetbiosname=<arg>\fP"
sets the source NetBIOS name\&. It defaults to
the local hostname\&.
.IP
.IP "\fBuid=<arg>\fP"
sets the uid that files will be mounted as\&. It may be
specified as either a username or a numeric uid\&.
.IP
.IP "\fBgid=<arg>\fP"
sets the gid that files will be mounted as\&. It may be
specified as either a groupname or a numeric gid\&.
.IP
.IP "\fBport=<arg>\fP"
sets the remote SMB port number\&. The default is 139\&.
.IP
.IP "\fBfmask=<arg>\fP"
sets the file mask\&. This deterines the permissions
that remote files have in the local filesystem\&. The default is based
on the current umask\&.
.IP
.IP "\fBdmask=<arg>\fP"
sets the directory mask\&. This deterines the
permissions that remote directories have in the local filesystem\&. The
default is based on the current umask\&.
.IP
.IP "\fBdebug=<arg>\fP"
sets the debug level\&. This is useful for tracking
down SMB connection problems\&.
.IP
.IP "\fBip=<arg>\fP"
sets the destination host or IP address\&.
.IP
.IP "\fBworkgroup=<arg>\fP"
sets the workgroup on the destination
.IP
.IP "\fBsockopt=<arg>\fP"
sets the TCP socket options\&. See the smb\&.conf
"socket options" option\&.
.IP
.IP "\fBscope=<arg>\fP"
sets the NetBIOS scope
.IP
.IP "\fBguest\fP"
don\'t prompt for a password
.IP
.IP "\fBro\fP"
mount read-only
.IP
.IP "\fBrw\fP"
mount read-write
.IP
.PP
.SH "AUTHOR"
The maintainer of smbfs, smbmnt and smbmount is Andrew Tridgell
\fItridge@samba\&.org\fP

View File

@ -18,7 +18,7 @@ connections\&.
.PP
.IP
.IP "\fB-P\fP"
If samba has been compiled with the profiling option,
If samba has been compiled with the profiling option,
print only the contents of the profiling shared memory area\&.
.IP
.IP "\fB-b\fP"

View File

@ -1,4 +1,4 @@
.TH SMBUMOUNT 8 "13 Nov 1998" "smbumount 2.0.0-beta1"
.TH SMBUMOUNT 8 "18 May 1999" "smbumount 2.0.4"
.SH NAME
smbumount \- umount for normal users
.SH SYNOPSIS

View File

@ -1,7 +1,7 @@
.TH "swat " "8" "23 Oct 1998" "Samba" "SAMBA"
.PP
.SH "NAME"
swat \- swat - Samba Web Administration Tool
swat \- Samba Web Administration Tool
.PP
.SH "SYNOPSIS"
.PP

View File

@ -5,7 +5,7 @@ testparm \- check an smb\&.conf configuration file for internal correctness
.PP
.SH "SYNOPSIS"
.PP
\fBtestparm\fP [-s] [configfilename] [hostname hostIP]
\fBtestparm\fP [-s] [-h] [-L servername] [configfilename] [hostname hostIP]
.PP
.SH "DESCRIPTION"
.PP
@ -24,6 +24,11 @@ If the optional host name and host IP address are specified on the
command line, this test program will run through the service entries
reporting whether the specified host has access to each service\&.
.PP
If \fBtestparm\fP finds an error in the \fBsmb\&.conf\fP
file it returns an exit code of 1 to the calling program, else it returns
an exit code of 0\&. This allows shell scripts to test the output from
\fBtestparm\fP\&.
.PP
.SH "OPTIONS"
.PP
.IP
@ -32,6 +37,13 @@ Without this option, \fBtestparm\fP will prompt for a
carriage return after printing the service names and before dumping
the service definitions\&.
.IP
.IP "\fB-h\fP"
Print usage message
.IP
.IP "\fB-L servername\fP"
Sets the value of the %L macro to servername\&. This
is useful for testing include files specified with the %L macro\&.
.IP
.IP "\fBconfigfilename\fP"
This is the name of the configuration file to
check\&. If this parameter is not present then the default