Changeset 427 for vendor/current/docs/manpages/smbclient.1
- Timestamp:
- Apr 9, 2010, 3:20:58 PM (15 years ago)
- File:
-
- 1 edited
-
vendor/current/docs/manpages/smbclient.1 (modified) (27 diffs)
Legend:
- Unmodified
- Added
- Removed
-
vendor/current/docs/manpages/smbclient.1
r414 r427 1 '\" t2 1 .\" Title: smbclient 3 2 .\" Author: [see the "AUTHOR" section] 4 .\" Generator: DocBook XSL Stylesheets v1.7 5.2<http://docbook.sf.net/>5 .\" Date: 0 2/19/20103 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 03/30/2010 6 5 .\" Manual: User Commands 7 6 .\" Source: Samba 3.5 8 7 .\" Language: English 9 8 .\" 10 .TH "SMBCLIENT" "1" "02/19/2010" "Samba 3\&.5" "User Commands" 9 .TH "SMBCLIENT" "1" "03/30/2010" "Samba 3\&.5" "User Commands" 10 .\" ----------------------------------------------------------------- 11 .\" * (re)Define some macros 12 .\" ----------------------------------------------------------------- 13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 14 .\" toupper - uppercase a string (locale-aware) 15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 16 .de toupper 17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ 18 \\$* 19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz 20 .. 21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 22 .\" SH-xref - format a cross-reference to an SH section 23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 24 .de SH-xref 25 .ie n \{\ 26 .\} 27 .toupper \\$* 28 .el \{\ 29 \\$* 30 .\} 31 .. 32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 33 .\" SH - level-one heading that works better for non-TTY output 34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 35 .de1 SH 36 .\" put an extra blank line of space above the head in non-TTY output 37 .if t \{\ 38 .sp 1 39 .\} 40 .sp \\n[PD]u 41 .nr an-level 1 42 .set-an-margin 43 .nr an-prevailing-indent \\n[IN] 44 .fi 45 .in \\n[an-margin]u 46 .ti 0 47 .HTML-TAG ".NH \\n[an-level]" 48 .it 1 an-trap 49 .nr an-no-space-flag 1 50 .nr an-break-flag 1 51 \." make the size of the head bigger 52 .ps +3 53 .ft B 54 .ne (2v + 1u) 55 .ie n \{\ 56 .\" if n (TTY output), use uppercase 57 .toupper \\$* 58 .\} 59 .el \{\ 60 .nr an-break-flag 0 61 .\" if not n (not TTY), use normal case (not uppercase) 62 \\$1 63 .in \\n[an-margin]u 64 .ti 0 65 .\" if not n (not TTY), put a border/line under subheading 66 .sp -.6 67 \l'\n(.lu' 68 .\} 69 .. 70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 71 .\" SS - level-two heading that works better for non-TTY output 72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 73 .de1 SS 74 .sp \\n[PD]u 75 .nr an-level 1 76 .set-an-margin 77 .nr an-prevailing-indent \\n[IN] 78 .fi 79 .in \\n[IN]u 80 .ti \\n[SN]u 81 .it 1 an-trap 82 .nr an-no-space-flag 1 83 .nr an-break-flag 1 84 .ps \\n[PS-SS]u 85 \." make the size of the head bigger 86 .ps +2 87 .ft B 88 .ne (2v + 1u) 89 .if \\n[.$] \&\\$* 90 .. 91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 92 .\" BB/BE - put background/screen (filled box) around block of text 93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 94 .de BB 95 .if t \{\ 96 .sp -.5 97 .br 98 .in +2n 99 .ll -2n 100 .gcolor red 101 .di BX 102 .\} 103 .. 104 .de EB 105 .if t \{\ 106 .if "\\$2"adjust-for-leading-newline" \{\ 107 .sp -1 108 .\} 109 .br 110 .di 111 .in 112 .ll 113 .gcolor 114 .nr BW \\n(.lu-\\n(.i 115 .nr BH \\n(dn+.5v 116 .ne \\n(BHu+.5v 117 .ie "\\$2"adjust-for-leading-newline" \{\ 118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 119 .\} 120 .el \{\ 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 122 .\} 123 .in 0 124 .sp -.5v 125 .nf 126 .BX 127 .in 128 .sp .5v 129 .fi 130 .\} 131 .. 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 133 .\" BM/EM - put colored marker in margin next to block of text 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 135 .de BM 136 .if t \{\ 137 .br 138 .ll -2n 139 .gcolor red 140 .di BX 141 .\} 142 .. 143 .de EM 144 .if t \{\ 145 .br 146 .di 147 .ll 148 .gcolor 149 .nr BH \\n(dn 150 .ne \\n(BHu 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] 152 .in 0 153 .nf 154 .BX 155 .in 156 .fi 157 .\} 158 .. 11 159 .\" ----------------------------------------------------------------- 12 160 .\" * set default formatting … … 19 167 .\" * MAIN CONTENT STARTS HERE * 20 168 .\" ----------------------------------------------------------------- 21 .SH "N AME"169 .SH "Name" 22 170 smbclient \- ftp\-like client to access SMB/CIFS resources on servers 23 .SH "SYNOPSIS" 171 .SH "Synopsis" 172 .fam C 24 173 .HP \w'\ 'u 25 smbclient [\-b\ <buffer\ size>] [\-d\ debuglevel] [\-e] [\-L\ <netbios\ name>] [\-U\ username] [\-I\ destinationIP] [\-M\ <netbios\ name>] [\-m\ maxprotocol] [\-A\ authfile] [\-N] [\-C] [\-g] [\-i\ scope] [\-O\ <socket\ options>] [\-p\ port] [\-R\ <name\ resolve\ order>] [\-s\ <smb\ config\ file>] [\-k] [\-P] [\-c\ <command>] 174 \FCsmbclient\F[] [\-b\ <buffer\ size>] [\-d\ debuglevel] [\-e] [\-L\ <netbios\ name>] [\-U\ username] [\-I\ destinationIP] [\-M\ <netbios\ name>] [\-m\ maxprotocol] [\-A\ authfile] [\-N] [\-C] [\-g] [\-i\ scope] [\-O\ <socket\ options>] [\-p\ port] [\-R\ <name\ resolve\ order>] [\-s\ <smb\ config\ file>] [\-k] [\-P] [\-c\ <command>] 175 .fam 176 .fam C 26 177 .HP \w'\ 'u 27 smbclient {servicename} [password] [\-b\ <buffer\ size>] [\-d\ debuglevel] [\-e] [\-D\ Directory] [\-U\ username] [\-W\ workgroup] [\-M\ <netbios\ name>] [\-m\ maxprotocol] [\-A\ authfile] [\-N] [\-C] [\-g] [\-l\ log\-basename] [\-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] [\-k] 178 \FCsmbclient\F[] {servicename} [password] [\-b\ <buffer\ size>] [\-d\ debuglevel] [\-e] [\-D\ Directory] [\-U\ username] [\-W\ workgroup] [\-M\ <netbios\ name>] [\-m\ maxprotocol] [\-A\ authfile] [\-N] [\-C] [\-g] [\-l\ log\-basename] [\-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] [\-k] 179 .fam 28 180 .SH "DESCRIPTION" 29 181 .PP … … 32 184 suite\&. 33 185 .PP 34 smbclient 186 \FCsmbclient\F[] 35 187 is a client that can \'talk\' to an SMB/CIFS server\&. It offers an interface similar to that of the ftp program (see 36 188 \fBftp\fR(1))\&. Operations include things like getting files from the server to the local machine, putting files from the local machine to the server, retrieving directory information from the server and so on\&. … … 40 192 .RS 4 41 193 servicename is the name of the service you want to use on the server\&. A service name takes the form 42 //server/service 194 \FC//server/service\F[] 43 195 where 44 196 \fIserver \fR … … 46 198 \fIservice\fR 47 199 is the name of the service offered\&. Thus to connect to the service "printer" on the SMB/CIFS server "smbserver", you would use the servicename 48 //smbserver/printer 200 \FC//smbserver/printer \F[] 49 201 .sp 50 202 Note that the server name required is NOT necessarily the IP (DNS) host name of the server ! The name required is a NetBIOS server name, which may or may not be the same as the IP hostname of the machine running the server\&. … … 53 205 \fI\-R\fR 54 206 parameter to 55 smbclient 207 \FCsmbclient\F[] 56 208 or using the name resolve order parameter in the 57 209 \fBsmb.conf\fR(5) … … 104 256 .\} 105 257 \fBhost\fR: Do a standard host name to IP address resolution, using the system 106 /etc/hosts, NIS, or DNS lookups\&. This method of name resolution is operating system dependent, for instance on IRIX or Solaris this may be controlled by the107 /etc/nsswitch\&.conf 258 \FC/etc/hosts \F[], NIS, or DNS lookups\&. This method of name resolution is operating system dependent, for instance on IRIX or Solaris this may be controlled by the 259 \FC/etc/nsswitch\&.conf\F[] 108 260 file)\&. Note that this method is only used if the NetBIOS name type being queried is the 0x20 (server) name type, otherwise it is ignored\&. 109 261 .RE … … 155 307 .sp 156 308 One useful trick is to pipe the message through 157 smbclient\&. For example: smbclient \-M FRED < mymessage\&.txt will send the message in the file158 mymessage\&.txt 309 \FCsmbclient\F[]\&. For example: smbclient \-M FRED < mymessage\&.txt will send the message in the file 310 \FCmymessage\&.txt\F[] 159 311 to the machine FRED\&. 160 312 .sp … … 223 375 .RS 4 224 376 This option allows you to look at what services are available on a server\&. You use it as 225 smbclient \-L host 377 \FCsmbclient \-L host\F[] 226 378 and a list should appear\&. The 227 379 \fI\-I \fR … … 251 403 \m[blue]\fB\%smb.conf.5.html#\fR\m[] 252 404 parameter in the 253 smb\&.conf 405 \FCsmb\&.conf\F[] 254 406 file\&. 255 407 .RE … … 263 415 .RS 4 264 416 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 265 smb\&.conf 417 \FCsmb\&.conf\F[] 266 418 for more information\&. The default configuration file name is determined at compile time\&. 267 419 .RE … … 300 452 .RS 4 301 453 .\} 454 .fam C 455 .ps -1 302 456 .nf 457 .if t \{\ 458 .sp -1 459 .\} 460 .BB lightgray adjust-for-leading-newline 461 .sp -1 462 303 463 username = <value> 304 464 password = <value> 305 465 domain = <value> 466 .EB lightgray adjust-for-leading-newline 467 .if t \{\ 468 .sp 1 469 .\} 306 470 .fi 471 .fam 472 .ps +1 307 473 .if n \{\ 308 474 .RE … … 329 495 .sp 330 496 Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the 331 ps 497 \FCps\F[] 332 498 command\&. To be safe always allow 333 rpcclient 499 \FCrpcclient\F[] 334 500 to prompt for a password and type it in directly\&. 335 501 .RE … … 340 506 \m[blue]\fB\%smb.conf.5.html#\fR\m[] 341 507 parameter in the 342 smb\&.conf 508 \FCsmb\&.conf\F[] 343 509 file\&. However, a command line setting will take precedence over settings in 344 smb\&.conf\&.510 \FCsmb\&.conf\F[]\&. 345 511 .RE 346 512 .PP … … 348 514 .RS 4 349 515 This specifies a NetBIOS scope that 350 nmblookup 516 \FCnmblookup\F[] 351 517 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 352 518 \fIvery\fR … … 362 528 .RS 4 363 529 TCP socket options to set on the client socket\&. See the socket options parameter in the 364 smb\&.conf 530 \FCsmb\&.conf\F[] 365 531 manual page for the list of valid options\&. 366 532 .RE … … 369 535 .RS 4 370 536 smbclient may be used to create 371 tar(1) 537 \FCtar(1) \F[] 372 538 compatible backups of all the files on an SMB/CIFS share\&. The secondary tar flags that can be given to this option are : 373 539 .sp … … 526 692 \fITar Long File Names\fR 527 693 .sp 528 smbclient\'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,529 smbclient\'s tar option places all files in the archive with relative names, not absolute names\&.694 \FCsmbclient\F[]\'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, 695 \FCsmbclient\F[]\'s tar option places all files in the archive with relative names, not absolute names\&. 530 696 .sp 531 697 \fITar Filenames\fR … … 536 702 .sp 537 703 Restore from tar file 538 backup\&.tar 704 \FCbackup\&.tar\F[] 539 705 into myshare on mypc (no password on share)\&. 540 706 .sp 541 smbclient //mypc/yshare "" \-N \-Tx backup\&.tar 707 \FCsmbclient //mypc/yshare "" \-N \-Tx backup\&.tar \F[] 542 708 .sp 543 709 Restore everything except 544 users/docs 545 .sp 546 smbclient //mypc/myshare "" \-N \-TXx backup\&.tar users/docs 710 \FCusers/docs\F[] 711 .sp 712 \FCsmbclient //mypc/myshare "" \-N \-TXx backup\&.tar users/docs\F[] 547 713 .sp 548 714 Create a tar file of the files beneath 549 users/docs\&.550 .sp 551 smbclient //mypc/myshare "" \-N \-Tc backup\&.tar users/docs 715 \FC users/docs\F[]\&. 716 .sp 717 \FCsmbclient //mypc/myshare "" \-N \-Tc backup\&.tar users/docs \F[] 552 718 .sp 553 719 Create the same tar file as above, but now use a DOS path name\&. 554 720 .sp 555 smbclient //mypc/myshare "" \-N \-tc backup\&.tar users\eedocs 721 \FCsmbclient //mypc/myshare "" \-N \-tc backup\&.tar users\eedocs \F[] 556 722 .sp 557 723 Create a tar file of the files listed in the file 558 tarlist\&.559 .sp 560 smbclient //mypc/myshare "" \-N \-TcF backup\&.tar tarlist 724 \FCtarlist\F[]\&. 725 .sp 726 \FCsmbclient //mypc/myshare "" \-N \-TcF backup\&.tar tarlist\F[] 561 727 .sp 562 728 Create a tar file of all the files and directories in the share\&. 563 729 .sp 564 smbclient //mypc/myshare "" \-N \-Tc backup\&.tar * 730 \FCsmbclient //mypc/myshare "" \-N \-Tc backup\&.tar * \F[] 565 731 .RE 566 732 .PP … … 578 744 .sp 579 745 This is particularly useful in scripts and for printing stdin to the server, e\&.g\&. 580 \ -c \'print \-\'\&.746 \FC\-c \'print \-\'\F[]\&. 581 747 .RE 582 748 .SH "OPERATIONS" … … 584 750 Once the client is running, the user is presented with a prompt : 585 751 .PP 586 smb:\e> 752 \FCsmb:\e> \F[] 587 753 .PP 588 754 The backslash ("\e\e") indicates the current working directory on the server, and will change if the current working directory is changed\&. … … 696 862 .RS 4 697 863 Copy the file called 698 remote file name 864 \FCremote file name\F[] 699 865 from the server to the machine running the client\&. If specified, name the local copy 700 local file name\&. Note that all transfers in701 smbclient 866 \FClocal file name\F[]\&. Note that all transfers in 867 \FCsmbclient\F[] 702 868 are binary\&. See also the lowercase command\&. 703 869 .RE … … 794 960 \fImask\fR 795 961 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 796 smbclient 962 \FCsmbclient\F[] 797 963 are binary\&. See also the lowercase command\&. 798 964 .RE … … 817 983 \fImask\fR 818 984 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 819 smbclient 985 \FCsmbclient\F[] 820 986 are binary\&. 821 987 .RE … … 866 1032 .RS 4 867 1033 Copy the file called 868 local file name 1034 \FClocal file name\F[] 869 1035 from the machine running the client to the server\&. If specified, name the remote copy 870 remote file name\&. Note that all transfers in871 smbclient 1036 \FCremote file name\F[]\&. Note that all transfers in 1037 \FCsmbclient\F[] 872 1038 are binary\&. See also the lowercase command\&. 873 1039 .RE … … 926 1092 A version of the DOS attrib command to set file permissions\&. For example: 927 1093 .sp 928 setmode myfile +r 1094 \FCsetmode myfile +r \F[] 929 1095 .sp 930 1096 would make myfile read only\&. … … 1003 1169 .PP 1004 1170 It is recommended that the smbclient software be installed in the 1005 /usr/local/samba/bin/ 1171 \FC/usr/local/samba/bin/\F[] 1006 1172 or 1007 /usr/samba/bin/ 1173 \FC /usr/samba/bin/\F[] 1008 1174 directory, this directory readable by all, writeable only by root\&. The client program itself should be executable by all\&. The client should 1009 1175 \fINOT\fR
Note:
See TracChangeset
for help on using the changeset viewer.
