From 35a1bf2bb91ccdf8e2bc4a1c6852906dab44da1a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pavel=20Filipensk=C3=BD?= Date: Wed, 19 May 2021 14:51:00 +0200 Subject: [PATCH 1/2] s3:rpcclient: Document command of witness protocol MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit BUG: https://bugzilla.samba.org/show_bug.cgi?id=14719 Signed-off-by: Pavel Filipenský Reviewed-by: Andrew Bartlett Reviewed-by: Alexander Bokovoy Reviewed-by: Andreas Schneider (cherry picked from commit 139cefceca20bd21ad557830f551eb51b343c660) --- source3/rpcclient/cmd_witness.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source3/rpcclient/cmd_witness.c b/source3/rpcclient/cmd_witness.c index c28df1d2301..987c79736b6 100644 --- a/source3/rpcclient/cmd_witness.c +++ b/source3/rpcclient/cmd_witness.c @@ -561,7 +561,7 @@ struct cmd_set witness_commands[] = { .wfn = &cmd_witness_GetInterfaceList, .table = &ndr_table_witness, .rpc_pipe = NULL, - .description = "", + .description = "List the interfaces to which witness client connections can be made", .usage = "", }, { @@ -571,7 +571,7 @@ struct cmd_set witness_commands[] = { .wfn = &cmd_witness_Register, .table = &ndr_table_witness, .rpc_pipe = NULL, - .description = "", + .description = "Register for resource state change notifications of a NetName and IPAddress", .usage = "", }, { @@ -581,7 +581,7 @@ struct cmd_set witness_commands[] = { .wfn = &cmd_witness_UnRegister, .table = &ndr_table_witness, .rpc_pipe = NULL, - .description = "", + .description = "Unregister for notifications from the server", .usage = "", }, { @@ -591,7 +591,7 @@ struct cmd_set witness_commands[] = { .wfn = &cmd_witness_AsyncNotify, .table = &ndr_table_witness, .rpc_pipe = NULL, - .description = "", + .description = "Request notification of registered resource changes from the server", .usage = "", }, { @@ -601,7 +601,7 @@ struct cmd_set witness_commands[] = { .wfn = &cmd_witness_RegisterEx, .table = &ndr_table_witness, .rpc_pipe = NULL, - .description = "", + .description = "Register for resource state change notifications of a NetName, ShareName and multiple IPAddresses", .usage = "", }, { -- 2.31.1 From f08af04a1dc56beed5b7fdeabf031835ac570669 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pavel=20Filipensk=C3=BD?= Date: Wed, 19 May 2021 13:12:31 +0200 Subject: [PATCH 2/2] docs: Update list of available commands in rpcclient MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The list of available commands in rpcclient.1 manpage is updated to match the current state, which is visible via help commnad of rpcclient. BUG: https://bugzilla.samba.org/show_bug.cgi?id=14719 Signed-off-by: Pavel Filipenský Reviewed-by: Andrew Bartlett Reviewed-by: Alexander Bokovoy Reviewed-by: Andreas Schneider (cherry picked from commit 2d7740f65c69497de665043051228f6315de4f5c) --- docs-xml/manpages/rpcclient.1.xml | 377 ++++++++++++++++++++---------- 1 file changed, 248 insertions(+), 129 deletions(-) diff --git a/docs-xml/manpages/rpcclient.1.xml b/docs-xml/manpages/rpcclient.1.xml index 18f9c14b09e..ae658647b81 100644 --- a/docs-xml/manpages/rpcclient.1.xml +++ b/docs-xml/manpages/rpcclient.1.xml @@ -167,75 +167,76 @@ LSARPC - lsaqueryQuery info policy - - lookupsidsResolve a list - of SIDs to usernames. - - - lookupnamesResolve a list - of usernames to SIDs. - - + lookupsidsConvert SIDs to names + lookupsids3Convert SIDs to names + lookupsids_levelConvert SIDs to names + lookupnamesConvert names to SIDs + lookupnames4Convert names to SIDs + lookupnames_levelConvert names to SIDs enumtrustEnumerate trusted domains - enumprivsEnumerate privileges - getdispnameGet the privilege name - lsaenumsidEnumerate the LSA SIDS - + lsacreateaccountCreate a new lsa account lsaenumprivsaccountEnumerate the privileges of an SID - lsaenumacctrightsEnumerate the rights of an SID - - lsaenumacctwithrightEnumerate accounts with a right - + lsaaddprivAssign a privilege to a SID + lsadelprivRevoke a privilege from a SID lsaaddacctrightsAdd rights to an account - lsaremoveacctrightsRemove rights from an account - lsalookupprivvalueGet a privilege value given its name - lsaquerysecobjQuery LSA security object - - + lsaquerytrustdominfoQuery LSA trusted domains info (given a SID) + lsaquerytrustdominfobynameQuery LSA trusted domains info (given a name), only works for Windows > 2k + lsaquerytrustdominfobysidQuery LSA trusted domains info (given a SID) + lsasettrustdominfoSet LSA trusted domain info + getusernameGet username + createsecretCreate Secret + deletesecretDelete Secret + querysecretQuery Secret + setsecretSet Secret + retrieveprivatedataRetrieve Private Data + storeprivatedataStore Private Data + createtrustdomCreate Trusted Domain + deletetrustdomDelete Trusted Domain + - + + LSARPC-DS - dsroledominfoGet Primary Domain Information + - - DFS + + DFS - dfsexistQuery DFS support + dfsversionQuery DFS support dfsaddAdd a DFS share dfsremoveRemove a DFS share dfsgetinfoQuery DFS share info dfsenumEnumerate dfs shares + dfsenumexEnumerate dfs shares - + - REG + SHUTDOWN - shutdownRemote Shutdown - abortshutdownAbort Shutdown + shutdowninitsyntax: shutdown [-m message] + shutdownabortsyntax: shutdownabort - + SRVSVC - srvinfoServer query info netshareenumEnumerate shares @@ -254,34 +255,49 @@ netshareaddAdd share netsharedelDelete share - + SAMR - queryuserQuery user info querygroupQuery group info queryusergroupsQuery user groups + queryuseraliasesQuery user aliases querygroupmemQuery group membership queryaliasmemQuery alias membership + queryaliasinfoQuery alias info + deletealiasDelete an alias querydispinfoQuery display info + querydispinfo2Query display info + querydispinfo3Query display info querydominfoQuery domain info enumdomusersEnumerate domain users enumdomgroupsEnumerate domain groups enumalsgroupsEnumerate alias groups + enumdomainsEnumerate domains createdomuserCreate domain user + createdomgroupCreate domain group + createdomaliasCreate domain alias samlookupnamesLook up names samlookupridsLook up names + deletedomgroupDelete domain group deletedomuserDelete domain user samquerysecobjQuery SAMR security object getdompwinfoRetrieve domain password info - lookupdomainLook up domain + getusrdompwinfoRetrieve user domain password info + lookupdomainLookup Domain Name + chgpasswdChange user password + chgpasswd2Change user password + chgpasswd3Change user password + getdispinfoidxGet Display Information Index + setuserinfoSet user info + setuserinfo2Set user info2 - + SPOOLSS @@ -322,7 +338,7 @@ Comma Separated list of Files default driver version for the specified architecture will be used. This option can be used to upload Windows 2000 (version 3) printer drivers. - + addprinter <printername> <sharename> <drivername> <port> @@ -333,7 +349,6 @@ Comma Separated list of Files enumports. - deldriver <driver>Delete the specified printer driver for all architectures. This does not delete the actual driver files from the server, @@ -358,22 +373,23 @@ Comma Separated list of Files enumdataexEnumerate printer data for a key + enumkeyEnumerate printer keys + enumjobs <printer> List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() function - enumkeyEnumerate - printer keys - + getjobGet print job + setjobSet print job + + enumports [level] Executes an EnumPorts() call using the specified info level. Currently only info levels 1 and 2 are supported. - - enumdrivers [level] Execute an EnumPrinterDrivers() call. This lists the various installed @@ -381,17 +397,12 @@ Comma Separated list of Files documentation for more details of the various flags and calling options. Currently supported info levels are 1, 2, and 3. - - enumprinters [level] 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. - - - getdata <printername> <valuename;> Retrieve the data for a given printer setting. See the enumdata command for more information. @@ -410,7 +421,6 @@ Comma Separated list of Files the given printer. This command corresponds to the GetPrinterDriver() MS Platform SDK function. Currently info level 1, 2, and 3 are supported. - getdriverdir <arch> @@ -421,21 +431,22 @@ Comma Separated list of Files (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000". - + getdriverpackagepath + Get print driver package download directory getprinter <printername> Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function. - getprintprocdirGet - print processor - directory - + openprinter <printername> Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer. + openprinter_ex <printername> + Open printer handle + setdriver <printername> <drivername> Execute a SetPrinter() command to update the printer driver @@ -446,6 +457,9 @@ Comma Separated list of Files enumdrivers commands for obtaining a list of of installed printers and drivers. + getprintprocdir + Get print processor directory + addformAdd form setformSet form getformGet form @@ -454,110 +468,215 @@ Comma Separated list of Files setprinterSet printer comment setprinterdataSet REG_SZ printer data - setprintername <printername> - <newprintername> + setprintername <printername> <newprintername> Set printer name rffpcnexRffpcnex test - + printercmpPrinter comparison test + enumprocsEnumerate Print Processors + enumprocdatatypesEnumerate Print Processor Data Types + enummonitorsEnumerate Print Monitors + createprintericCreate Printer IC + playgdiscriptonprintericCreate Printer IC + getcoreprinterdriversGet CorePrinterDriver + enumpermachineconnectionsEnumerate Per Machine Connections + addpermachineconnectionAdd Per Machine Connection + delpermachineconnectionDelete Per Machine Connection + + + + + + NETLOGON + + logonctrl2Logon Control 2 + getanydcnameGet trusted DC name + getdcnameGet trusted PDC name + dsr_getdcnameGet trusted DC name + dsr_getdcnameexGet trusted DC name + dsr_getdcnameex2Get trusted DC name + dsr_getsitenameGet sitename + dsr_getforesttrustinfoGet Forest Trust Info + logonctrlLogon Control + samlogonSam Logon + change_trust_pwChange Trust Account Password + gettrustridGet trust rid + dsr_enumtrustdomEnumerate trusted domains + dsenumdomtrustsEnumerate all trusted domains in an AD forest + deregisterdnsrecordsDeregister DNS records + netrenumtrusteddomainsEnumerate trusted domains + netrenumtrusteddomainsexEnumerate trusted domains + getdcsitecoverageGet the Site-Coverage from a DC + capabilitiesReturn Capabilities + logongetdomaininfoReturn LogonGetDomainInfo + + + + + FSRVP + + fss_is_path_supCheck whether a share supports shadow-copy + fss_get_sup_versionGet supported FSRVP version from server + fss_create_exposeRequest shadow-copy creation and exposure + fss_deleteRequest shadow-copy share deletion + fss_has_shadow_copyCheck for an associated share shadow-copy + fss_get_mappingGet shadow-copy share mapping information + fss_recovery_completeFlag read-write snapshot as recovery complete, + + + + CLUSAPI + + clusapi_open_clusterOpen cluster + clusapi_get_cluster_nameGet cluster name + clusapi_get_cluster_versionGet cluster version + clusapi_get_quorum_resourceGet quorum resource + clusapi_create_enumCreate enum query + clusapi_create_enumexCreate enumex query + clusapi_open_resourceOpen cluster resource + clusapi_online_resourceSet cluster resource online + clusapi_offline_resourceSet cluster resource offline + clusapi_get_resource_stateGet cluster resource state + clusapi_get_cluster_version2Get cluster version2 + clusapi_pause_nodePause cluster node + clusapi_resume_nodeResume cluster node + + - NETLOGON + DRSUAPI + + dscracknamesCrack Name + dsgetdcinfoGet Domain Controller Info + dsgetncchangesGet NC Changes + dswriteaccountspnWrite Account SPN + + + + + ECHO + echoaddoneAdd one to a number + echodataEcho data + sinkdataSink data + sourcedataSource data + + - logonctrl2 - Logon Control 2 - - logonctrl - Logon Control - + + EPMAPPER + + epmmapMap a binding + epmlookupLookup bindings + + - samsync - Sam Synchronisation - - samdeltas - Query Sam Deltas - + + EVENTLOG + + eventlog_readlogRead Eventlog + eventlog_numrecordGet number of records + eventlog_oldestrecordGet oldest record + eventlog_reporteventReport event + eventlog_reporteventsourceReport event and source + eventlog_registerevsourceRegister event source + eventlog_backuplogBackup Eventlog File + eventlog_loginfoGet Eventlog Information + + - samlogon - Sam Logon - + + IRemoteWinspool + + winspool_AsyncOpenPrinterOpen printer handle + winspool_AsyncCorePrinterDriverInstalledQuery Core Printer Driver Installed + - FSRVP + NTSVCS + ntsvcs_getversionQuery NTSVCS version + ntsvcs_validatedevinstQuery NTSVCS device instance + ntsvcs_hwprofflagsQuery NTSVCS HW prof flags + ntsvcs_hwprofinfoQuery NTSVCS HW prof info + ntsvcs_getdevregpropQuery NTSVCS device registry property + ntsvcs_getdevlistsizeQuery NTSVCS device list size + ntsvcs_getdevlistQuery NTSVCS device list + + - fss_is_path_sup <share> - - Check whether a share supports shadow-copy - requests - - - fss_get_sup_version - - Get supported FSRVP version from server - - - fss_create_expose <context> <[ro|rw]> - <share1> - [share2] ... [shareN] - - Request shadow-copy creation and exposure as a - new share - - - fss_delete <base_share> - <shadow_copy_set_id> - <shadow_copy_id> - - Request shadow-copy share deletion - - - fss_has_shadow_copy <base_share> - - Check for an associated share shadow-copy - - - fss_get_mapping <base_share> - <shadow_copy_set_id> - <shadow_copy_id> - - Get shadow-copy share mapping information - - - fss_recovery_complete <shadow_copy_set_id> - - Flag read-write shadow-copy as recovery complete, - allowing further shadow-copy requests - - + + MDSSVC + + fetch_propertiesFetch connection properties + fetch_attributesFetch attributes for a CNID + + + + + + WINREG + + winreg_enumkeyEnumerate Keys + querymultiplevaluesQuery multiple values + querymultiplevalues2Query multiple values + - GENERAL COMMANDS + WITNESS + + GetInterfaceListList the interfaces to which witness client connections can be made + RegisterRegister for resource state change notifications of a NetName and IPAddress + UnRegisterUnregister for notifications from the server + AsyncNotifyRequest notification of registered resource changes from the server + RegisterExRegister for resource state change notifications of a NetName, ShareName and multiple IPAddresses + + + + + WKSSVC - debuglevelSet the current - debug level used to log information. + wkssvc_wkstagetinfoQuery WKSSVC Workstation Information + wkssvc_getjoininformationQuery WKSSVC Join Information + wkssvc_messagebuffersendSend WKSSVC message + wkssvc_enumeratecomputernamesEnumerate WKSSVC computer names + wkssvc_enumerateusersEnumerate WKSSVC users + + - help (?)Print a listing of all - known commands or extended help on a particular command. - - - quit (exit)Exit rpcclient - . + + + GENERAL OPTIONS + + helpGet help on commands + ?Get help on commands + debuglevelSet debug level + debugSet debug level + listList available commands on pipe + exitExit program + quitExit program + signForce RPC pipe connections to be signed + sealForce RPC pipe connections to be sealed + packetForce RPC pipe connections with packet authentication level + schannelForce RPC pipe connections to be sealed with 'schannel'. Force RPC pipe connections to be sealed with 'schannel'. Assumes valid machine account to this domain controller. + schannelsignForce RPC pipe connections to be signed (not sealed) with 'schannel'. Assumes valid machine account to this domain controller. + timeoutSet timeout (in milliseconds) for RPC operations + transportChoose ncacn transport for RPC operations + noneForce RPC pipe connections to have no special properties -- 2.31.1