Changeset 596 for trunk/server/docs/manpages/rpcclient.1
- Timestamp:
- Jul 2, 2011, 3:35:33 PM (14 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/server/docs/manpages/rpcclient.1
r480 r596 1 '\" t 1 2 .\" Title: rpcclient 2 3 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.7 4.0<http://docbook.sf.net/>4 .\" Date: 0 6/18/20104 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> 5 .\" Date: 03/06/2011 5 6 .\" Manual: User Commands 6 7 .\" Source: Samba 3.5 7 8 .\" Language: English 8 9 .\" 9 .TH "RPCCLIENT" "1" "06/18/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 .. 10 .TH "RPCCLIENT" "1" "03/06/2011" "Samba 3\&.5" "User Commands" 159 11 .\" ----------------------------------------------------------------- 160 12 .\" * set default formatting … … 167 19 .\" * MAIN CONTENT STARTS HERE * 168 20 .\" ----------------------------------------------------------------- 169 .SH "N ame"21 .SH "NAME" 170 22 rpcclient \- tool for executing client side MS\-RPC functions 171 .SH "Synopsis" 172 .fam C 23 .SH "SYNOPSIS" 173 24 .HP \w'\ 'u 174 \FCrpcclient\F[] [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-I\ destinationIP] {server} 175 .fam 25 rpcclient [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-I\ destinationIP] {server} 176 26 .SH "DESCRIPTION" 177 27 .PP … … 180 30 suite\&. 181 31 .PP 182 \FCrpcclient\F[] 32 rpcclient 183 33 is a utility initially developed to test MS\-RPC functionality in Samba itself\&. It has undergone several stages of development and stability\&. Many system administrators have now written scripts around it to manage Windows NT clients from their UNIX workstation\&. 184 34 .SH "OPTIONS" … … 226 76 \m[blue]\fB\%smb.conf.5.html#\fR\m[] 227 77 parameter in the 228 \FCsmb\&.conf\F[] 78 smb\&.conf 229 79 file\&. 230 80 .RE … … 238 88 .RS 4 239 89 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 240 \FCsmb\&.conf\F[] 90 smb\&.conf 241 91 for more information\&. The default configuration file name is determined at compile time\&. 242 92 .RE … … 275 125 .RS 4 276 126 .\} 277 .fam C278 .ps -1279 127 .nf 280 .if t \{\281 .sp -1282 .\}283 .BB lightgray adjust-for-leading-newline284 .sp -1285 286 128 username = <value> 287 129 password = <value> 288 130 domain = <value> 289 .EB lightgray adjust-for-leading-newline290 .if t \{\291 .sp 1292 .\}293 131 .fi 294 .fam295 .ps +1296 132 .if n \{\ 297 133 .RE … … 318 154 .sp 319 155 Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the 320 \FCps\F[] 156 ps 321 157 command\&. To be safe always allow 322 \FCrpcclient\F[] 158 rpcclient 323 159 to prompt for a password and type it in directly\&. 324 160 .RE … … 329 165 \m[blue]\fB\%smb.conf.5.html#\fR\m[] 330 166 parameter in the 331 \FCsmb\&.conf\F[] 167 smb\&.conf 332 168 file\&. However, a command line setting will take precedence over settings in 333 \FCsmb\&.conf\F[]\&.169 smb\&.conf\&. 334 170 .RE 335 171 .PP … … 337 173 .RS 4 338 174 This specifies a NetBIOS scope that 339 \FCnmblookup\F[] 175 nmblookup 340 176 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 341 177 \fIvery\fR … … 351 187 .RS 4 352 188 TCP socket options to set on the client socket\&. See the socket options parameter in the 353 \FCsmb\&.conf\F[] 189 smb\&.conf 354 190 manual page for the list of valid options\&. 355 191 .RE … … 588 424 .RS 4 589 425 Execute an AddPrinterDriver() RPC to install the printer driver information on the server\&. Note that the driver files should already exist in the directory returned by 590 \FCgetdriverdir\F[]\&. Possible values for426 getdriverdir\&. Possible values for 591 427 \fIarch\fR 592 428 are the same as those for the 593 \FCgetdriverdir\F[] 429 getdriverdir 594 430 command\&. The 595 431 \fIconfig\fR … … 599 435 .RS 4 600 436 .\} 601 .fam C602 .ps -1603 437 .nf 604 .if t \{\605 .sp -1606 .\}607 .BB lightgray adjust-for-leading-newline608 .sp -1609 610 438 Long Printer Name:\e 611 439 Driver File Name:\e … … 616 444 Default Data Type:\e 617 445 Comma Separated list of Files 618 .EB lightgray adjust-for-leading-newline619 .if t \{\620 .sp 1621 .\}622 446 .fi 623 .fam624 .ps +1625 447 .if n \{\ 626 448 .RE … … 639 461 .RS 4 640 462 Add a printer on the remote server\&. This printer will be automatically shared\&. Be aware that the printer driver must already be installed on the server (see 641 \FCadddriver\F[]) and the463 adddriver) and the 642 464 \fIport\fRmust be a valid port name (see 643 \FCenumports\F[]\&.465 enumports\&. 644 466 .RE 645 467 .PP … … 692 514 .RS 4 693 515 Retrieve the data for a given printer setting\&. See the 694 \FCenumdata\F[] 516 enumdata 695 517 command for more information\&. This command corresponds to the GetPrinterData() MS Platform SDK function\&. 696 518 .RE … … 733 555 .sp 734 556 See also the 735 \FCenumprinters\F[] 557 enumprinters 736 558 and 737 \FCenumdrivers\F[] 559 enumdrivers 738 560 commands for obtaining a list of of installed printers and drivers\&. 739 561 .RE … … 824 646 .RS 4 825 647 Exit 826 \FCrpcclient \F[]\&.648 rpcclient\&. 827 649 .RE 828 650 .SH "BUGS" 829 651 .PP 830 \FCrpcclient\F[] 652 rpcclient 831 653 is designed as a developer testing tool and may not be robust in certain areas (such as command line parsing)\&. It has been known to generate a core dump upon failures when invalid parameters where passed to the interpreter\&. 832 654 .PP
Note:
See TracChangeset
for help on using the changeset viewer.