summaryrefslogtreecommitdiff
path: root/source4/librpc/rpc
diff options
context:
space:
mode:
authorAndrew Bartlett <abartlet@samba.org>2006-02-04 07:56:30 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 13:51:45 -0500
commitf2d76bddd5c9d8b02283f66ba0b1f1584d1734be (patch)
treecc42fa73d44b20fc06cb9841b326d939c4ec6a1b /source4/librpc/rpc
parent04396c36d3ee8300b2b73ea8b43a45ea1b250828 (diff)
downloadsamba-f2d76bddd5c9d8b02283f66ba0b1f1584d1734be.tar.gz
samba-f2d76bddd5c9d8b02283f66ba0b1f1584d1734be.tar.bz2
samba-f2d76bddd5c9d8b02283f66ba0b1f1584d1734be.zip
r13334: Add comments describing what these functions do.
We still need many more, but it is a start... Andrew Bartlett (This used to be commit b2bda127f681dc1e2003c86159a85fa613373f16)
Diffstat (limited to 'source4/librpc/rpc')
-rw-r--r--source4/librpc/rpc/dcerpc_auth.c23
1 files changed, 21 insertions, 2 deletions
diff --git a/source4/librpc/rpc/dcerpc_auth.c b/source4/librpc/rpc/dcerpc_auth.c
index f0a7dc8ffe..4f11667365 100644
--- a/source4/librpc/rpc/dcerpc_auth.c
+++ b/source4/librpc/rpc/dcerpc_auth.c
@@ -164,6 +164,18 @@ static void bind_auth_recv_bindreply(struct composite_context *creq)
bind_auth_next_step(c);
}
+/**
+ Bind to a DCE/RPC pipe, async
+ @param mem_ctx TALLOC_CTX for the allocation of the composite_context
+ @param p The dcerpc_pipe to bind (must already be connected)
+ @param table The interface table to use (the DCE/RPC bind both selects and interface and authenticates)
+ @param credentials The credentials of the account to connect with
+ @param auth_type Select the authentication scheme to use
+ @param auth_level Chooses between unprotected (connect), signed or sealed
+ @param service The service (used by Kerberos to select the service principal to contact)
+ @retval A composite context describing the partial state of the bind
+*/
+
struct composite_context *dcerpc_bind_auth_send(TALLOC_CTX *mem_ctx,
struct dcerpc_pipe *p,
const struct dcerpc_interface_table *table,
@@ -316,8 +328,15 @@ NTSTATUS dcerpc_bind_auth_recv(struct composite_context *creq)
return result;
}
-/*
- setup GENSEC on a DCE-RPC pipe
+/**
+ Perform a GENSEC authenticated bind to a DCE/RPC pipe, sync
+ @param p The dcerpc_pipe to bind (must already be connected)
+ @param table The interface table to use (the DCE/RPC bind both selects and interface and authenticates)
+ @param credentials The credentials of the account to connect with
+ @param auth_type Select the authentication scheme to use
+ @param auth_level Chooses between unprotected (connect), signed or sealed
+ @param service The service (used by Kerberos to select the service principal to contact)
+ @retval NTSTATUS status code
*/
NTSTATUS dcerpc_bind_auth(struct dcerpc_pipe *p,
const struct dcerpc_interface_table *table,