diff options
| author | Andrew Tridgell <tridge@samba.org> | 1999-12-13 13:35:20 +0000 | 
|---|---|---|
| committer | Andrew Tridgell <tridge@samba.org> | 1999-12-13 13:35:20 +0000 | 
| commit | 32a965e09ce4befe971855e11e1fb5ceb51a9ed1 (patch) | |
| tree | 157f164263a56d7e3f2ca1fe9a05a9df24f25234 /docs/manpages | |
| parent | 3db52feb1f3b2c07ce0b06ad4a7099fa6efe3fc7 (diff) | |
| download | samba-32a965e09ce4befe971855e11e1fb5ceb51a9ed1.tar.gz samba-32a965e09ce4befe971855e11e1fb5ceb51a9ed1.tar.bz2 samba-32a965e09ce4befe971855e11e1fb5ceb51a9ed1.zip  | |
2nd phase of head branch sync with SAMBA_2_0 - this delets all the files that were in the head branch but weren't in SAMBA_2_0
(This used to be commit d7b208786590b5a28618590172b8d523627dda09)
Diffstat (limited to 'docs/manpages')
| -rw-r--r-- | docs/manpages/debug2html.1 | 54 | ||||
| -rw-r--r-- | docs/manpages/rpcclient.1 | 809 | 
2 files changed, 0 insertions, 863 deletions
diff --git a/docs/manpages/debug2html.1 b/docs/manpages/debug2html.1 deleted file mode 100644 index a1071cfd88..0000000000 --- a/docs/manpages/debug2html.1 +++ /dev/null @@ -1,54 +0,0 @@ -.TH "debug2html" "1" "29 Dec 1998" "Samba" "SAMBA"  -.PP  -.SH "NAME"  -debug2html \- Samba DEBUG to HTML translation filter -.PP  -.SH "SYNOPSIS"  -.PP  -debug2html [input-file [output-file]] -.PP  -.SH "DESCRIPTION"  -.PP  -This program is part of the \fBSamba\fP suite\&. -.PP  -\fBdebug2html\fP generates HTML files from Samba log files\&.  Log files -produced by \fBnmbd\fP(8) or \fBsmbd\fP(8) may then be viewed by a web -browser\&.  The output conforms to the HTML 3\&.2 specification\&.  -.PP  -The filenames specified on the command line are optional\&.  If the -output-file is ommitted, output will go to \fBstdout\fP\&.  If the input-file -is ommitted, \fBdebug2html\fP will read from \fBstdin\fP\&.  The filename "-"  -can be used to indicate that input should be read from \fBstdin\fP\&.  For -example: -.PP  -\f(CWcat /usr/local/samba/var/log\&.nmb | debug2html - nmblog\&.html\fP  -.br  -.PP  -.SH "VERSION"  -.PP  -This man page is correct for version 2\&.0 of the Samba suite\&. -.PP  -.SH "SEE ALSO"  -.PP  -\fBnmbd\fP(8), \fBsmbd\fP(8), -\fBsamba\fP(7)\&. -.PP  -.SH "AUTHOR"  -.PP  -The original Samba software and related utilities were created by -Andrew Tridgell \fIsamba-bugs@samba\&.org\fP\&. Samba is now developed -by the Samba Team as an Open Source project similar to the way the -Linux kernel is developed\&. -.PP  -The original Samba man pages were written by Karl Auer\&. The man page -sources were converted to YODL format (another excellent piece of Open -Source software, available at -\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP) -and updated for the Samba2\&.0 release by Jeremy Allison\&. -\fIsamba-bugs@samba\&.org\fP\&. -.PP  -\fBdebug2html\fP was added by Chris Hertel\&. -.PP  -See \fBsamba\fP(7) to find out how to get a full -list of contributors and details on how to submit bug reports, -comments etc\&. diff --git a/docs/manpages/rpcclient.1 b/docs/manpages/rpcclient.1 deleted file mode 100644 index 65517c84fb..0000000000 --- a/docs/manpages/rpcclient.1 +++ /dev/null @@ -1,809 +0,0 @@ -.TH "rpcclient " "1" "23 Oct 1998" "Samba" "SAMBA"  -.PP  -.SH "NAME"  -rpcclient \- utility to manage MSRPC resources on servers -.PP  -.SH "SYNOPSIS"  -.PP  -\fBrpcclient\fP -[password] --S servername -[-U [username][%][password]] -[-W domain] -[-l log basename] -[-d debuglevel] -[-O socket options] -[-i scope] -[-N] -[-n NetBIOS name] -[-h] -[-I dest IP] -[-E] -[-t terminal code] -[-c command string] -[-B IP addr] -[-s smb\&.conf] -[-m max protocol] -.PP  -.SH "DESCRIPTION"  -.PP  -This program is part of the \fBSamba\fP suite\&. -.PP  -\fBrpcclient\fP is a client that can \'talk\' to an SMB/CIFS MSRPC server\&. -Operations include things like managing a SAM Database (users, groups -and aliases) in the same way as the Windows NT programs -\fBUser Manager for Domains\fP and \fBServer Manager for Domains\fP; -managing a remote registry in the same way as the Windows NT programs -\fBREGEDT32\&.EXE\fP and \fBREGEDIT\&.EXE\fP; viewing a remote event log (same -as \fBEVENTVWR\&.EXE\fP) etc\&. -.PP  -Typical usage is like this:  -.br  -\f(CWrpcclient -I 192\&.168\&.32\&.1 -S "*SMBSERVER" -U fred%secret -l log\fP -.br  -.PP  -.SH "OPTIONS"  -.PP  -.IP  -.IP "\fBservername\fP"  -servername is the name of the server you want -to use on the server\&.  This should be the NetBIOS name of the SMB/CIFS -server, which can be \fB*SMBSERVER\fP on Windows NT 4\&.0 or Samba Servers\&. -.IP  -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\&.  Also, remember that having a period in a NetBIOS -name (such as an IP hostname) may cause connectivity problems on your -network: NT tends to strip NetBIOS names from the leading period -onwards\&. -.IP  -The server name is looked up according to either the -\fB-R\fP parameter to \fBrpcclient\fP or using the -\fBname resolve order\fP -parameter in the smb\&.conf file, allowing an administrator to change -the order and methods by which server names are looked up\&. -.IP  -.IP "\fBpassword\fP"  -password is the password required to access the -specified service on the specified server\&. If this parameter is -supplied, the \fB-N\fP option (suppress password prompt) is assumed\&. -.IP  -There is no default password\&. If no password is supplied on the -command line (either by using this parameter or adding a password to -the \fB-U\fP option (see below)) and the \fB-N\fP option is not specified, -the client will prompt for a password, even if the desired service -does not require one\&. (If no password is required, simply press ENTER -to provide a null password\&.) -.IP  -Note: Some servers (including OS/2 and Windows for Workgroups) insist -on an uppercase password\&. Lowercase or mixed case passwords may be -rejected by these servers\&. -.IP  -Be cautious about including passwords in scripts\&. -.IP  -.IP "\fB-s smb\&.conf\fP"  -This parameter specifies the pathname to the -Samba configuration file, smb\&.conf\&. This file controls all aspects of -the Samba setup on the machine and rpcclient also needs to read this -file\&. -.IP  -.IP "\fB-B IP addr\fP"  -The IP address to use when sending a broadcast packet\&. -.IP  -.IP "\fB-O socket options\fP"  -TCP socket options to set on the client -socket\&. See the socket options -parameter in the \fBsmb\&.conf (5)\fP manpage for -the list of valid options\&. -.IP  -.IP "\fB-R name resolve order\fP"  -This option allows the user of -rpcclient to determine what name resolution services to use when -looking up the NetBIOS name of the host being connected to\&. -.IP  -The options are :"lmhosts", "host", "wins" and "bcast"\&. They cause -names to be resolved as follows : -.IP  -.IP  -.IP o  -\fBlmhosts\fP : Lookup an IP address in the Samba lmhosts file\&. -The lmhosts file is stored in the same directory as the -\fBsmb\&.conf\fP file\&. -.IP  -.IP o  -\fBhost\fP : Do a standard host name to IP address resolution, -using the system /etc/hosts, NIS, or DNS lookups\&. This method of name -resolution is operating system depended for instance on IRIX or -Solaris this may be controlled by the \fI/etc/nsswitch\&.conf\fP file)\&.   -.IP  -.IP o  -\fBwins\fP : Query a name with the IP address listed in the \fBwins -server\fP parameter in the smb\&.conf file\&. If  -no WINS server has been specified this method will be ignored\&. -.IP  -.IP o  -\fBbcast\fP : Do a broadcast on each of the known local interfaces -listed in the \fBinterfaces\fP parameter -in the smb\&.conf file\&. This is the least reliable of the name resolution -methods as it depends on the target host being on a locally connected -subnet\&. To specify a particular broadcast address the \fB-B\fP option  -may be used\&. -.IP  -.IP  -If this parameter is not set then the name resolve order defined -in the \fBsmb\&.conf\fP file parameter  -(\fBname resolve order\fP) -will be used\&. -.IP  -The default order is lmhosts, host, wins, bcast and without this -parameter or any entry in the \fB"name resolve -order"\fP parameter of the -\fBsmb\&.conf\fP file the name resolution methods -will be attempted in this order\&. -.IP  -.IP "\fB-i scope\fP"  -This specifies a NetBIOS scope that rpcclient 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 \fIvery\fP rarely used, only set this parameter if you are the -system administrator in charge of all the NetBIOS systems you -communicate with\&. -.IP  -.IP "\fB-N\fP"  -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\&. -.IP  -Unless a password is specified on the command line or this parameter -is specified, the client will request a password\&. -.IP  -.IP "\fB-n NetBIOS name\fP"  -By default, the client will use the local -machine\'s hostname (in uppercase) as its NetBIOS name\&. This parameter -allows you to override the host name and use whatever NetBIOS name you -wish\&. -.IP  -.IP "\fB-d debuglevel\fP"  -debuglevel is an integer from 0 to 10, or the -letter \'A\'\&. -.IP  -The default value if this parameter is not specified is zero\&. -.IP  -The higher this value, the more detail will be logged to the log files -about the activities of the client\&. 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\&. -.IP  -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\&. If debuglevel is set to the -letter \'A\', then \fIall\fP debug messages will be printed\&. This setting -is for developers only (and people who \fIreally\fP want to know how the -code works internally)\&. -.IP  -Note that specifying this parameter here will override the \fBlog -level\fP parameter in the \fBsmb\&.conf -(5)\fP file\&. -.IP  -.IP "\fB-p port\fP"  -This number is the TCP port number that will be used -when making connections to the server\&. The standard (well-known) TCP -port number for an SMB/CIFS server is 139, which is the default\&. -.IP  -.IP "\fB-l logfilename\fP"  -If specified, logfilename specifies a base -filename into which operational data from the running client will be -logged\&. -.IP  -The default base name is specified at compile time\&. -.IP  -The base name is used to generate actual log file names\&. For example, -if the name specified was "log", the debug file would be -\f(CWlog\&.client\fP\&. -.IP  -The log file generated is never removed by the client\&. -.IP  -.IP "\fB-h\fP"  -Print the usage message for the client\&. -.IP  -.IP "\fB-I IP address\fP"  -IP address is the address of the server to -connect to\&. It should be specified in standard "a\&.b\&.c\&.d" notation\&. -.IP  -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 \fBname resolve order\fP 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\&. -.IP  -There is no default for this parameter\&. If not supplied, it will be -determined automatically by the client as described above\&. -.IP  -.IP "\fB-E\fP"  -This parameter causes the client to write messages to the -standard error stream (stderr) rather than to the standard output -stream\&. -.IP  -By default, the client writes messages to standard output - typically -the user\'s tty\&. -.IP  -Note that by default, debug information is always sent to stderr\&. -Debug information can instead be sent to a file, using the --l log basename option\&. -.IP  -.IP "\fB-U username\fP"  -This specifies the user name that will be used by -the client to make a connection, assuming your server is not a downlevel -server that is running a protocol level that uses passwords on shares, -not on usernames\&. -.IP  -Some servers are fussy about the case of this name, and some insist -that it must be a valid NetBIOS name\&. -.IP  -If no username is supplied, it will default to an uppercase version of -the environment variable \f(CWUSER\fP or \f(CWLOGNAME\fP in that order\&.  If no -username is supplied and neither environment variable exists the -username "GUEST" will be used\&. -.IP  -If the \f(CWUSER\fP environment variable contains a \'%\' character, -everything after that will be treated as a password\&. This allows you -to set the environment variable to be \f(CWUSER=username%password\fP so -that a password is not passed on the command line (where it may be -seen by the ps command)\&. -.IP  -If the service you are connecting to requires a password, it can be -supplied using the \fB-U\fP option, by appending a percent symbol ("%") -then the password to username\&.  For example, to attach to a service as -user \f(CW"fred"\fP with password \f(CW"secret"\fP, you would specify\&.  -.br  -.IP  -\f(CW-U fred%secret\fP  -.br  -.IP  -on the command line\&. Note that there are no spaces around the percent -symbol\&. -.IP  -If you specify the password as part of username then the \fB-N\fP option -(suppress password prompt) is assumed\&. -.IP  -If you specify the password as a parameter \fIAND\fP as part of username -then the password as part of username will take precedence\&. Putting -nothing before or nothing after the percent symbol will cause an empty -username or an empty password to be used, respectively\&. -.IP  -The password may also be specified by setting up an environment -variable called \f(CWPASSWORD\fP that contains the users password\&. Note -that this may be very insecure on some systems but on others allows -users to script rpcclient commands without having a password appear in -the command line of a process listing\&. -.IP  -Note: Some servers (including OS/2 and Windows for Workgroups) insist -on an uppercase password\&. Lowercase or mixed case passwords may be -rejected by these servers\&. -.IP  -Be cautious about including passwords in scripts or in the -\f(CWPASSWORD\fP environment variable\&. Also, on many systems the command -line of a running process may be seen via the \f(CWps\fP command to be -safe always allow rpcclient to prompt for a password and type it in -directly\&. -.IP  -.IP "\fB-t terminal code\fP"  -This option tells rpcclient how to interpret -filenames coming from the remote server\&. Usually Asian language -multibyte UNIX implementations use different character sets than -SMB/CIFS servers (\fIEUC\fP instead of \fISJIS\fP for example)\&. Setting -this parameter will let rpcclient convert between the UNIX filenames -and the SMB filenames correctly\&. This option has not been seriously -tested and may have some problems\&. -.IP  -The terminal codes include \f(CWsjis\fP, \f(CWeuc\fP, \f(CWjis7\fP, \f(CWjis8\fP, -\f(CWjunet\fP, \f(CWhex\fP, \f(CWcap\fP\&. This is not a complete list, check the -Samba source code for the complete list\&. -.IP  -.IP "\fB-m max protocol level\fP"  -With the new code in Samba2\&.0, -\fBrpcclient\fP always attempts to connect at the maximum -protocols level the server supports\&. This parameter is -preserved for backwards compatibility, but any string -following the \fB-m\fP will be ignored\&. -.IP  -.IP "\fB-W Domain\fP"  -Override the default Domain, which is the remote server\'s -Domain\&.  This option may be needed to connect to some servers\&.  It is also -possible to specify the remote server name as the Domain, which will -force the username and password to be authenticated against the remote -server\'s local SAM instead of the Domain SAM\&. -.IP  -.IP "\fB-c command string\fP"  -command string is a semicolon separated -list of commands to be executed instead of prompting from stdin\&. -\fB-N\fP is implied by \fB-c\fP\&. -.IP  -This is particularly useful in scripts, e\&.g\&. \f(CW-c \'lsaquery; enumusers -u\'\fP\&. -.IP  -.PP  -.SH "OPERATIONS"  -.PP  -Once the client is running, the user is presented with a prompt : -.PP  -\f(CWsmb:\e>\fP -.PP  -The prompt indicates that the client is ready and waiting to carry out -a user command\&. Each command is a single word, optionally followed by -parameters specific to that command\&. Command and parameters are -space-delimited unless these notes specifically state otherwise\&. All -commands are case-insensitive\&.  Parameters to commands may or may not -be case sensitive, depending on the command\&. -.PP  -You can specify names (e\&.g registry keys; user or group names; -service names) which have spaces in them by quoting the -name with double quotes, for example "dRMON SmartAgent"\&. -.PP  -Parameters shown in square brackets (e\&.g\&., "[parameter]") are -optional\&. If not given, the command will use suitable -defaults\&. Parameters shown in angle brackets (e\&.g\&., "<parameter>") are -required\&. -.PP  -Note that all commands operating on the server are actually performed -by issuing a request to the server\&. Thus the behavior may vary from -server to server, depending on how the server was implemented\&. -.PP  -The commands available are listed in groups relating to different services: -.PP  -.IP  -.IP "Misccellaneous"  -.IP  -.IP  -.IP "\fB? [command]\fP"  -If "command" is specified, -the \fB?\fP command will display a brief informative message about the -specified command\&.  If no command is specified, a list of available -commands will be displayed\&. -.IP  -.IP "\fB! [shell command]\fP"  -If "shell command" -is specified, the \fB!\fP  command will execute a shell locally and run -the specified shell command\&. If no command is specified, a local shell -will be run\&. -.IP  -.IP "\fBexit\fP"  -Terminate the connection with the server and -exit from the program\&. -.IP  -.IP "\fBhelp [command]\fP"  -See the \fB?\fP -command above\&. -.IP  -.IP "\fBquit\fP"  -See the \fBexit\fP command\&. -.IP  -.IP  -.IP "Event Log"  -.IP  -.IP  -.IP "\fBeventlog\fP"  -list the events -.IP  -.IP  -.IP "Service Control"  -.IP  -These commands provide functionality similar to the Windows -NT Service Control Manager\&. -.IP  -It is possible to use command-line completion (if you have -the GNU readline library) for Service names, by pressing the -tab key\&. -.IP  -.IP  -.IP "\fBsvcenum\fP"  -[-i] Lists Services\&. -.IP  -.IP "\fBsvcinfo\fP"  -<service> Service Information -.IP  -.IP "\fBsvcstart\fP"  -<service> [arg 0] [arg 1] \&.\&.\&. Start Service -.IP  -.IP "\fBsvcstop\fP"  -<service> Stop Service -.IP  -.IP  -.IP "Scheduler"  -.IP  -.IP  -.IP "\fBat\fP"  -Scheduler control (at /? for syntax) -.IP  -.IP  -.IP "Registry"  -.IP  -It is possible to use command-line completion (if you have -the GNU readline library) for registry key and value names, -by pressing the tab key\&. -.IP  -.IP  -.IP "\fBregenum\fP"  -<keyname> Registry Enumeration (keys, values) -.IP  -.IP "\fBregdeletekey\fP"  -<keyname> Registry Key Delete -.IP  -.IP "\fBregcreatekey\fP"  -<keyname> [keyclass] Registry Key Create -.IP  -.IP "\fBshutdown\fP"  -[-m message] [-t timeout] [-r or --reboot] Server Shutdown -.IP  -.IP "\fBregqueryval\fP"  -<valname> Registry Value Query -.IP  -.IP "\fBregquerykey\fP"  -<keyname> Registry Key Query -.IP  -.IP "\fBregdeleteval\fP"  -<valname> Registry Value Delete -.IP  -.IP "\fBregcreateval\fP"  -<valname> <valtype> <value> Registry Key Create -.IP  -.IP "\fBreggetsec\fP"  -<keyname> Registry Key Security -.IP  -.IP "\fBregtestsec\fP"  -<keyname> Test Registry Key Security -.IP  -.IP  -.IP "Printing"  -.IP  -It is possible to use command-line completion (if you have -the GNU readline library) for Printer and job names, by -pressing the tab key\&. -.IP  -.IP  -.IP "\fBspoolenum\fP"  -Enumerate Printers\&.  This experimental command lists -all printers available on a remote spooler service\&. -.IP  -.IP "\fBspooljobs\fP"  -<printer name> Enumerate Printer Jobs\&.  This -experimental command lists all jobs, and their -status, currently queued on a remote spooler -service\&. -.IP  -.IP "\fBspoolopen\fP"  -<printer name> Spool Printer Open Test\&.  Experimental\&. -.IP  -.IP  -.IP "Server"  -.IP  -.IP  -.IP "\fBtime\fP"  -Display remote time -.IP  -.IP "\fBbrsinfo\fP"  -Browser Query Info -.IP  -.IP "\fBwksinfo\fP"  -Workstation Query Info -.IP  -.IP "\fBsrvinfo\fP"  -Server Query Info -.IP  -.IP "\fBsrvsessions\fP"  -List sessions on a server -.IP  -.IP "\fBsrvshares\fP"  -List shares on a server -.IP  -.IP "\fBsrvtransports\fP"  -List transports on a server -.IP  -.IP "\fBsrvconnections\fP"  -List connections on a server -.IP  -.IP "\fBsrvfiles\fP"  -List files on a server -.IP  -.IP  -.IP "Local Security Authority"  -.IP  -.IP  -.IP "\fBlsaquery\fP"  -Query Info Policy (domain member or server)\&.  Obtains -the SID and name of the SAM database that a server -is responsible for (i\&.e a workstation\'s local SAM -database or the PDC SAM database)\&.  Also obtains the -SID and name of the SAM database that a server is -a member of\&. -.IP  -.IP "\fBlsaenumdomains\fP"  -Enumerate Trusted Domains\&.  Lists all Trusted and -Trusting Domains with which the remote PDC has -trust relationships established\&. -.IP  -.IP "\fBlookupsids\fP"  -<rid1 or sid1> <rid1 or sid2> \&.\&.\&. Resolve names from SIDs\&. -Mostly to be used by developers or for troubleshooting, -this command can take either Security Identifiers or Relative -Identifiers, and look them up in the local SAM database -(or look them up in a remote Trusting or Trusted PDC\'s SAM -database if there is an appropriate Trust Relationship -established)\&.  The result is a list of names, of the -format:  -.br  -\f(CW[TRUST_DOMAIN\e]name\fP\&.  -.br  -the \fBlsaquery\fP command must have been -issued first if you wish to use lookupsids to resolve -RIDs\&.  The only RIDs that will be resolved will be those -in the SAM database of the server to which you are connected\&. -.IP  -.IP "\fBlookupnames\fP"  -<name1> <name2> \&.\&.\&. Resolve SIDs from names\&. -Mostly to be used by developers or for troubleshooting, -this command can take names of the following format:  -.br  -\f(CW[DOMAIN_NAME\e]name\fP\&.  -.br  -The names, which can be user, group or alias names, will -either be looked up in the local SAM database or in a remote -Trusting or Trusted PDC\'s SAM database, if there is an -appropriate Trust Relationship established\&.  The optional -Domain name component is the name of a SAM database, which -can include a workstation\'s local SAM database or a Trusted -Domain\&. -Example Usage:  -.br  -\f(CWlookupnames WKSTANAME\eAdministrator "Domain Guests"\fP  -.br  -.IP  -.IP "\fBquerysecret\fP"  -LSA Query Secret (developer use)\&.  This command only appears -to work against NT4 SP3 and below\&.  Due to its potential -for misuse, it looks like Microsoft modified their -implementation of the LsaRetrievePrivateData call to -always return NT_STATUS_ACCESS_DENIED\&. -.IP  -.IP  -.IP "NETLOGON"  -.IP  -.IP  -.IP "\fBntlogin\fP"  -[username] [password] NT Domain login test\&.  Demonstrates -how NT-style logins work\&.  Mainly for developer usage, -it can also be used to verify that a user can log in -from a workstation\&.  If you cannot ever get pam_ntdom -to work, try this command first\&. -.IP  -.IP "\fBdomtrust\fP"  -<domain> NT Inter-Domain test\&.  Demonstrates how NT-style -Inter-Domain Trust relationships work\&.  Mainly for -developer usage, it can also be used to verify that a -Trust Relationship is correctly established with a -remote PDC\&. -.IP  -.IP "\fBsamsync\fP"  -SAM Synchronisation Test (experimental)\&.  This command -is used to manually synchronise a SAM database from a -remote PDC, when Samba is set up as a Backup Domain -Controller\&. -.IP  -.IP  -.IP "SAM Database"  -.IP  -It is possible to use command-line completion (if you have -the GNU readline library) for user, group, alias and domain -names, by pressing the tab key\&. -.IP  -.IP  -.IP "\fBlookupdomain\fP"  -Obtain SID for a local domain -.IP  -.IP "\fBenumusers\fP"  -SAM User Database Query (experimental!) -.IP  -.IP "\fBaddgroupmem\fP"  -<group rid> [user] [user] \&.\&.\&. SAM Add Domain Group Member -.IP  -.IP "\fBaddaliasmem\fP"  -<alias rid> [member sid1] [member sid2] \&.\&.\&. SAM Add Domain Alias Member -.IP  -.IP "\fBdelgroupmem\fP"  -<group rid> [user] [user] \&.\&.\&. SAM Delete Domain Group Member -.IP  -.IP "\fBdelaliasmem\fP"  -<alias rid> [member sid1] [member sid2] \&.\&.\&. SAM Delete Domain Alias Member -.IP  -.IP "\fBcreategroup\fP"  -SAM Create Domain Group -.IP  -.IP "\fBcreatealias\fP"  -SAM Create Domain Alias -.IP  -.IP "\fBcreateuser\fP"  -<username> SAM Create Domain User -.IP  -.IP "\fBdelgroup\fP"  -SAM Delete Domain Group -.IP  -.IP "\fBdelalias\fP"  -SAM Delete Domain Alias -.IP  -.IP "\fBntpass\fP"  -NT SAM Password Change -.IP  -.IP "\fBsamuserset2\fP"  -<username> [-s acb_bits] SAM User Set Info 2 (experimental!) -.IP  -.IP "\fBsamuserset\fP"  -<username> [-p password] SAM User Set Info (experimental!) -.IP  -.IP "\fBsamuser\fP"  -<username> SAM User Query (experimental!) -.IP  -.IP "\fBsamgroup\fP"  -<groupname> SAM Group Query (experimental!) -.IP  -.IP "\fBsamalias\fP"  -<aliasname> SAM Alias Query -.IP  -.IP "\fBsamaliasmem\fP"  -<aliasname> SAM Alias Members -.IP  -.IP "\fBsamgroupmem\fP"  -SAM Group Members -.IP  -.IP "\fBsamtest\fP"  -SAM User Encrypted RPC test (experimental!) -.IP  -.IP "\fBenumaliases\fP"  -SAM Aliases Database Query (experimental!) -.IP  -.IP "\fBenumdomains\fP"  -SAM Domains Database Query (experimental!) -.IP  -.IP "\fBenumgroups\fP"  -SAM Group Database Query (experimental!) -.IP  -.IP "\fBdominfo\fP"  -SAM Query Domain Info -.IP  -.IP "\fBdispinfo\fP"  -SAM Query Display Info -.IP  -.IP  -.PP  -.SH "NOTES"  -.PP  -Some servers are fussy about the case of supplied usernames, -passwords, share names (AKA service names) and machine names\&. If you -fail to connect try giving all parameters in uppercase\&. -.PP  -It is often necessary to use the \fB-n\fP option when connecting -to some types of servers\&. For example OS/2 LanManager insists on a valid -NetBIOS name being used, so you need to supply a valid name that would -be known to the server\&. -.PP  -rpcclient only works on servers that support MSRPC over SMB\&.  This includes -all versions of Windows NT, including the ports to Unix such as AS/U and -AFPS\&.  Support for MSRPC over SMB in other servers is currently rare and -patchy, for example Samba 2\&.0 only supports a limited set of MSRPC commands, -and some of those are not supported very well\&. -.PP  -.SH "ENVIRONMENT VARIABLES"  -.PP  -The variable \fBUSER\fP may contain the username of the person using the -client\&.  This information is used only if the protocol level is high -enough to support session-level passwords\&. -.PP  -The variable \fBPASSWORD\fP may contain the password of the person using -the client\&.  This information is used only if the protocol level is -high enough to support session-level passwords\&. -.PP  -.SH "INSTALLATION"  -.PP  -The location of the client program is a matter for individual system -administrators\&. The following are thus suggestions only\&. -.PP  -It is recommended that the rpcclient software be installed in the -/usr/local/samba/bin or /usr/samba/bin directory, this directory -readable by all, writeable only by root\&. The client program itself -should be executable by all\&. The client should \fINOT\fP be setuid or -setgid! -.PP  -The client log files should be put in a directory readable and -writeable only by the user\&. -.PP  -To test the client, you will need to know the name of a running -SMB/CIFS server\&. It is possible to run \fBsmbd (8)\fP -an ordinary user - running that server as a daemon on a -user-accessible port (typically any port number over 1024) would -provide a suitable test server\&. -.PP  -.SH "DIAGNOSTICS"  -.PP  -Most diagnostics issued by the client are logged in a specified log -file\&. The log file name is specified at compile time, but may be -overridden on the command line\&. -.PP  -The number and nature of diagnostics available depends on the debug -level used by the client\&. If you have problems, set the debug level to -3 and peruse the log files\&. -.PP  -.SH "VERSION"  -.PP  -This man page is correct for version 2\&.0 of the Samba suite\&. -.PP  -.SH "BUGS"  -.PP  -.IP "WARNING!"  -The MSPRC 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 flakey in places\&. -.IP  -The development of Samba\'s implementation of these services is \fIalso\fP -a bit rough, and as more of the services are understood, it can even result -in versions of \fBsmbd (8)\fP and rpcclient that are -incompatible for some commands or services\&.  Additionally, the developers -are sending reports to Microsoft, and problems found by or reported to -Microsoft are fixed in Service Packs, which may also result in -incompatibilities\&. -.IP  -It is therefore not guaranteed that the execution of an rpcclient command will -work\&.  It is also not guaranteed that the target server will continue to -operate, i\&.e the execution of an MSRPC command may cause a remote service to -fail, or even cause the remote server to fail\&.  Usual rules apply, of course: -the developers bear absolutely no responsibility for the use, misuse, or -lack of use of rpcclient, by any person or persons, whether legal, -illegal, accidental, deliberate, intentional, malicious, curious, etc\&. -.IP  -.IP "Command Completion"  -Command-completion (available if you have the GNU readline library) used on -certain commands may not operate correctly if the word being completed (such as a registry key) contains a space\&.  Typically, the name will be completed, but -you will have to go back and put quotes round it, yourself\&.   -.IP  -.IP "SAM Database command-completion"  -Command-completion (available if you have the GNU readline library) of user, -group and alias names does not work on remote Domains, which would normally -be specified like this:  -.br  -\f(CWDOMAIN_name\euser_name\fP\&.  -.br  -The only names that can be completed in this fashion are the local names -in the SAM database of the target server\&. -.IP  -.IP "\fBspoolenum\fP"  -Due to current limitations in the rpcclient MSRPC / SMB code, and due to -the extremely poor MSRPC implementation (by Microsoft) of the spooler -service, if there are a large number of printers (or the names / comment -fields associated with the printers), this command will fail\&.  The -limitations require further research to be carried out; we\'re stuck with -the poor \ePIPE\espoolss design\&. -.IP  -.PP  -.SH "AUTHOR"  -.PP  -The original Samba software and related utilities were created by -Andrew Tridgell \fIsamba-bugs@samba\&.org\fP\&. Samba is now developed -by the Samba Team as an Open Source project similar to the way the -Linux kernel is developed\&. -.PP  -The original Samba man pages were written by Karl Auer\&. The man page -sources were converted to YODL format (another excellent piece of Open -Source software, available at -\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP) -and updated for the Samba2\&.0 release by Jeremy Allison\&.  This man page -was developed cut-and-paste style from the smbclient man page, by -Luke Kenneth Casson Leighton\&. -\fIsamba-bugs@samba\&.org\fP\&. -.PP  -See \fBsamba (7)\fP to find out how to get a full -list of contributors and details on how to submit bug reports, -comments etc\&. -.PP   | 
