svn commit: samba r14591 - in branches/SAMBA_4_0/source/libnet: .

mimir at samba.org mimir at samba.org
Mon Mar 20 21:44:30 GMT 2006


Author: mimir
Date: 2006-03-20 21:44:29 +0000 (Mon, 20 Mar 2006)
New Revision: 14591

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=14591

Log:
More comments.


rafal


Modified:
   branches/SAMBA_4_0/source/libnet/libnet_rpc.c


Changeset:
Modified: branches/SAMBA_4_0/source/libnet/libnet_rpc.c
===================================================================
--- branches/SAMBA_4_0/source/libnet/libnet_rpc.c	2006-03-20 21:28:56 UTC (rev 14590)
+++ branches/SAMBA_4_0/source/libnet/libnet_rpc.c	2006-03-20 21:44:29 UTC (rev 14591)
@@ -41,7 +41,7 @@
  * @param ctx initialised libnet context
  * @param mem_ctx memory context of this call
  * @param r data structure containing necessary parameters and return values
- * @return nt status of the call
+ * @return composite context of this call
  **/
 
 static struct composite_context* libnet_RpcConnectSrv_send(struct libnet_context *ctx,
@@ -52,6 +52,7 @@
 	struct rpc_connect_srv_state *s;
 	struct composite_context *pipe_connect_req;
 
+	/* composite context allocation and setup */
 	c = talloc_zero(mem_ctx, struct composite_context);
 	if (c == NULL) return NULL;
 
@@ -88,6 +89,9 @@
 }
 
 
+/*
+  Step 2 of RpcConnectSrv - get rpc connection
+*/
 static void continue_pipe_connect(struct composite_context *ctx)
 {
 	struct composite_context *c;
@@ -96,6 +100,7 @@
 	c = talloc_get_type(ctx->async.private_data, struct composite_context);
 	s = talloc_get_type(c->private_data, struct rpc_connect_srv_state);
 
+	/* receive result of rpc pipe connection */
 	c->status = dcerpc_pipe_connect_recv(ctx, c, &s->r.out.dcerpc_pipe);
 	if (!composite_is_ok(c)) return;
 
@@ -123,6 +128,7 @@
 	NTSTATUS status = composite_wait(c);
 
 	if (NT_STATUS_IS_OK(status) && ctx && mem_ctx && r) {
+		/* move the returned rpc pipe between memory contexts */
 		s = talloc_get_type(c->private_data, struct rpc_connect_srv_state);
 		r->out.dcerpc_pipe = talloc_steal(mem_ctx, s->r.out.dcerpc_pipe);
 		ctx->pipe = r->out.dcerpc_pipe;
@@ -163,6 +169,7 @@
 	struct rpc_connect_dc_state *s;
 	struct composite_context *lookup_dc_req;
 
+	/* composite context allocation and setup */
 	c = talloc_zero(mem_ctx, struct composite_context);
 	if (c == NULL) return NULL;
 
@@ -201,6 +208,10 @@
 }
 
 
+/*
+  Step 2 of RpcConnectDC: get domain controller name/address and
+  initiate RpcConnect to it
+*/
 static void continue_lookup_dc(struct composite_context *ctx)
 {
 	struct composite_context *c;
@@ -210,6 +221,7 @@
 	c = talloc_get_type(ctx->async.private_data, struct composite_context);
 	s = talloc_get_type(c->private_data, struct rpc_connect_dc_state);
 	
+	/* receive result of domain controller lookup */
 	c->status = libnet_LookupDCs_recv(ctx, c, &s->f);
 	if (!composite_is_ok(c)) return;
 
@@ -228,6 +240,7 @@
 	s->r2.in.name          = talloc_strdup(c, s->connect_name);
 	s->r2.in.dcerpc_iface  = s->r.in.dcerpc_iface;	
 
+	/* send rpc connect request to the server */
 	rpc_connect_req = libnet_RpcConnect_send(s->ctx, c, &s->r2);
 	if (composite_nomem(rpc_connect_req, c)) return;
 
@@ -235,6 +248,9 @@
 }
 
 
+/*
+  Step 3 of RpcConnectDC: get rpc connection to the server
+*/
 static void continue_rpc_connect(struct composite_context *ctx)
 {
 	struct composite_context *c;
@@ -276,6 +292,7 @@
 	status = composite_wait(c);
 
 	if (NT_STATUS_IS_OK(status) && ctx && mem_ctx && r) {
+		/* move connected rpc pipe between memory contexts */
 		s = talloc_get_type(c->private_data, struct rpc_connect_dc_state);
 		r->out.dcerpc_pipe = talloc_steal(mem_ctx, s->r.out.dcerpc_pipe);
 		ctx->pipe = r->out.dcerpc_pipe;
@@ -353,6 +370,15 @@
 }
 
 
+/**
+ * Connect to a rpc pipe on a remote server - sync version
+ *
+ * @param ctx initialised libnet context
+ * @param mem_ctx memory context of this call
+ * @param r data structure containing necessary parameters and return values
+ * @return nt status of rpc connection
+ **/
+
 NTSTATUS libnet_RpcConnect(struct libnet_context *ctx, TALLOC_CTX *mem_ctx,
 			   struct libnet_RpcConnect *r)
 {



More information about the samba-cvs mailing list