Changeset 39 for trunk/samba/docs/manpages/rpcclient.1
- Timestamp:
- May 27, 2007, 12:26:26 AM (18 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/samba/docs/manpages/rpcclient.1
r26 r39 19 19 .. 20 20 .TH "RPCCLIENT" 1 "" "" "" 21 .SH NAME22 rpcclient \- tool for executing client side MS-RPC functions21 .SH "NAME" 22 rpcclient - tool for executing client side MS-RPC functions 23 23 .SH "SYNOPSIS" 24 .ad l25 .hy 026 24 .HP 10 27 \fBrpcclient\fR [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-N] [\-I\ destinationIP] {server} 28 .ad 29 .hy 30 25 \fBrpcclient\fR [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logdir] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server} 31 26 .SH "DESCRIPTION" 32 33 .PP 34 This tool is part of the \fBsamba\fR(7) suite\&. 35 36 .PP 37 \fBrpcclient\fR 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\&.38 27 .PP 28 This tool is part of the 29 \fBsamba\fR(7) 30 suite. 31 .PP 32 \fBrpcclient\fR 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. 39 34 .SH "OPTIONS" 40 41 .TP 35 .PP 42 36 server 43 NetBIOS name of Server to which to connect\&. The server can be any SMB/CIFS server\&. The name is resolved using the name resolve order line from \fBsmb\&.conf\fR(5)\&. 44 45 .TP 46 \-c|\-\-command='command string' 37 .RS 3n 38 NetBIOS name of Server to which to connect. The server can be any SMB/CIFS server. The name is resolved using the 39 name resolve order line from 40 \fBsmb.conf\fR(5). 41 .RE 42 .PP 43 -c|--command='command string' 44 .RS 3n 47 45 execute semicolon separated commands (listed below)) 48 49 .TP 50 \-I IP\-address 51 \fIIP address\fR is the address of the server to connect to\&. It should be specified in standard "a\&.b\&.c\&.d" notation\&. 52 53 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 \fIname resolve order\fR 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\&. 54 55 There is no default for this parameter\&. If not supplied, it will be determined automatically by the client as described above\&. 56 57 .TP 58 \-V 59 Prints the program version number\&. 60 61 .TP 62 \-s <configuration file> 63 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 \fIsmb\&.conf\fR for more information\&. The default configuration file name is determined at compile time\&. 64 65 .TP 66 \-d|\-\-debuglevel=level 67 \fIlevel\fR is an integer from 0 to 10\&. The default value if this parameter is not specified is zero\&. 68 69 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\&. 70 71 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\&. 72 73 Note that specifying this parameter here will override the parameter in the \fIsmb\&.conf\fR file\&. 74 75 .TP 76 \-l|\-\-logfile=logdirectory 77 Base directory name for log/debug files\&. The extension \fB"\&.progname"\fR will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&. 78 79 .TP 80 \-N 81 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\&. 82 83 Unless a password is specified on the command line or this parameter is specified, the client will request a password\&. 84 85 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\&. 86 87 .TP 88 \-k 89 Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&. 90 91 .TP 92 \-A|\-\-authentication\-file=filename 93 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 94 95 46 .RE 47 .PP 48 -I IP-address 49 .RS 3n 50 \fIIP address\fR 51 is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation. 52 .sp 53 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 54 \fIname resolve order\fR 55 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. 56 .sp 57 There is no default for this parameter. If not supplied, it will be determined automatically by the client as described above. 58 .RE 59 .PP 60 -V 61 .RS 3n 62 Prints the program version number. 63 .RE 64 .PP 65 -s <configuration file> 66 .RS 3n 67 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 68 \fIsmb.conf\fR 69 for more information. The default configuration file name is determined at compile time. 70 .RE 71 .PP 72 -d|--debuglevel=level 73 .RS 3n 74 \fIlevel\fR 75 is an integer from 0 to 10. The default value if this parameter is not specified is zero. 76 .sp 77 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. 78 .sp 79 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. 80 .sp 81 Note that specifying this parameter here will override the 82 83 parameter in the 84 \fIsmb.conf\fR 85 file. 86 .RE 87 .PP 88 -l|--logfile=logdirectory 89 .RS 3n 90 Base directory name for log/debug files. The extension 91 \fB".progname"\fR 92 will be appended (e.g. log.smbclient, log.smbd, etc...). The log file is never removed by the client. 93 .RE 94 .PP 95 -N 96 .RS 3n 97 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. 98 .sp 99 Unless a password is specified on the command line or this parameter is specified, the client will request a password. 100 .sp 101 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. 102 .RE 103 .PP 104 -k 105 .RS 3n 106 Try to authenticate with kerberos. Only useful in an Active Directory environment. 107 .RE 108 .PP 109 -A|--authentication-file=filename 110 .RS 3n 111 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 112 .sp 113 114 .sp 96 115 97 116 .nf … … 103 122 .fi 104 123 105 106 Make certain that the permissions on the file restrict access from unwanted users\&. 107 108 .TP 109 \-U|\-\-user=username[%password] 110 Sets the SMB username or username and password\&. 111 112 If %password is not specified, the user will be prompted\&. The client will first check the \fBUSER\fR environment variable, then the \fBLOGNAME\fR variable and if either exists, the string is uppercased\&. If these environmental variables are not found, the username \fBGUEST\fR is used\&. 113 114 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 \fI\-A\fR for more details\&. 115 116 Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the \fBps\fR command\&. To be safe always allow \fBrpcclient\fR to prompt for a password and type it in directly\&. 117 118 .TP 119 \-n <primary NetBIOS name> 120 This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the parameter in the \fIsmb\&.conf\fR file\&. However, a command line setting will take precedence over settings in \fIsmb\&.conf\fR\&. 121 122 .TP 123 \-i <scope> 124 This specifies a NetBIOS scope that \fBnmblookup\fR 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 \fBvery\fR rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with\&. 125 126 .TP 127 \-W|\-\-workgroup=domain 128 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)\&. 129 130 .TP 131 \-O socket options 132 TCP socket options to set on the client socket\&. See the socket options parameter in the \fIsmb\&.conf\fR manual page for the list of valid options\&. 133 134 .TP 135 \-h|\-\-help 136 Print a summary of command line options\&. 137 124 .sp 125 Make certain that the permissions on the file restrict access from unwanted users. 126 .RE 127 .PP 128 -U|--user=username[%password] 129 .RS 3n 130 Sets the SMB username or username and password. 131 .sp 132 If %password is not specified, the user will be prompted. The client will first check the 133 \fBUSER\fR 134 environment variable, then the 135 \fBLOGNAME\fR 136 variable and if either exists, the string is uppercased. If these environmental variables are not found, the username 137 \fBGUEST\fR 138 is used. 139 .sp 140 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 141 \fI-A\fR 142 for more details. 143 .sp 144 Be cautious about including passwords in scripts. Also, on many systems the command line of a running process may be seen via the 145 \fBps\fR 146 command. To be safe always allow 147 \fBrpcclient\fR 148 to prompt for a password and type it in directly. 149 .RE 150 .PP 151 -n <primary NetBIOS name> 152 .RS 3n 153 This option allows you to override the NetBIOS name that Samba uses for itself. This is identical to setting the 154 155 parameter in the 156 \fIsmb.conf\fR 157 file. However, a command line setting will take precedence over settings in 158 \fIsmb.conf\fR. 159 .RE 160 .PP 161 -i <scope> 162 .RS 3n 163 This specifies a NetBIOS scope that 164 \fBnmblookup\fR 165 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 166 \fBvery\fR 167 rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with. 168 .RE 169 .PP 170 -W|--workgroup=domain 171 .RS 3n 172 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). 173 .RE 174 .PP 175 -O socket options 176 .RS 3n 177 TCP socket options to set on the client socket. See the socket options parameter in the 178 \fIsmb.conf\fR 179 manual page for the list of valid options. 180 .RE 181 .PP 182 -h|--help 183 .RS 3n 184 Print a summary of command line options. 185 .RE 138 186 .SH "COMMANDS" 139 140 187 .SS "LSARPC" 141 142 .TP 188 .PP 143 189 lsaquery 190 .RS 3n 144 191 Query info policy 145 146 . TP192 .RE 193 .PP 147 194 lookupsids 148 Resolve a list of SIDs to usernames\&. 149 150 .TP 195 .RS 3n 196 Resolve a list of SIDs to usernames. 197 .RE 198 .PP 151 199 lookupnames 152 Resolve a list of usernames to SIDs\&. 153 154 .TP 200 .RS 3n 201 Resolve a list of usernames to SIDs. 202 .RE 203 .PP 155 204 enumtrusts 205 .RS 3n 156 206 Enumerate trusted domains 157 158 . TP207 .RE 208 .PP 159 209 enumprivs 210 .RS 3n 160 211 Enumerate privileges 161 162 . TP212 .RE 213 .PP 163 214 getdispname 215 .RS 3n 164 216 Get the privilege name 165 166 . TP217 .RE 218 .PP 167 219 lsaenumsid 220 .RS 3n 168 221 Enumerate the LSA SIDS 169 170 . TP222 .RE 223 .PP 171 224 lsaenumprivsaccount 225 .RS 3n 172 226 Enumerate the privileges of an SID 173 174 . TP227 .RE 228 .PP 175 229 lsaenumacctrights 230 .RS 3n 176 231 Enumerate the rights of an SID 177 178 . TP232 .RE 233 .PP 179 234 lsaenumacctwithright 235 .RS 3n 180 236 Enumerate accounts with a right 181 182 . TP237 .RE 238 .PP 183 239 lsaaddacctrights 240 .RS 3n 184 241 Add rights to an account 185 186 . TP242 .RE 243 .PP 187 244 lsaremoveacctrights 245 .RS 3n 188 246 Remove rights from an account 189 190 . TP247 .RE 248 .PP 191 249 lsalookupprivvalue 250 .RS 3n 192 251 Get a privilege value given its name 193 194 . TP252 .RE 253 .PP 195 254 lsaquerysecobj 255 .RS 3n 196 256 Query LSA security object 197 257 .RE 198 258 .SS "LSARPC-DS" 199 200 .TP 259 .PP 201 260 dsroledominfo 261 .RS 3n 202 262 Get Primary Domain Information 203 204 .PP 205 263 .RE 264 .PP 206 265 207 266 .PP 208 267 \fBDFS\fR 209 210 .TP 268 .PP 211 269 dfsexist 270 .RS 3n 212 271 Query DFS support 213 214 . TP272 .RE 273 .PP 215 274 dfsadd 275 .RS 3n 216 276 Add a DFS share 217 218 . TP277 .RE 278 .PP 219 279 dfsremove 280 .RS 3n 220 281 Remove a DFS share 221 222 . TP282 .RE 283 .PP 223 284 dfsgetinfo 285 .RS 3n 224 286 Query DFS share info 225 226 . TP287 .RE 288 .PP 227 289 dfsenum 290 .RS 3n 228 291 Enumerate dfs shares 229 292 .RE 230 293 .SS "REG" 231 232 .TP 294 .PP 233 295 shutdown 296 .RS 3n 234 297 Remote Shutdown 235 236 . TP298 .RE 299 .PP 237 300 abortshutdown 301 .RS 3n 238 302 Abort Shutdown 239 303 .RE 240 304 .SS "SRVSVC" 241 242 .TP 305 .PP 243 306 srvinfo 307 .RS 3n 244 308 Server query info 245 246 . TP309 .RE 310 .PP 247 311 netshareenum 312 .RS 3n 248 313 Enumerate shares 249 250 . TP314 .RE 315 .PP 251 316 netfileenum 317 .RS 3n 252 318 Enumerate open files 253 254 . TP319 .RE 320 .PP 255 321 netremotetod 322 .RS 3n 256 323 Fetch remote time of day 257 324 .RE 258 325 .SS "SAMR" 259 260 .TP 326 .PP 261 327 queryuser 328 .RS 3n 262 329 Query user info 263 264 . TP330 .RE 331 .PP 265 332 querygroup 333 .RS 3n 266 334 Query group info 267 268 . TP335 .RE 336 .PP 269 337 queryusergroups 338 .RS 3n 270 339 Query user groups 271 272 . TP340 .RE 341 .PP 273 342 querygroupmem 343 .RS 3n 274 344 Query group membership 275 276 . TP345 .RE 346 .PP 277 347 queryaliasmem 348 .RS 3n 278 349 Query alias membership 279 280 . TP350 .RE 351 .PP 281 352 querydispinfo 353 .RS 3n 282 354 Query display info 283 284 . TP355 .RE 356 .PP 285 357 querydominfo 358 .RS 3n 286 359 Query domain info 287 288 . TP360 .RE 361 .PP 289 362 enumdomusers 363 .RS 3n 290 364 Enumerate domain users 291 292 . TP365 .RE 366 .PP 293 367 enumdomgroups 368 .RS 3n 294 369 Enumerate domain groups 295 296 . TP370 .RE 371 .PP 297 372 enumalsgroups 373 .RS 3n 298 374 Enumerate alias groups 299 300 . TP375 .RE 376 .PP 301 377 createdomuser 378 .RS 3n 302 379 Create domain user 303 304 . TP380 .RE 381 .PP 305 382 samlookupnames 383 .RS 3n 306 384 Look up names 307 308 . TP385 .RE 386 .PP 309 387 samlookuprids 388 .RS 3n 310 389 Look up names 311 312 . TP390 .RE 391 .PP 313 392 deletedomuser 393 .RS 3n 314 394 Delete domain user 315 316 . TP395 .RE 396 .PP 317 397 samquerysecobj 398 .RS 3n 318 399 Query SAMR security object 319 320 . TP400 .RE 401 .PP 321 402 getdompwinfo 403 .RS 3n 322 404 Retrieve domain password info 323 324 . TP405 .RE 406 .PP 325 407 lookupdomain 408 .RS 3n 326 409 Look up domain 327 410 .RE 328 411 .SS "SPOOLSS" 329 330 .TP 412 .PP 331 413 adddriver <arch> <config> [<version>] 332 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\fBgetdriverdir\fR\&. Possible values for\fIarch\fR are the same as those for the \fBgetdriverdir\fR command\&. The \fIconfig\fR parameter is defined as follows: 333 334 414 .RS 3n 415 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 416 \fBgetdriverdir\fR. Possible values for 417 \fIarch\fR 418 are the same as those for the 419 \fBgetdriverdir\fR 420 command. The 421 \fIconfig\fR 422 parameter is defined as follows: 423 .sp 424 425 .sp 335 426 336 427 .nf 337 428 338 Long Printer Name:\ \339 Driver File Name:\ \340 Data File Name:\ \341 Config File Name:\ \342 Help File Name:\ \343 Language Monitor Name:\ \344 Default Data Type:\ \429 Long Printer Name:\ 430 Driver File Name:\ 431 Data File Name:\ 432 Config File Name:\ 433 Help File Name:\ 434 Language Monitor Name:\ 435 Default Data Type:\ 345 436 Comma Separated list of Files 346 437 347 438 .fi 348 439 349 350 Any empty fields should be enter as the string "NULL"\&. 351 352 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\&. 353 354 The \fIversion\fR 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\&. 355 356 .TP 440 .sp 441 Any empty fields should be enter as the string "NULL". 442 .sp 443 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. 444 .sp 445 The 446 \fIversion\fR 447 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. 448 .RE 449 .PP 357 450 addprinter <printername> <sharename> <drivername> <port> 358 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 \fBadddriver\fR) and the \fIport\fRmust be a valid port name (see\fBenumports\fR\&. 359 360 .TP 451 .RS 3n 452 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 453 \fBadddriver\fR) and the 454 \fIport\fRmust be a valid port name (see 455 \fBenumports\fR. 456 .RE 457 .PP 361 458 deldriver 362 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\&. 363 364 .TP 459 .RS 3n 460 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. 461 .RE 462 .PP 365 463 deldriverex <driver> [architecture] [version] 366 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\&. 367 368 .TP 464 .RS 3n 465 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. 466 .RE 467 .PP 369 468 enumdata 370 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)\&. 371 372 .TP 469 .RS 3n 470 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). 471 .RE 472 .PP 373 473 enumdataex 474 .RS 3n 374 475 Enumerate printer data for a key 375 376 . TP476 .RE 477 .PP 377 478 enumjobs <printer> 378 List the jobs and status of a given printer\&. This command corresponds to the MS Platform SDK EnumJobs() function 379 380 .TP 479 .RS 3n 480 List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() function 481 .RE 482 .PP 381 483 enumkey 484 .RS 3n 382 485 Enumerate printer keys 383 384 . TP486 .RE 487 .PP 385 488 enumports [level] 386 Executes an EnumPorts() call using the specified info level\&. Currently only info levels 1 and 2 are supported\&. 387 388 .TP 489 .RS 3n 490 Executes an EnumPorts() call using the specified info level. Currently only info levels 1 and 2 are supported. 491 .RE 492 .PP 389 493 enumdrivers [level] 390 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\&. 391 392 .TP 494 .RS 3n 495 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. 496 .RE 497 .PP 393 498 enumprinters [level] 394 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\&. 395 396 .TP 499 .RS 3n 500 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. 501 .RE 502 .PP 397 503 getdata <printername> <valuename;> 398 Retrieve the data for a given printer setting\&. See the \fBenumdata\fR command for more information\&. This command corresponds to the GetPrinterData() MS Platform SDK function\&. 399 400 .TP 504 .RS 3n 505 Retrieve the data for a given printer setting. See the 506 \fBenumdata\fR 507 command for more information. This command corresponds to the GetPrinterData() MS Platform SDK function. 508 .RE 509 .PP 401 510 getdataex 511 .RS 3n 402 512 Get printer driver data with keyname 403 404 . TP513 .RE 514 .PP 405 515 getdriver <printername> 406 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\&. 407 408 .TP 516 .RS 3n 517 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. 518 .RE 519 .PP 409 520 getdriverdir <arch> 410 Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture\&. Possible values for \fIarch\fR are "Windows 4\&.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000"\&. 411 412 .TP 521 .RS 3n 522 Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture. Possible values for 523 \fIarch\fR 524 are "Windows 4.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000". 525 .RE 526 .PP 413 527 getprinter <printername> 414 Retrieve the current printer information\&. This command corresponds to the GetPrinter() MS Platform SDK function\&. 415 416 .TP 528 .RS 3n 529 Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function. 530 .RE 531 .PP 417 532 getprintprocdir 533 .RS 3n 418 534 Get print processor directory 419 420 . TP535 .RE 536 .PP 421 537 openprinter <printername> 422 Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer\&. 423 424 .TP 538 .RS 3n 539 Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer. 540 .RE 541 .PP 425 542 setdriver <printername> <drivername> 426 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\&. 427 428 See also the \fBenumprinters\fR and\fBenumdrivers\fR commands for obtaining a list of of installed printers and drivers\&. 429 430 .TP 543 .RS 3n 544 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. 545 .sp 546 See also the 547 \fBenumprinters\fR 548 and 549 \fBenumdrivers\fR 550 commands for obtaining a list of of installed printers and drivers. 551 .RE 552 .PP 431 553 addform 554 .RS 3n 432 555 Add form 433 434 . TP556 .RE 557 .PP 435 558 setform 559 .RS 3n 436 560 Set form 437 438 . TP561 .RE 562 .PP 439 563 getform 564 .RS 3n 440 565 Get form 441 442 . TP566 .RE 567 .PP 443 568 deleteform 569 .RS 3n 444 570 Delete form 445 446 . TP571 .RE 572 .PP 447 573 enumforms 574 .RS 3n 448 575 Enumerate form 449 450 . TP576 .RE 577 .PP 451 578 setprinter 579 .RS 3n 452 580 Set printer comment 453 454 . TP581 .RE 582 .PP 455 583 setprinterdata 584 .RS 3n 456 585 Set REG_SZ printer data 457 458 . TP586 .RE 587 .PP 459 588 setprintername <printername> <newprintername> 589 .RS 3n 460 590 Set printer name 461 462 . TP591 .RE 592 .PP 463 593 rffpcnex 594 .RS 3n 464 595 Rffpcnex test 465 596 .RE 466 597 .SS "NETLOGON" 467 468 .TP 598 .PP 469 599 logonctrl2 600 .RS 3n 470 601 Logon Control 2 471 472 . TP602 .RE 603 .PP 473 604 logonctrl 605 .RS 3n 474 606 Logon Control 475 476 . TP607 .RE 608 .PP 477 609 samsync 610 .RS 3n 478 611 Sam Synchronisation 479 480 . TP612 .RE 613 .PP 481 614 samdeltas 615 .RS 3n 482 616 Query Sam Deltas 483 484 . TP617 .RE 618 .PP 485 619 samlogon 620 .RS 3n 486 621 Sam Logon 487 622 .RE 488 623 .SS "GENERAL COMMANDS" 489 490 .TP 624 .PP 491 625 debuglevel 492 Set the current debug level used to log information\&. 493 494 .TP 626 .RS 3n 627 Set the current debug level used to log information. 628 .RE 629 .PP 495 630 help (?) 496 Print a listing of all known commands or extended help on a particular command\&. 497 498 .TP 631 .RS 3n 632 Print a listing of all known commands or extended help on a particular command. 633 .RE 634 .PP 499 635 quit (exit) 500 Exit \fBrpcclient \fR\&. 501 636 .RS 3n 637 Exit 638 \fBrpcclient \fR. 639 .RE 502 640 .SH "BUGS" 503 504 .PP 505 \fBrpcclient\fR 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\&. 506 641 .PP 642 \fBrpcclient\fR 643 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. 507 644 .PP 508 645 From Luke Leighton's original rpcclient man page: 509 510 .PP 511 \fBWARNING!\fR 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\&. 512 513 .PP 514 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 \fBsmbd\fR(8) and \fBrpcclient\fR(1) 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\&. 515 646 .PP 647 \fBWARNING!\fR 648 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. 649 .PP 650 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 651 \fBsmbd\fR(8) 652 and 653 \fBrpcclient\fR(1) 654 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. 516 655 .SH "VERSION" 517 518 .PP 519 This man page is correct for version 3\&.0 of the Samba suite\&. 520 656 .PP 657 This man page is correct for version 3.0 of the Samba suite. 521 658 .SH "AUTHOR" 522 523 .PP 524 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\&. 525 526 .PP 527 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\&. 528 659 .PP 660 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. 661 .PP 662 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. 663
Note:
See TracChangeset
for help on using the changeset viewer.