svn commit: samba r14211 - in branches/SAMBA_4_0/source/librpc/rpc: .

[mimir at samba.org]

Author: mimir
Date: 2006-03-11 19:06:47 +0000 (Sat, 11 Mar 2006)
New Revision: 14211

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

Log:
More comments.


rafal


Modified:
   branches/SAMBA_4_0/source/librpc/rpc/dcerpc_util.c


Changeset:
Modified: branches/SAMBA_4_0/source/librpc/rpc/dcerpc_util.c
===================================================================
--- branches/SAMBA_4_0/source/librpc/rpc/dcerpc_util.c	2006-03-11 14:18:00 UTC (rev 14210)
+++ branches/SAMBA_4_0/source/librpc/rpc/dcerpc_util.c	2006-03-11 19:06:47 UTC (rev 14211)
@@ -777,6 +777,10 @@
 static void continue_epm_map(struct rpc_request *req);
 
 
+/*
+  Stage 2 of epm_map_binding: Receive connected rpc pipe and send endpoint
+  mapping rpc request
+*/
 static void continue_epm_recv_binding(struct composite_context *ctx)
 {
 	struct rpc_request *map_req;
@@ -786,12 +790,14 @@
 	struct epm_map_binding_state *s = talloc_get_type(c->private_data,
 							  struct epm_map_binding_state);
 
+	/* receive result of rpc pipe connect request */
 	c->status = dcerpc_pipe_connect_b_recv(ctx, c, &s->pipe);
 	if (!composite_is_ok(c)) return;
 
 	ZERO_STRUCT(s->handle);
 	ZERO_STRUCT(s->guid);
 
+	/* prepare requested binding parameters */
 	s->binding->object         = s->table->uuid;
 	s->binding->object_version = s->table->if_version;
 
@@ -805,6 +811,7 @@
 	s->r.in.max_towers    = 1;
 	s->r.out.entry_handle = &s->handle;
 
+	/* send request for an endpoint mapping - a rpc request on connected pipe */
 	map_req = dcerpc_epm_Map_send(s->pipe, c, &s->r);
 	if (composite_nomem(map_req, c)) return;
 	
@@ -812,6 +819,9 @@
 }
 
 
+/*
+  Stage 3 of epm_map_binding: Receive endpoint mapping and provide binding details
+*/
 static void continue_epm_map(struct rpc_request *req)
 {
 	struct composite_context *c = talloc_get_type(req->async.private,
@@ -819,9 +829,11 @@
 	struct epm_map_binding_state *s = talloc_get_type(c->private_data,
 							  struct epm_map_binding_state);
 
+	/* receive result of a rpc request */
 	c->status = dcerpc_ndr_request_recv(req);
 	if (!composite_is_ok(c)) return;
 
+	/* check the details */
 	if (s->r.out.result != 0 || s->r.out.num_towers != 1) {
 		composite_error(c, NT_STATUS_PORT_UNREACHABLE);
 		return;
@@ -839,12 +851,17 @@
 		return;
 	}
 
+	/* get received endpoint */
 	s->binding->endpoint = talloc_reference(s->binding,
 						dcerpc_floor_get_rhs_data(c, &s->twr_r->tower.floors[3]));
 	composite_done(c);
 }
 
 
+/*
+  Request for endpoint mapping of dcerpc binding - try to request for endpoint
+  unless there is default one.
+*/
 struct composite_context *dcerpc_epm_map_binding_send(TALLOC_CTX *mem_ctx,
 						      struct dcerpc_binding *binding,
 						      const struct dcerpc_interface_table *table,
@@ -881,12 +898,14 @@
 	s->binding = binding;
 	s->table   = table;
 
+	/* anonymous credentials for rpc connection used to get endpoint mapping */
 	anon_creds = cli_credentials_init(mem_ctx);
 	cli_credentials_set_conf(anon_creds);
 	cli_credentials_set_anonymous(anon_creds);
 
-	/* First, check if there is a default endpoint specified in the IDL */
-
+	/*
+	  First, check if there is a default endpoint specified in the IDL
+	*/
 	if (table) {
 		struct dcerpc_binding *default_binding;
 
@@ -912,12 +931,14 @@
 	epmapper_binding = talloc_zero(c, struct dcerpc_binding);
 	if (composite_nomem(epmapper_binding, c)) return c;
 
+	/* basic endpoint mapping data */
 	epmapper_binding->transport  = binding->transport;
 	epmapper_binding->host       = talloc_reference(epmapper_binding, binding->host);
 	epmapper_binding->options    = NULL;
 	epmapper_binding->flags      = 0;
 	epmapper_binding->endpoint   = NULL;
 
+	/* initiate rpc pipe connection */
 	pipe_connect_req = dcerpc_pipe_connect_b_send(c, &s->pipe, epmapper_binding, &dcerpc_table_epmapper,
 						      anon_creds, c->event_ctx);
 	if (composite_nomem(pipe_connect_req, c)) return c;
@@ -927,6 +948,9 @@
 }
 
 
+/*
+  Receive result of endpoint mapping request
+ */
 NTSTATUS dcerpc_epm_map_binding_recv(struct composite_context *c)
 {
 	NTSTATUS status = composite_wait(c);
@@ -936,6 +960,9 @@
 }
 
 
+/*
+  Get endpoint mapping for rpc connection
+*/
 NTSTATUS dcerpc_epm_map_binding(TALLOC_CTX *mem_ctx, struct dcerpc_binding *binding,
 				const struct dcerpc_interface_table *table, struct event_context *ev)
 {