[PATCH] Document DCERPC binding string in rpcclient

[Andreas Schneider]

Hi,

please review and push if happy.


Thanks,


	Andreas
-------------- next part --------------
>From ac4c9d034ace50fe780dad785332025a0cda7a33 Mon Sep 17 00:00:00 2001
From: Andreas Schneider <asn at samba.org>
Date: Fri, 1 Feb 2019 18:51:53 +0100
Subject: [PATCH] docs: Document DCEPRC binding string for rpcclient

Signed-off-by: Andreas Schneider <asn at samba.org>
---
 docs-xml/manpages/rpcclient.1.xml | 49 +++++++++++++++++++++++++++----
 1 file changed, 44 insertions(+), 5 deletions(-)

diff --git a/docs-xml/manpages/rpcclient.1.xml b/docs-xml/manpages/rpcclient.1.xml
index 1e167f8437c..2a74c7cae4d 100644
--- a/docs-xml/manpages/rpcclient.1.xml
+++ b/docs-xml/manpages/rpcclient.1.xml
@@ -53,11 +53,50 @@
 	<variablelist>
 		<varlistentry>
 		<term>server</term>
-		<listitem><para>NetBIOS name of Server to which to connect. 
-		The server can be  any SMB/CIFS server.  The name is 
-		resolved using the <smbconfoption name="name resolve order"/> line from <citerefentry><refentrytitle>smb.conf</refentrytitle>
-	<manvolnum>5</manvolnum></citerefentry>.</para></listitem>
-	</varlistentry>
+		<listitem>
+			<para>Either specify a DCERPC binding string or the resolveable
+			hostname (netbios name) of the server. The server can be any SMB/CIFS
+			server.</para>
+
+			<para>The DCERPC binding string has the following form:</para>
+
+			<para>TRANSPORT:SERVER[OPTIONS]</para>
+
+			<para>Example: ncacn_ip_tcp:samba.example.com[seal,krb5]</para>
+
+			<para>The supported transports are:</para>
+
+			<itemizedlist>
+			<listitem><para><parameter moreinfo="none">ncacn_np</parameter> - Connect using named pipes</para></listitem>
+			<listitem><para><parameter moreinfo="none">ncacn_ip_tcp</parameter> - Connect over TCP/IP</para></listitem>
+			<listitem><para><parameter moreinfo="none">ncalrpc</parameter> - Connect over local RPC</para></listitem>
+			</itemizedlist>
+
+			<para>The supported options are:</para>
+
+			<itemizedlist>
+			<listitem><para><parameter moreinfo="none">connect</parameter> - Use connect level authentication</para></listitem>
+			<listitem><para><parameter moreinfo="none">packet</parameter> - Use packet authentication level</para></listitem>
+			<listitem><para><parameter moreinfo="none">sign</parameter> - Use integrety autentication level</para></listitem>
+			<listitem><para><parameter moreinfo="none">seal</parameter> - Enable privacy (encryption) autentication level</para></listitem>
+
+			<listitem><para><parameter moreinfo="none">spnego</parameter> - Enable SPNEGO</para></listitem>
+			<listitem><para><parameter moreinfo="none">ntlm</parameter> - Use plain NTLM</para></listitem>
+			<listitem><para><parameter moreinfo="none">krb5</parameter> - Use Kerberos</para></listitem>
+			<listitem><para><parameter moreinfo="none">schannel</parameter> - Create a schannel connection</para></listitem>
+
+			<listitem><para><parameter moreinfo="none">smb1</parameter> - Use SMB1 for named pipes</para></listitem>
+			<listitem><para><parameter moreinfo="none">smb2</parameter> - Use SMB2/3 for named pipes</para></listitem>
+
+			<listitem><para><parameter moreinfo="none">validate</parameter> - Enable validation debug</para></listitem>
+			<listitem><para><parameter moreinfo="none">print</parameter> - Enable debug output</para></listitem>
+			<listitem><para><parameter moreinfo="none">padcheck</parameter> - Debug padding</para></listitem>
+			<listitem><para><parameter moreinfo="none">bigendian</parameter> - Use bigending for pushing</para></listitem>
+			<listitem><para><parameter moreinfo="none">ndr64</parameter> - Use NDR64</para></listitem>
+			</itemizedlist>
+
+		</listitem>
+		</varlistentry>
 
 
 		<varlistentry>
-- 
2.20.1