From 27aef6855f1543547b8190f06fd264d1b52a558d Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sun, 6 Apr 2003 18:42:44 +0000 Subject: Regenerate docs (This used to be commit 5a2aaa3d5b039776314067aee953921e7865dc4d) --- docs/htmldocs/rpcclient.1.html | 1041 ++++++++++++++++++++++++++++------------ 1 file changed, 726 insertions(+), 315 deletions(-) (limited to 'docs/htmldocs/rpcclient.1.html') diff --git a/docs/htmldocs/rpcclient.1.html b/docs/htmldocs/rpcclient.1.html index 6e71ddeb14..02c66ff7a4 100644 --- a/docs/htmldocs/rpcclient.1.html +++ b/docs/htmldocs/rpcclient.1.html @@ -99,36 +99,66 @@ CLASS="REFENTRYTITLE" >.

-A|--authfile=filename
-c|--command='command string'

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 -

execute semicolon separated commands (listed + below))

-I IP-address

username = <value> 
-password = <value>
-domain   = <value>

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

Make certain that the permissions on the file restrict - access from unwanted users.

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 name resolve order + 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.

There is no default for this parameter. If not supplied, + it will be determined automatically by the client as described + above.

-c|--command='command string'
-V

execute semicolon separated commands (listed - below))

Prints the version number for +smbd.

-h|--help
-s <configuration file>

Print a summary of command line options.

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 smb.conf(5) for more information. +The default configuration file name is determined at +compile time.

-d|--debug=debuglevel
file.

-I IP-address
-l|--logfile=logbasename

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 - SMB/CIFS server by looking it up via the NetBIOS name resolution - mechanism described above in the name resolve order - 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.

There is no default for this parameter. If not supplied, - it will be determined automatically by the client as described - above.

File name for log/debug files. The extension +".client" will be appended. The log file is +never removed by the client.

-l|--logfile=logbasename
-N

File name for log/debug files. The extension - '.client' will be appended. The log file is - never removed by the client. -

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.

Unless a password is specified on the command line or +this parameter is specified, the client will request a +password.

-N|--nopass
-k

instruct rpcclient not to ask - for a password. By default, rpcclient will - prompt for a password. See also the -U - option.

Try to authenticate with kerberos. Only useful in +an Active Directory environment.

-s|--conf=smb.conf
-A|--authfile=filename

Specifies the location of the all-important - smb.conf file.

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

username = <value>
+password = <value>
+domain   = <value>

Make certain that the permissions on the file restrict +access from unwanted users.

-U|--user=username[%password]

Sets the SMB username or username and password.

If %password is not specified, the user will be prompted. The - client will first check the If %password is not specified, the user will be prompted. The +client will first check the USER environment variable, then the - environment variable, then the +LOGNAME variable and if either exists, the - string is uppercased. If these environmental variables are not - found, the username variable and if either exists, the +string is uppercased. If these environmental variables are not +found, the username GUEST is used.

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 - 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 +-A for more details.

Be cautious about including passwords in scripts. Also, on - many systems the command line of a running process may be seen - via the Be cautious about including passwords in scripts. Also, on +many systems the command line of a running process may be seen +via the ps command. To be safe always allow - command. To be safe always allow +rpcclient to prompt for a password and type - it in directly.

to prompt for a password and type +it in directly.

-n <primary NetBIOS name>

This option allows you to override +the NetBIOS name that Samba uses for itself. This is identical +to setting the NetBIOS +name parameter in the smb.conf(5) file. However, a command +line setting will take precedence over settings in +smb.conf(5).

-i <scope>

This specifies a NetBIOS scope that +nmblookup 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 +very rarely used, only set this parameter +if you are the system administrator in charge of all the +NetBIOS systems you communicate with.

-W|--workgroup=domain

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 server's NetBIOS name, - it causes the client to log on using the server's local SAM (as - opposed to the Domain SAM).

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).

-O socket options

TCP socket options to set on the client +socket. See the socket options parameter in +the smb.conf(5) manual page for the list of valid +options.

-h|--help

Print a summary of command line options.

COMMANDS

LSARPC

LSARPC

  • lsaquery

    lsaquery

  • Query info policy

    lookupsids

    lookupsids - Resolve a list +>Resolve a list of SIDs to usernames.

  • lookupnames

    lookupnames - Resolve a list +>Resolve a list of usernames to SIDs.

  • enumtrusts

    Enumerate trusted domains

    enumprivs

    Enumerate privileges

    getdispname

    Get the privilege name

    lsaenumsid

    Enumerate the LSA SIDS

    lsaenumprivsaccount

    Enumerate the privileges of an SID

    lsaenumacctrights

    Enumerate the rights of an SID

    lsaenumacctwithright

    Enumerate accounts with a right

    lsaaddacctrights

    Add rights to an account

    lsaremoveacctrights

    Remove rights from an account

    lsalookupprivvalue

    Get a privilege value given its name

    lsaquerysecobj

    Query LSA security object

LSARPC-DS

enumtrusts

dsroledominfo

Get Primary Domain Information

SAMRDFS

  • dfsexist

    Query DFS support

    dfsadd

    Add a DFS share

    dfsremove

    Remove a DFS share

    dfsgetinfo

    Query DFS share info

    dfsenum

    Enumerate dfs shares

REG

queryuser

  • shutdown

    Remote Shutdown

    abortshutdown

    Abort Shutdown

    • SRVSVC

    srvinfo

    Server query info

    netshareenum

    Enumerate shares

    netfileenum

    Enumerate open files

    netremotetod

    Fetch remote time of day

    SAMR

    querygroup

  • queryuser

    Query user info

    querygroup

    Query group info

    queryusergroups

    Query user groups

    querygroupmem

    Query group membership

    queryaliasmem

    Query alias membership

    querydispinfo

    Query display info

    querydominfo

    Query domain info

    enumdomusers

    queryusergroups

  • Enumerate domain users

    enumdomgroups

    querygroupmem

  • Enumerate domain groups

    enumalsgroups

    queryaliasmem

  • Enumerate alias groups

    createdomuser

    querydispinfo

  • Create domain user

    samlookupnames

    querydominfo

  • Look up names

    samlookuprids

    enumdomgroups

    • Look up names

    deletedomuser

    Delete domain user

    samquerysecobj

    SPOOLSS

    Query SAMR security object

    getdompwinfo

    Retrieve domain password info

    SPOOLSS

    • adddriver <arch> <config>

      adddriver <arch> <config> - - Execute an AddPrinterDriver() RPC to install the printer driver +> 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

    • addprinter <printername> - <sharename> <drivername> <port> - - Add a printer on the remote server. This printer + <sharename> <drivername> <port>

      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 enumports.

    • deldriver

      deldriver - Delete the +>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.

    • enumdata

      enumdata - Enumerate all +>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).

    • enumdataex

      enumjobs <printer> - - List the jobs and status of a given printer. +>Enumerate printer data for a key

      enumjobs <printer>

      List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() - function (* This command is currently unimplemented).

    • enumkey

      enumports [level] - - Executes an EnumPorts() call using the specified +>Enumerate printer keys

      enumports [level]

      Executes an EnumPorts() call using the specified info level. Currently only info levels 1 and 2 are supported.

    • enumdrivers [level]

      enumdrivers [level] - - Execute an EnumPrinterDrivers() call. This lists the various installed +> 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.

    • enumprinters [level]

      enumprinters [level] - - Execute an EnumPrinters() call. This lists the various installed +>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 0, 1, and 2.

    • getdata <printername> <valuename;>

      getdata <printername> - - Retrieve the data for a given printer setting. See +>Retrieve the data for a given printer setting. See the enumdata command for more information. This command corresponds to the GetPrinterData() MS Platform - SDK function (* This command is currently unimplemented).

    • getdataex

      getdriver <printername> - - Retrieve the printer driver information (such as driver file, +>Get printer driver data with keyname

      getdriver <printername>

      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.

    • getdriverdir <arch>

      getdriverdir <arch> - - Execute a GetPrinterDriverDirectory() +> Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture. Possible values for are "Windows 4.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000".

    • getprinter <printername>

      getprinter <printername> - - Retrieve the current printer information. This command +>Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function.

    • getprintprocdir

      openprinter <printername> - - Execute an OpenPrinterEx() and ClosePrinter() RPC - against a given printer.

    • Get print processor directory

      openprinter <printername>

      Execute an OpenPrinterEx() and ClosePrinter() RPC + against a given printer.

      setdriver <printername> - <drivername> - - Execute a SetPrinter() command to update the printer driver + <drivername>

      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.

      enumdrivers commands for obtaining a list of of installed printers and drivers.

    addform

    Add form

    setform

    Set form

    getform

    Get form

    deleteform

    Delete form

    enumforms

    Enumerate form

    setprinter

    Set printer comment

    setprinterdata

    Set REG_SZ printer data

    rffpcnex

    Rffpcnex test

    NETLOGON

    GENERAL OPTIONS

    logonctrl2

    Logon Control 2

    logonctrl

    Logon Control

    samsync

    Sam Synchronisation

    samdeltas

    Query Sam Deltas

    samlogon

    Sam Logon

    GENERAL COMMANDS

    • debuglevel

      debuglevel - Set the current +>Set the current debug level used to log information.

    • help (?)

      help (?) - Print a listing of all +>Print a listing of all known commands or extended help on a particular command.

    • quit (exit)

      quit (exit) - Exit Exit rpcclient .

    BUGS

    VERSION

    AUTHOR