From 55abd936a838a4410899db76cb5530b0c4694dc9 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 10 Oct 2001 17:19:10 +0000 Subject: mega-merge from 2.2 (This used to be commit c76bf8ed3275e217d1b691879153fe9137bcbe38) --- docs/htmldocs/smbclient.1.html | 278 ++++++++++++++++++++++++++++++----------- 1 file changed, 202 insertions(+), 76 deletions(-) (limited to 'docs/htmldocs/smbclient.1.html') diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 8232906680..16fc134405 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -37,12 +37,12 @@ NAME="AEN8" >smbclient {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-S server] [-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 <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan]

DESCRIPTION

OPTIONS

-R parameter to smbclient or - using the name resolve order parameter in the smb.conf file, +> parameter to smbclient or + using the name resolve order parameter in the smb.conf file, allowing an administrator to change the order and methods by which server names are looked up.

This option is used by the programs in the Samba suite to determine what naming services and in what order to resolve - host names to IP addresses. The option takes a space separated + host names to IP addresses. The option takes a space-separated string of different name resolution options.

The options are :"lmhosts", "host", "wins" and "bcast". They @@ -227,7 +233,7 @@ CLASS="FILENAME" >/etc/hosts , NIS, or DNS lookups. This method of name resolution - is operating system depended for instance on IRIX or Solaris this + is operating system dependent, for instance on IRIX or Solaris this may be controlled by the /etc/nsswitch.confname resolve order parameter of the smb.conf file the name resolution +> parameter of the smb.conf file the name resolution methods will be attempted in this order.

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. + on the use of NetBIOS scopes, see rfc1001.txt + and rfc1002.txt. NetBIOS scopes are very rarely used, only set @@ -383,7 +399,12 @@ CLASS="FILENAME" >-d debuglevel

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

The default value if this parameter is not specified @@ -400,7 +421,12 @@ CLASS="FILENAME" 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 debuglevel is set to the letter 'A', then all debug messages will be printed. This setting @@ -410,9 +436,9 @@ CLASS="FILENAME" to know how the code works internally).

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

-l logfilename

If specified, logfilename specifies a base filename +>If specified, logfilename specifies a base filename into which operational data from the running client will be logged.

-I IP-address

IP address is the address of the server to connect to. +>IP address is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation.

Normally the client would attempt to locate a named @@ -492,35 +528,37 @@ CLASS="PARAMETER" >

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 + will first check the USER environment variable, then the $LOGNAME variable and if either exist, the +CLASS="ENVAR" +>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 environmental + 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), rpcclient will look for +>If the password is not included in these environment + variables (using the %pass syntax), smbclient will look for a $PASSWDPASSWD environment variable from which to read the password.

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 doesn't - desire to pass the credentials on the command line or via environment + 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

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

option may be useful if your NetBIOS names don't - match your tcp/ip dns host names or if you are trying to reach a + match your TCP/IP DNS host names or if you are trying to reach a host on another network.

-t terminal code

This option tells smbclient how to interpret +>This option tells smbclient how to interpret filenames coming from the remote server. Usually Asian language multibyte UNIX implementations use different character sets than SMB/CIFS servers (r - Regular expression include - or exclude. Uses regular regular expression matching for + or exclude. Uses regular expression matching for excluding or excluding files if compiled with HAVE_REGEX_H. However this mode can be very slow. If not compiled with HAVE_REGEX_H, does a limited wildcard match on '*' and '?'. @@ -829,7 +868,10 @@ CLASS="COMMAND" >'s tar option now supports long file names both on backup and restore. However, the full path name of the file must be less than 1024 bytes. Also, when - a tar archive is created, smbclient's tar option places all + a tar archive is created, smbclient's tar option places all files in the archive with relative names, not absolute names.

Examples

Restore from tar file backup.tar into myshare on mypc +>Restore from tar file backup.tar into myshare on mypc (no password on share).

smbclient //mypc/myshare "" -N -Tx backup.tar +>smbclient //mypc/yshare "" -N -Tx backup.tar

-c command string

command string is a semicolon separated list of +>command string is a semicolon-separated list of commands to be executed instead of prompting from stdin.

OPERATIONS

? [command]

If "command" is specified, the ? command will display +>If command is specified, the ? command will display a brief informative message about the specified command. If no command is specified, a list of available commands will be displayed.

! [shell command]

If "shell command" is specified, the ! +>If shell command is specified, the ! command will execute a shell locally and run the specified shell command. If no command is specified, a local shell will be run.

The client will request that the server attempt - to delete all files matching "mask" from the current working + to delete all files matching mask from the current working directory on the server.

dir <mask>

A list of the files matching "mask" in the current +>A list of the files matching mask in the current working directory on the server will be retrieved from the server and displayed.

get <remote file name> [local file name]

Copy the file called "remote file name" from +>Copy the file called remote file name from the server to the machine running the client. If specified, name - the local copy "local file name". Note that all transfers in + the local copy local file name. Note that all transfers in smbclientlcd [directory name]

If "directory name" is specified, the current +>If directory name is specified, the current working directory on the local machine will be changed to the directory specified. This operation will fail if for any reason the specified directory is inaccessible.

mget <mask>

Copy all files matching mask from the server to +>Copy all files matching mask from the server to the machine running the client.

Note that mask is interpreted differently during recursive +>Note that mask is interpreted differently during recursive operation and non-recursive operation - refer to the recurse and mask commands for more information. Note that all transfers in - smbclient are binary. See also the lowercase command.

smbclient are binary. See also the lowercase command.

mkdir <directory name>
mput <mask>

Copy all files matching mask in the current working +>Copy all files matching mask in the current working directory on the local machine to the current working directory on the server.

Note that mask is interpreted differently during recursive +>Note that mask is interpreted differently during recursive operation and non-recursive operation - refer to the recurse and mask - commands for more information. Note that all transfers in smbclient + commands for more information. Note that all transfers in smbclient are binary.

put <local file name> [remote file name]

Copy the file called "local file name" from the +>Copy the file called local file name from the machine running the client to the server. If specified, - name the remote copy "remote file name". Note that all transfers - in smbclient are binary. See also the lowercase command. + name the remote copy remote file name. Note that all transfers + in smbclient are binary. See also the lowercase command.

rm <mask>

Remove all files matching mask from the current +>Remove all files matching mask from the current working directory on the server.

Blocksize. Must be followed by a valid (greater than zero) blocksize. Causes tar file to be written out in - blocksize*TBLOCK (usually 512 byte) blocks.

blocksize*TBLOCK (usually 512 byte) blocks.

tarmode <full|inc|reset|noreset>

NOTES

ENVIRONMENT VARIABLES

The variable $USERUSER 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.

The variable $PASSWDPASSWD 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.

The variable LIBSMB_PROG may contain + the path, executed with system(), which the client should connect + to instead of connecting to a server. This functionality is primarily + intended as a development aid, and works best when using a LMHOSTS + file

INSTALLATION

smbd(8) an ordinary user - running that server as a daemon +> as an ordinary user - running that server as a daemon on a user-accessible port (typically any port number over 1024) would provide a suitable test server.

DIAGNOSTICS

VERSION

AUTHOR