From e2a958058c7977ba81badc4a205a8e762595f1c8 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 27 Nov 2002 02:42:12 +0000 Subject: update docs for "password server" and regenerate also fixed a number of syntax errors in the SGML source for several man pages (people really need to start validating docs before checking them in). (This used to be commit 91a21782e09562644ab4938cb0170b8fb94f0ccf) --- docs/htmldocs/nmbd.8.html | 75 ++++++++++---------------- docs/htmldocs/rpcclient.1.html | 103 +++++++++++++++--------------------- docs/htmldocs/smbclient.1.html | 116 ++++++++++++++++------------------------- docs/htmldocs/smbd.8.html | 100 ++++++++++------------------------- 4 files changed, 142 insertions(+), 252 deletions(-) (limited to 'docs/htmldocs') diff --git a/docs/htmldocs/nmbd.8.html b/docs/htmldocs/nmbd.8.html index 05bf860124..c427e488dc 100644 --- a/docs/htmldocs/nmbd.8.html +++ b/docs/htmldocs/nmbd.8.html @@ -1,11 +1,12 @@ - + nmbd

nmbd

nmbd

Synopsis

nmbd [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

[-D] [-a] [-i] [-o] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

DESCRIPTION

is a server that understands and can reply to NetBIOS over IP name service requests, like those produced by SMB/CIFS clients such as Windows 95/98/ME, - Windows NT, Windows 2000, and LanManager clients. It also + Windows NT, Windows 2000, Windows XP and LanManager clients. It also participates in the browsing protocols which make up the Windows "Network Neighborhood" view.

-n option (see OPTIONS below). Thus

OPTIONS

.

-H <filename>
-H <filename>

NetBIOS lmhosts file. The lmhosts @@ -209,24 +203,18 @@ CLASS="FILENAME" > to resolve any NetBIOS name queries needed by the server. Note - that the contents of this file are NOT used by nmbd to answer any name queries. Adding a line to this file affects name NetBIOS resolution - from this host ONLY.

The default path to this file is compiled into @@ -264,7 +252,7 @@ CLASS="COMMAND" >.

-d <debug level>
-d <debug level>

debuglevel is an integer @@ -300,7 +288,7 @@ CLASS="FILENAME" > file.

-l <log directory>
-l <log directory>

The -l parameter specifies a directory @@ -320,12 +308,9 @@ CLASS="FILENAME" /var/log/log.nmb. . Beware: If the directory specified does not exist,

-n <primary NetBIOS name>
-n <primary NetBIOS name>

This option allows you to override @@ -360,7 +345,7 @@ CLASS="FILENAME" >.

-p <UDP port number>
-p <UDP port number>

UDP port number is a positive integer value. @@ -373,7 +358,7 @@ CLASS="COMMAND" won't need help!

-s <configuration file>
-s <configuration file>

The default configuration file name @@ -400,7 +385,7 @@ CLASS="FILENAME" >

FILES

If nmbd is acting as a is acting as a browse master (see the

SIGNALS

nmbd
process it is recommended - that SIGKILL (-9) NOT be used, except as a last resort, as this may leave the name database in an inconsistent state. The correct way to terminate

VERSION

This man page is correct for version 2.2 of +>This man page is correct for version 3.0 of the Samba suite.

SEE ALSO

AUTHOR

+ rpcclient

rpcclient

rpcclient

Synopsis

rpcclient [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}

[-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}

		username = <value> 
-		password = <value>
-		domain   = <value>
+>		username = <value> 
+		password = <value>
+		domain   = <value>
 		

Make certain that the permissions on the file restrict @@ -124,25 +130,6 @@ CLASS="PROGRAMLISTING" below))

-d|--debug=debuglevel

set the debuglevel. Debug level 0 is the lowest - and 100 being the highest. This should be set to 100 if you are - planning on submitting a bug report to the Samba team (see BUGS.txt). -

-h|--help

Print a summary of command line options. -

-I IP-address

COMMANDS

LSARPC

SAMR

SPOOLSS

adddriver <arch> <config>adddriver <arch> <config> - Execute an AddPrinterDriver() RPC to install the printer driver information on the server. Note that the driver files should @@ -437,6 +415,12 @@ CLASS="PARAMETER" > parameter is defined as follows:

		Long Printer Name:\
@@ -448,6 +432,9 @@ CLASS="PROGRAMLISTING"
 		Default Data Type:\
 		Comma Separated list of Files
 		

Any empty fields should be enter as the string "NULL".

addprinter <printername> - <sharename> <drivername> <port>addprinter <printername> + <sharename> <drivername> <port> - Add a printer on the remote server. This printer will be automatically shared. Be aware that the printer driver @@ -510,7 +497,7 @@ CLASS="COMMAND" >

enumjobs <printer>enumjobs <printer> - List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() @@ -552,7 +539,7 @@ CLASS="COMMAND" >

getdata <printername>getdata <printername> - Retrieve the data for a given printer setting. See the

getdriver <printername>getdriver <printername> - Retrieve the printer driver information (such as driver file, config file, dependent files, etc...) for @@ -578,7 +565,7 @@ CLASS="COMMAND" >

getdriverdir <arch>getdriverdir <arch> - Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for @@ -596,7 +583,7 @@ CLASS="PARAMETER" >

getprinter <printername>getprinter <printername> - Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function. @@ -606,7 +593,7 @@ CLASS="COMMAND" >

openprinter <printername>openprinter <printername> - Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer.

setdriver <printername> - <drivername>setdriver <printername> + <drivername> - Execute a SetPrinter() command to update the printer driver associated with an installed printer. The printer driver must @@ -634,12 +621,9 @@ CLASS="COMMAND" >

GENERAL OPTIONS

BUGS

From Luke Leighton's original rpcclient man page:

"WARNING! The MSRPC over SMB code has been developed from examining Network traces. No documentation is available from the original creators (Microsoft) on how MSRPC over @@ -722,7 +703,7 @@ CLASS="COMMAND" >

VERSION

AUTHOR

+ smbclient

smbclient

smbclient

Synopsis

smbclient {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan]

{servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan]

-R <name resolve order>
-R <name resolve order>

This option is used by the programs in the Samba @@ -349,12 +346,9 @@ CLASS="FILENAME" > for a description of how to handle incoming WinPopup messages in Samba.

Note: Copy WinPopup into the startup group on your WfWg PCs if you want them to always be able to receive messages.

rfc1002.txt. - NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.

debuglevel is set to the letter 'A', then is set to the letter 'A', then all debug messages will be printed. This setting - is for developers only (and people who really want to know how the code works internally).

username = <value> 
-password = <value>
-domain = <value>
+>username = <value> 
+password = <value>
+domain = <value>
 		

If the domain parameter is missing the current workgroup name @@ -651,18 +645,12 @@ CLASS="COMMAND" > how to interpret filenames coming from the remote server. Usually Asian language multibyte UNIX implementations use different character sets than - SMB/CIFS servers (EUC instead of instead of SJIS for example). Setting this parameter will let

Tar Long File Names

Tar Filenames

All file names can be given as DOS path names (with '\' as the component separator) or as UNIX path names (with '/' as the component separator).

Examples

Restore from tar file

smb:\> smb:\>

The backslash ("\") indicates the current working directory @@ -1036,7 +1015,7 @@ CLASS="PROMPT" >

Parameters shown in square brackets (e.g., "[parameter]") are optional. If not given, the command will use suitable defaults. Parameters - shown in angle brackets (e.g., "<parameter>") are required. + shown in angle brackets (e.g., "<parameter>") are required.

Note that all commands operating on the server are actually @@ -1127,7 +1106,7 @@ CLASS="REPLACEABLE" directory on the server will be reported.

del <mask>
del <mask>

The client will request that the server attempt @@ -1140,7 +1119,7 @@ CLASS="REPLACEABLE" directory on the server.

dir <mask>
dir <mask>

A list of the files matching

get <remote file name> [local file name]
get <remote file name> [local file name]

Copy the file called

ls <mask>
ls <mask>

See the dir command above.

mask <mask>
mask <mask>

This command allows the user to set up a mask @@ -1257,13 +1236,13 @@ CLASS="REPLACEABLE" mask back to "*" after using the mget or mput commands.

md <directory name>
md <directory name>

See the mkdir command.

mget <mask>
mget <mask>

Copy all files matching are binary. See also the lowercase command.

mkdir <directory name>
mkdir <directory name>

Create a new directory on the server (user access privileges permitting) with the specified name.

mput <mask>
mput <mask>

Copy all files matching

print <file name>
print <file name>

Print the specified file from the local machine @@ -1330,7 +1309,7 @@ CLASS="COMMAND" >See also the printmode command.

printmode <graphics or text>
printmode <graphics or text>

Set the print mode to suit either binary data @@ -1350,7 +1329,7 @@ CLASS="COMMAND"

put <local file name> [remote file name]
put <local file name> [remote file name]

Copy the file called See the exit command.

rd <directory name>
rd <directory name>

See the rmdir command.

rm <mask>
rm <mask>

Remove all files matching

rmdir <directory name>
rmdir <directory name>

Remove the specified directory (user access privileges permitting) from the server.

setmode <filename> <perm=[+|\-]rsha>
setmode <filename> <perm=[+|\-]rsha>

A version of the DOS attrib command to set @@ -1451,7 +1430,7 @@ CLASS="COMMAND"

tar <c|x>[IXbgNa]
tar <c|x>[IXbgNa]

Performs a tar operation - see the

blocksize <blocksize>
blocksize <blocksize>

Blocksize. Must be followed by a valid (greater @@ -1480,7 +1459,7 @@ CLASS="REPLACEABLE" >*TBLOCK (usually 512 byte) blocks.

tarmode <full|inc|reset|noreset>
tarmode <full|inc|reset|noreset>

Changes tar's behavior with regard to archive @@ -1568,12 +1547,9 @@ CLASS="FILENAME" > /usr/samba/bin/ directory, this directory readable by all, writeable only by root. The client program itself should - be executable by all. The client should NOT be setuid or setgid!

+ smbd

smbd

smbd

Synopsis

smbd [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

[-D] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

DESCRIPTION

OPTIONS

-a

If this parameter is specified, each new - connection will append log messages to the log file. - This is the default.

-i

-o

If this parameter is specified, the - log files will be overwritten when opened. By default, - smbd will append entries to the log - files.

-P

Passive option. Causes smbd not to - send any network traffic out. Used for debugging by - the developers only.

-h

.

-v
-V

Prints the version number for @@ -206,7 +172,7 @@ CLASS="COMMAND" Samba was built.

-d <debug level>
-d <debug level>

file.

-l <log directory>
-l <log directory>

If specified, @@ -273,12 +239,9 @@ TARGET="_top" CLASS="FILENAME" > smb.conf(5) file. file. Beware: If the directory specified does not exist,

-O <socket options>
-O <socket options>

See the file for details.

-p <port number>
-p <port number>

-s <configuration file>
-s <configuration file>

The file specified contains the @@ -366,7 +329,7 @@ CLASS="FILENAME" >

FILES

LIMITATIONS

ENVIRONMENT VARIABLES

PAM INTERACTION

  • Account Validation: All acccesses to a +>: All accesses to a samba server are checked against PAM to see if the account is vaild, not disabled and is permitted to login at this time. This also applies to encrypted logins. @@ -563,12 +523,9 @@ CLASS="EMPHASIS" >

  • Session Management: When not using share level secuirty, users must pass PAM's session checks before access is granted. Note however, that this is bypassed in share level secuirty. @@ -581,18 +538,18 @@ CLASS="EMPHASIS" >

    VERSION

    This man page is correct for version 2.2 of +>This man page is correct for version 3.0 of the Samba suite.

    DIAGNOSTICS

    SIGNALS

    SIGKILL (-9) NOT be used, except as a last resort, as this may leave the shared memory area in an inconsistent state. The safe way to terminate @@ -684,7 +638,7 @@ CLASS="COMMAND" >

    SEE ALSO

    AUTHOR