From 27aef6855f1543547b8190f06fd264d1b52a558d Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sun, 6 Apr 2003 18:42:44 +0000 Subject: Regenerate docs (This used to be commit 5a2aaa3d5b039776314067aee953921e7865dc4d) --- docs/htmldocs/smbclient.1.html | 463 +++++++++++++++++++++-------------------- 1 file changed, 237 insertions(+), 226 deletions(-) (limited to 'docs/htmldocs/smbclient.1.html') diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 4a287acf1d..9ea84de950 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -172,34 +172,6 @@ CLASS="PARAMETER"

-s smb.conf

Specifies the location of the all - important smb.conf(5) file.

-O socket options

TCP socket options to set on the client - socket. See the socket options parameter in - the smb.conf(5) manual page for the list of valid - options.

-R <name resolve order>

-i scope

This specifies a NetBIOS scope that smbclient will - use to communicate with when generating NetBIOS names. For details - on the use of NetBIOS scopes, see rfc1001.txt - and 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.

-N

If specified, this parameter suppresses the normal - password prompt from the client to the user. This is useful when - accessing a service that does not require a password.

Unless a password is specified on the command line or - this parameter is specified, the client will request a - password.

-n NetBIOS name

By default, the client will use the local - machine's hostname (in uppercase) as its NetBIOS name. This parameter - allows you to override the host name and use whatever NetBIOS - name you wish.

-d debuglevel

debuglevel is an integer from 0 to 10, or - the letter 'A'.

The default value if this parameter is not specified - is zero.

The higher this value, the more detail will be logged to - the log files about the activities of the - client. At level 0, only critical errors and serious warnings will - be logged. Level 1 is a reasonable level for day to day running - - it generates a small amount of information about operations - carried out.

Levels above 1 will generate considerable amounts of log - data, and should only be used when investigating a problem. - Levels above 3 are designed for use only by developers and - generate HUGE amounts of log data, most of which is extremely - cryptic. If debuglevel 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).

Note that specifying this parameter here will override - the log level parameter in the smb.conf (5) - file.

-p port

-h
-h|--help

Print the usage message for the client.

Print a summary of command line options.

-I IP-address
-U username[%pass]

Sets the SMB username or username and password. - If %pass is not specified, The user will be prompted. The client - will first check the USER environment variable, then the - LOGNAME variable and if either exists, the - string is uppercased. Anything in these variables following a '%' - sign will be treated as the password. If these environment - variables are not found, the username GUEST - is used.

If the password is not included in these environment - variables (using the %pass syntax), smbclient will look for - a PASSWD environment variable from which - to read the password.

A third option is to use a credentials file which - contains the plaintext of the domain name, username and password. This - option is mainly provided for scripts where the admin doesn't - wish to pass the credentials on the command line or via environment - variables. If this method is used, make certain that the permissions - on the file restrict access from unwanted users. See the - -A for more details.

Be cautious about including passwords in scripts or in - the PASSWD environment variable. Also, on - many systems the command line of a running process may be seen - via the ps command to be safe always allow - smbclient to prompt for a password and type - it in directly.

-A filename

This option allows - you to specify a file from which to read the username, domain name, and - password used in the connection. The format of the file is - 

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

If the domain parameter is missing the current workgroup name - is used instead. Make certain that the permissions on the file restrict - access from unwanted users.

-L

-W WORKGROUP
-V

Prints the version number for +smbd.

-s <configuration file>

The file specified contains the +configuration details required by the server. The +information in this file includes server-specific +information such as what printcap file to use, as well +as descriptions of all the services that the server is +to provide. See smb.conf(5) for more information. +The default configuration file name is determined at +compile time.

-d|--debug=debuglevel

debuglevel is an integer +from 0 to 10. The default value if this parameter is +not specified is zero.

The higher this value, the more detail will be +logged to the log files about the activities of the +server. At level 0, only critical errors and serious +warnings will be logged. Level 1 is a reasonable level for +day to day running - it generates a small amount of +information about operations carried out.

Levels above 1 will generate considerable +amounts of log data, and should only be used when +investigating a problem. Levels above 3 are designed for +use only by developers and generate HUGE amounts of log +data, most of which is extremely cryptic.

Note that specifying this parameter here will +override the log +level parameter in the smb.conf(5) file.

-l|--logfile=logbasename

File name for log/debug files. The extension +".client" will be appended. The log file is +never removed by the client.

-N

If specified, this parameter suppresses the normal +password prompt from the client to the user. This is useful when +accessing a service that does not require a password.

Unless a password is specified on the command line or +this parameter is specified, the client will request a +password.

-k

Try to authenticate with kerberos. Only useful in +an Active Directory environment.

-A|--authfile=filename

Override the default workgroup (domain) specified - in the workgroup parameter of the This option allows +you to specify a file from which to read the username and +password used in the connection. The format of the file is

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

Make certain that the permissions on the file restrict +access from unwanted users.

-U|--user=username[%password]

Sets the SMB username or username and password.

If %password is not specified, the user will be prompted. The +client will first check the USER environment variable, then the +LOGNAME variable and if either exists, the +string is uppercased. If these environmental variables are not +found, the username GUEST is used.

A third option is to use a credentials file which +contains the plaintext of the username and password. This +option is mainly provided for scripts where the admin does not +wish to pass the credentials on the command line or via environment +variables. If this method is used, make certain that the permissions +on the file restrict access from unwanted users. See the +-A for more details.

Be cautious about including passwords in scripts. Also, on +many systems the command line of a running process may be seen +via the ps command. To be safe always allow +rpcclient to prompt for a password and type +it in directly.

-n <primary NetBIOS name>

This option allows you to override +the NetBIOS name that Samba uses for itself. This is identical +to setting the NetBIOS +name parameter in the smb.conf(5) file for this connection. This may be - needed to connect to some servers.

file. However, a command +line setting will take precedence over settings in +smb.conf(5).

-i <scope>

This specifies a NetBIOS scope that +nmblookup will use to communicate with when +generating NetBIOS names. For details on the use of NetBIOS +scopes, see rfc1001.txt and 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.

-W|--workgroup=domain

Set the SMB domain of the username. This +overrides the default domain which is the domain defined in +smb.conf. If the domain specified is the same as the servers +NetBIOS name, it causes the client to log on using the servers local +SAM (as opposed to the Domain SAM).

-O socket options

TCP socket options to set on the client +socket. See the socket options parameter in +the smb.conf(5) manual page for the list of valid +options.

-T tar options
-c 'print -'.

-k

Try to authenticate with kerberos. Only useful in - an Active Directory environment. -

OPERATIONS

NOTES

ENVIRONMENT VARIABLES

INSTALLATION

DIAGNOSTICS

VERSION

AUTHOR