Changeset 286 for branches/samba-3.0/docs/manpages/rpcclient.1
- Timestamp:
- Jun 24, 2009, 5:09:21 PM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.0/docs/manpages/rpcclient.1
r158 r286 1 1 .\" Title: rpcclient 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.7 3.2<http://docbook.sf.net/>4 .\" Date: 0 8/25/20082 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 06/22/2009 5 5 .\" Manual: User Commands 6 6 .\" Source: Samba 3.0 7 .\" Language: English 7 8 .\" 8 .TH "RPCCLIENT" "1" "08/25/2008" "Samba 3\.0" "User Commands" 9 .TH "RPCCLIENT" "1" "06/22/2009" "Samba 3\&.0" "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 .. 159 .\" ----------------------------------------------------------------- 160 .\" * set default formatting 161 .\" ----------------------------------------------------------------- 9 162 .\" disable hyphenation 10 163 .nh 11 164 .\" disable justification (adjust text to left margin only) 12 165 .ad l 13 .SH "NAME" 14 rpcclient - tool for executing client side MS-RPC functions 15 .SH "SYNOPSIS" 16 .HP 1 17 rpcclient [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-N] [\-I\ destinationIP] {server} 166 .\" ----------------------------------------------------------------- 167 .\" * MAIN CONTENT STARTS HERE * 168 .\" ----------------------------------------------------------------- 169 .SH "Name" 170 rpcclient \- tool for executing client side MS\-RPC functions 171 .SH "Synopsis" 172 .fam C 173 .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] [\-N] [\-I\ destinationIP] {server} 175 .fam 18 176 .SH "DESCRIPTION" 19 177 .PP 20 178 This tool is part of the 21 179 \fBsamba\fR(7) 22 suite\ .23 .PP 24 rpcclient 25 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\.180 suite\&. 181 .PP 182 \FCrpcclient\F[] 183 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\&. 26 184 .SH "OPTIONS" 27 185 .PP 28 186 server 29 187 .RS 4 30 NetBIOS name of Server to which to connect\ . The server can be any SMB/CIFS server\. The name is resolved using the31 \ fIname resolve order\fR188 NetBIOS name of Server to which to connect\&. The server can be any SMB/CIFS server\&. The name is resolved using the 189 \m[blue]\fBname resolve order\fR\m[] 32 190 line from 33 \fBsmb.conf\fR(5)\ .191 \fBsmb.conf\fR(5)\&. 34 192 .RE 35 193 .PP … … 42 200 .RS 4 43 201 \fIIP address\fR 44 is the address of the server to connect to\ . It should be specified in standard "a\.b\.c\.d" notation\.202 is the address of the server to connect to\&. It should be specified in standard "a\&.b\&.c\&.d" notation\&. 45 203 .sp 46 204 Normally the client would attempt to locate a named SMB/CIFS server by looking it up via the NetBIOS name resolution mechanism described above in the 47 205 \fIname resolve order\fR 48 parameter above\ . Using this parameter will force the client to assume that the server is on the machine with the specified IP address and the NetBIOS name component of the resource being connected to will be ignored\.49 .sp 50 There is no default for this parameter\ . If not supplied, it will be determined automatically by the client as described above\.206 parameter above\&. Using this parameter will force the client to assume that the server is on the machine with the specified IP address and the NetBIOS name component of the resource being connected to will be ignored\&. 207 .sp 208 There is no default for this parameter\&. If not supplied, it will be determined automatically by the client as described above\&. 51 209 .RE 52 210 .PP … … 54 212 .RS 4 55 213 \fIlevel\fR 56 is an integer from 0 to 10\ . The default value if this parameter is not specified is 0\.57 .sp 58 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\.59 .sp 60 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\.214 is an integer from 0 to 10\&. The default value if this parameter is not specified is 0\&. 215 .sp 216 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\&. 217 .sp 218 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\&. 61 219 .sp 62 220 Note that specifying this parameter here will override the 63 \ fIlog level\fR221 \m[blue]\fBlog level\fR\m[] 64 222 parameter in the 65 \ fIsmb\.conf\fR66 file\ .223 \FCsmb\&.conf\F[] 224 file\&. 67 225 .RE 68 226 .PP 69 227 \-V 70 228 .RS 4 71 Prints the program version number\ .229 Prints the program version number\&. 72 230 .RE 73 231 .PP 74 232 \-s <configuration file> 75 233 .RS 4 76 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\. See77 \ fIsmb\.conf\fR78 for more information\ . The default configuration file name is determined at compile time\.234 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 235 \FCsmb\&.conf\F[] 236 for more information\&. The default configuration file name is determined at compile time\&. 79 237 .RE 80 238 .PP 81 239 \-l|\-\-log\-basename=logdirectory 82 240 .RS 4 83 Base directory name for log/debug files\ . The extension84 \fB"\ .progname"\fR85 will be appended (e\ .g\. log\.smbclient, log\.smbd, etc\.\.\.)\. The log file is never removed by the client\.241 Base directory name for log/debug files\&. The extension 242 \fB"\&.progname"\fR 243 will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&. 86 244 .RE 87 245 .PP 88 246 \-N 89 247 .RS 4 90 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\.91 .sp 92 Unless a password is specified on the command line or this parameter is specified, the client will request a password\ .93 .sp 94 If a password is specified on the command line and this option is also defined the password on the command line will be silently ingnored and no password will be used\ .248 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\&. 249 .sp 250 Unless a password is specified on the command line or this parameter is specified, the client will request a password\&. 251 .sp 252 If a password is specified on the command line and this option is also defined the password on the command line will be silently ingnored and no password will be used\&. 95 253 .RE 96 254 .PP 97 255 \-k 98 256 .RS 4 99 Try to authenticate with kerberos\ . Only useful in an Active Directory environment\.257 Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&. 100 258 .RE 101 259 .PP 102 260 \-A|\-\-authentication\-file=filename 103 261 .RS 4 104 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 105 .sp 106 .sp 107 .RS 4 262 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 263 .sp 264 .if n \{\ 265 .RS 4 266 .\} 267 .fam C 268 .ps -1 108 269 .nf 270 .if t \{\ 271 .sp -1 272 .\} 273 .BB lightgray adjust-for-leading-newline 274 .sp -1 275 109 276 username = <value> 110 277 password = <value> 111 278 domain = <value> 279 .EB lightgray adjust-for-leading-newline 280 .if t \{\ 281 .sp 1 282 .\} 112 283 .fi 113 .RE 114 .sp 115 Make certain that the permissions on the file restrict access from unwanted users\. 284 .fam 285 .ps +1 286 .if n \{\ 287 .RE 288 .\} 289 .sp 290 Make certain that the permissions on the file restrict access from unwanted users\&. 116 291 .RE 117 292 .PP 118 293 \-U|\-\-user=username[%password] 119 294 .RS 4 120 Sets the SMB username or username and password\ .121 .sp 122 If %password is not specified, the user will be prompted\ . The client will first check the295 Sets the SMB username or username and password\&. 296 .sp 297 If %password is not specified, the user will be prompted\&. The client will first check the 123 298 \fBUSER\fR 124 299 environment variable, then the 125 300 \fBLOGNAME\fR 126 variable and if either exists, the string is uppercased\ . If these environmental variables are not found, the username301 variable and if either exists, the string is uppercased\&. If these environmental variables are not found, the username 127 302 \fBGUEST\fR 128 is used\ .129 .sp 130 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 the303 is used\&. 304 .sp 305 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 131 306 \fI\-A\fR 132 for more details\ .133 .sp 134 Be cautious about including passwords in scripts\ . Also, on many systems the command line of a running process may be seen via the135 ps 136 command\ . To be safe always allow137 rpcclient 138 to prompt for a password and type it in directly\ .307 for more details\&. 308 .sp 309 Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the 310 \FCps\F[] 311 command\&. To be safe always allow 312 \FCrpcclient\F[] 313 to prompt for a password and type it in directly\&. 139 314 .RE 140 315 .PP 141 316 \-n <primary NetBIOS name> 142 317 .RS 4 143 This option allows you to override the NetBIOS name that Samba uses for itself\ . This is identical to setting the144 \ fInetbios name\fR318 This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the 319 \m[blue]\fBnetbios name\fR\m[] 145 320 parameter in the 146 \ fIsmb\.conf\fR147 file\ . However, a command line setting will take precedence over settings in148 \ fIsmb\.conf\fR\.321 \FCsmb\&.conf\F[] 322 file\&. However, a command line setting will take precedence over settings in 323 \FCsmb\&.conf\F[]\&. 149 324 .RE 150 325 .PP … … 152 327 .RS 4 153 328 This specifies a NetBIOS scope that 154 nmblookup 155 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 are329 \FCnmblookup\F[] 330 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 156 331 \fIvery\fR 157 rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with\ .332 rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with\&. 158 333 .RE 159 334 .PP 160 335 \-W|\-\-workgroup=domain 161 336 .RS 4 162 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)\.337 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)\&. 163 338 .RE 164 339 .PP 165 340 \-O socket options 166 341 .RS 4 167 TCP socket options to set on the client socket\ . See the socket options parameter in the168 \ fIsmb\.conf\fR169 manual page for the list of valid options\ .342 TCP socket options to set on the client socket\&. See the socket options parameter in the 343 \FCsmb\&.conf\F[] 344 manual page for the list of valid options\&. 170 345 .RE 171 346 .PP 172 347 \-h|\-\-help 173 348 .RS 4 174 Print a summary of command line options\ .349 Print a summary of command line options\&. 175 350 .RE 176 351 .SH "COMMANDS" … … 184 359 lookupsids 185 360 .RS 4 186 Resolve a list of SIDs to usernames\ .361 Resolve a list of SIDs to usernames\&. 187 362 .RE 188 363 .PP 189 364 lookupnames 190 365 .RS 4 191 Resolve a list of usernames to SIDs\ .366 Resolve a list of usernames to SIDs\&. 192 367 .RE 193 368 .PP … … 402 577 adddriver <arch> <config> [<version>] 403 578 .RS 4 404 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 by405 getdriverdir\. Possible values for579 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 580 \FCgetdriverdir\F[]\&. Possible values for 406 581 \fIarch\fR 407 582 are the same as those for the 408 getdriverdir 409 command\ . The583 \FCgetdriverdir\F[] 584 command\&. The 410 585 \fIconfig\fR 411 586 parameter is defined as follows: 412 587 .sp 413 .sp 414 .RS 4 588 .if n \{\ 589 .RS 4 590 .\} 591 .fam C 592 .ps -1 415 593 .nf 594 .if t \{\ 595 .sp -1 596 .\} 597 .BB lightgray adjust-for-leading-newline 598 .sp -1 599 416 600 Long Printer Name:\e 417 601 Driver File Name:\e … … 422 606 Default Data Type:\e 423 607 Comma Separated list of Files 608 .EB lightgray adjust-for-leading-newline 609 .if t \{\ 610 .sp 1 611 .\} 424 612 .fi 425 .RE 426 .sp 427 Any empty fields should be enter as the string "NULL"\. 428 .sp 429 Samba does not need to support the concept of Print Monitors since these only apply to local printers whose driver can make use of a bi\-directional link for communication\. This field should be "NULL"\. On a remote NT print server, the Print Monitor for a driver must already be installed prior to adding the driver or else the RPC will fail\. 613 .fam 614 .ps +1 615 .if n \{\ 616 .RE 617 .\} 618 .sp 619 Any empty fields should be enter as the string "NULL"\&. 620 .sp 621 Samba does not need to support the concept of Print Monitors since these only apply to local printers whose driver can make use of a bi\-directional link for communication\&. This field should be "NULL"\&. On a remote NT print server, the Print Monitor for a driver must already be installed prior to adding the driver or else the RPC will fail\&. 430 622 .sp 431 623 The 432 624 \fIversion\fR 433 parameter lets you specify the printer driver version number\ . If omitted, the default driver version for the specified architecture will be used\. This option can be used to upload Windows 2000 (version 3) printer drivers\.625 parameter lets you specify the printer driver version number\&. If omitted, the default driver version for the specified architecture will be used\&. This option can be used to upload Windows 2000 (version 3) printer drivers\&. 434 626 .RE 435 627 .PP 436 628 addprinter <printername> <sharename> <drivername> <port> 437 629 .RS 4 438 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 (see439 adddriver) and the630 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 631 \FCadddriver\F[]) and the 440 632 \fIport\fRmust be a valid port name (see 441 enumports\.633 \FCenumports\F[]\&. 442 634 .RE 443 635 .PP 444 636 deldriver 445 637 .RS 4 446 Delete the specified printer driver for all architectures\ . This does not delete the actual driver files from the server, only the entry from the server\'s list of drivers\.638 Delete the specified printer driver for all architectures\&. This does not delete the actual driver files from the server, only the entry from the server\'s list of drivers\&. 447 639 .RE 448 640 .PP 449 641 deldriverex <driver> [architecture] [version] 450 642 .RS 4 451 Delete the specified printer driver including driver files\ . You can limit this action to a specific architecture and a specific version\. If no architecure is given, all driver files of that driver will be deleted\.643 Delete the specified printer driver including driver files\&. You can limit this action to a specific architecture and a specific version\&. If no architecure is given, all driver files of that driver will be deleted\&. 452 644 .RE 453 645 .PP 454 646 enumdata 455 647 .RS 4 456 Enumerate all printer setting data stored on the server\ . On Windows NT clients, these values are stored in the registry, while Samba servers store them in the printers TDB\. This command corresponds to the MS Platform SDK GetPrinterData() function (* This command is currently unimplemented)\.648 Enumerate all printer setting data stored on the server\&. On Windows NT clients, these values are stored in the registry, while Samba servers store them in the printers TDB\&. This command corresponds to the MS Platform SDK GetPrinterData() function (* This command is currently unimplemented)\&. 457 649 .RE 458 650 .PP … … 464 656 enumjobs <printer> 465 657 .RS 4 466 List the jobs and status of a given printer\ . This command corresponds to the MS Platform SDK EnumJobs() function658 List the jobs and status of a given printer\&. This command corresponds to the MS Platform SDK EnumJobs() function 467 659 .RE 468 660 .PP … … 474 666 enumports [level] 475 667 .RS 4 476 Executes an EnumPorts() call using the specified info level\ . Currently only info levels 1 and 2 are supported\.668 Executes an EnumPorts() call using the specified info level\&. Currently only info levels 1 and 2 are supported\&. 477 669 .RE 478 670 .PP 479 671 enumdrivers [level] 480 672 .RS 4 481 Execute an EnumPrinterDrivers() call\ . This lists the various installed printer drivers for all architectures\. Refer to the MS Platform SDK documentation for more details of the various flags and calling options\. Currently supported info levels are 1, 2, and 3\.673 Execute an EnumPrinterDrivers() call\&. This lists the various installed printer drivers for all architectures\&. Refer to the MS Platform SDK documentation for more details of the various flags and calling options\&. Currently supported info levels are 1, 2, and 3\&. 482 674 .RE 483 675 .PP 484 676 enumprinters [level] 485 677 .RS 4 486 Execute an EnumPrinters() call\ . This lists the various installed and share printers\. Refer to the MS Platform SDK documentation for more details of the various flags and calling options\. Currently supported info levels are 1, 2 and 5\.678 Execute an EnumPrinters() call\&. This lists the various installed and share printers\&. Refer to the MS Platform SDK documentation for more details of the various flags and calling options\&. Currently supported info levels are 1, 2 and 5\&. 487 679 .RE 488 680 .PP 489 681 getdata <printername> <valuename;> 490 682 .RS 4 491 Retrieve the data for a given printer setting\ . See the492 enumdata 493 command for more information\ . This command corresponds to the GetPrinterData() MS Platform SDK function\.683 Retrieve the data for a given printer setting\&. See the 684 \FCenumdata\F[] 685 command for more information\&. This command corresponds to the GetPrinterData() MS Platform SDK function\&. 494 686 .RE 495 687 .PP … … 501 693 getdriver <printername> 502 694 .RS 4 503 Retrieve the printer driver information (such as driver file, config file, dependent files, etc\ .\.\.) for the given printer\. This command corresponds to the GetPrinterDriver() MS Platform SDK function\. Currently info level 1, 2, and 3 are supported\.695 Retrieve the printer driver information (such as driver file, config file, dependent files, etc\&.\&.\&.) for the given printer\&. This command corresponds to the GetPrinterDriver() MS Platform SDK function\&. Currently info level 1, 2, and 3 are supported\&. 504 696 .RE 505 697 .PP 506 698 getdriverdir <arch> 507 699 .RS 4 508 Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture\ . Possible values for700 Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture\&. Possible values for 509 701 \fIarch\fR 510 are "Windows 4\ .0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000"\.702 are "Windows 4\&.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000"\&. 511 703 .RE 512 704 .PP 513 705 getprinter <printername> 514 706 .RS 4 515 Retrieve the current printer information\ . This command corresponds to the GetPrinter() MS Platform SDK function\.707 Retrieve the current printer information\&. This command corresponds to the GetPrinter() MS Platform SDK function\&. 516 708 .RE 517 709 .PP … … 523 715 openprinter <printername> 524 716 .RS 4 525 Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer\ .717 Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer\&. 526 718 .RE 527 719 .PP 528 720 setdriver <printername> <drivername> 529 721 .RS 4 530 Execute a SetPrinter() command to update the printer driver associated with an installed printer\ . The printer driver must already be correctly installed on the print server\.722 Execute a SetPrinter() command to update the printer driver associated with an installed printer\&. The printer driver must already be correctly installed on the print server\&. 531 723 .sp 532 724 See also the 533 enumprinters 725 \FCenumprinters\F[] 534 726 and 535 enumdrivers 536 commands for obtaining a list of of installed printers and drivers\ .727 \FCenumdrivers\F[] 728 commands for obtaining a list of of installed printers and drivers\&. 537 729 .RE 538 730 .PP … … 611 803 debuglevel 612 804 .RS 4 613 Set the current debug level used to log information\ .805 Set the current debug level used to log information\&. 614 806 .RE 615 807 .PP 616 808 help (?) 617 809 .RS 4 618 Print a listing of all known commands or extended help on a particular command\ .810 Print a listing of all known commands or extended help on a particular command\&. 619 811 .RE 620 812 .PP … … 622 814 .RS 4 623 815 Exit 624 rpcclient\.816 \FCrpcclient \F[]\&. 625 817 .RE 626 818 .SH "BUGS" 627 819 .PP 628 rpcclient 629 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\.820 \FCrpcclient\F[] 821 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\&. 630 822 .PP 631 823 From Luke Leighton\'s original rpcclient man page: 632 824 .PP 633 825 \fIWARNING!\fR 634 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 SMB works, or how the individual MSRPC services work\. Microsoft\'s implementation of these services has been demonstrated (and reported) to be\.\.\. a bit flaky in places\.826 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 SMB works, or how the individual MSRPC services work\&. Microsoft\'s implementation of these services has been demonstrated (and reported) to be\&.\&.\&. a bit flaky in places\&. 635 827 .PP 636 828 The development of Samba\'s implementation is also a bit rough, and as more of the services are understood, it can even result in versions of … … 638 830 and 639 831 \fBrpcclient\fR(1) 640 that are incompatible for some commands or services\ . Additionally, the developers are sending reports to Microsoft, and problems found or reported to Microsoft are fixed in Service Packs, which may result in incompatibilities\.832 that are incompatible for some commands or services\&. Additionally, the developers are sending reports to Microsoft, and problems found or reported to Microsoft are fixed in Service Packs, which may result in incompatibilities\&. 641 833 .SH "VERSION" 642 834 .PP 643 This man page is correct for version 3\ .0 of the Samba suite\.835 This man page is correct for version 3\&.0 of the Samba suite\&. 644 836 .SH "AUTHOR" 645 837 .PP 646 The original Samba software and related utilities were created by Andrew Tridgell\ . Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\.647 .PP 648 The original rpcclient man page was written by Matthew Geddes, Luke Kenneth Casson Leighton, and rewritten by Gerald Carter\ . The conversion to DocBook for Samba 2\.2 was done by Gerald Carter\. The conversion to DocBook XML 4\.2 for Samba 3\.0 was done by Alexander Bokovoy\.838 The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&. 839 .PP 840 The original rpcclient man page was written by Matthew Geddes, Luke Kenneth Casson Leighton, and rewritten by Gerald Carter\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
Note:
See TracChangeset
for help on using the changeset viewer.