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

[mimir at samba.org]

Author: mimir
Date: 2005-12-06 19:44:49 +0000 (Tue, 06 Dec 2005)
New Revision: 12103

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

Log:
Comments and a bit of formatting.


rafal


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


Changeset:
Modified: branches/SAMBA_4_0/source/librpc/rpc/dcerpc_connect.c
===================================================================
--- branches/SAMBA_4_0/source/librpc/rpc/dcerpc_connect.c	2005-12-06 17:59:20 UTC (rev 12102)
+++ branches/SAMBA_4_0/source/librpc/rpc/dcerpc_connect.c	2005-12-06 19:44:49 UTC (rev 12103)
@@ -43,16 +43,18 @@
 };
 
 
+/*
+  Stage 3 of ncacn_np_smb: Named pipe opened (?)
+*/
 void continue_pipe_open_smb(struct composite_context *ctx)
 {
 	struct composite_context *c = talloc_get_type(ctx->async.private_data,
 						      struct composite_context);
 	struct pipe_np_smb_state *s = talloc_get_type(c->private_data,
 						      struct pipe_np_smb_state);
-
+	/* receive result of named pipe open request */
 	c->status = dcerpc_pipe_open_smb_recv(ctx);
 	if (!NT_STATUS_IS_OK(c->status)) {
-
 		DEBUG(0,("Failed to open pipe %s - %s\n", s->io.pipe_name, nt_errstr(c->status)));
 		composite_error(c, c->status);
 		return;
@@ -61,7 +63,9 @@
 	composite_done(c);
 }
 
-
+/*
+  Stage 2 of ncacn_np_smb: Open a named pipe after successful smb connection
+*/
 void continue_smb_connect(struct composite_context *ctx)
 {
 	struct composite_context *open_ctx;
@@ -70,17 +74,19 @@
 	struct pipe_np_smb_state *s = talloc_get_type(c->private_data,
 						      struct pipe_np_smb_state);
 	
+	/* receive result of smb connect request */
 	c->status = smb_composite_connect_recv(ctx, c);
 	if (!NT_STATUS_IS_OK(c->status)) {
-
 		DEBUG(0,("Failed to connect to %s - %s\n", s->io.binding->host, nt_errstr(c->status)));
 		composite_error(c, c->status);
 		return;
 	}
 
+	/* prepare named pipe open parameters */
 	s->tree         = s->conn.out.tree;
 	s->io.pipe_name = s->io.binding->endpoint;
 
+	/* send named pipe open request */
 	open_ctx = dcerpc_pipe_open_smb_send(s->io.pipe->conn, s->tree, s->io.pipe_name);
 	if (open_ctx == NULL) {
 		composite_error(c, NT_STATUS_NO_MEMORY);
@@ -91,8 +97,10 @@
 }
 
 
-/* open a rpc connection to a rpc pipe on SMB using the binding
-   structure to determine the endpoint and options */
+/*
+  Initiate async open of a rpc connection to a rpc pipe on SMB using
+  the binding structure to determine the endpoint and options
+*/
 struct composite_context *dcerpc_pipe_connect_ncacn_np_smb_send(TALLOC_CTX *tmp_ctx, 
 								struct dcerpc_pipe_connect *io)
 {
@@ -101,6 +109,7 @@
 	struct composite_context *conn_req;
 	struct smb_composite_connect *conn;
 
+	/* composite context allocation and setup */
 	c = talloc_zero(tmp_ctx, struct composite_context);
 	if (c == NULL) return NULL;
 
@@ -117,6 +126,8 @@
 	s->io  = *io;
 	conn   = &s->conn;
 
+	/* prepare smb connection parameters: we're connecting to IPC$ share on
+	   remote rpc server */
 	conn->in.dest_host              = s->io.binding->host;
 	conn->in.port                   = 0;
 	conn->in.called_name            = strupper_talloc(tmp_ctx, s->io.binding->host);
@@ -125,6 +136,10 @@
 	conn->in.fallback_to_anonymous  = False;
 	conn->in.workgroup              = lp_workgroup();
 
+	/*
+	 * provide proper credentials - user supplied or anonymous in case this is
+	 * schannel connection
+	 */
 	if (s->io.binding->flags & DCERPC_SCHANNEL) {
 		struct cli_credentials *anon_creds;
 
@@ -143,6 +158,7 @@
 		s->conn.in.credentials = s->io.creds;
 	}
 
+	/* send smb connect request */
 	conn_req = smb_composite_connect_send(conn, s->io.pipe->conn, s->io.pipe->conn->event_ctx);
 	if (!conn_req) {
 		composite_error(c, NT_STATUS_NO_MEMORY);
@@ -156,6 +172,9 @@
 }
 
 
+/*
+  Receive result of a rpc connection to a rpc pipe on SMB
+*/
 NTSTATUS dcerpc_pipe_connect_ncacn_np_smb_recv(struct composite_context *c)
 {
 	NTSTATUS status = composite_wait(c);
@@ -165,6 +184,9 @@
 }
 
 
+/*
+  Sync version of a rpc connection to a rpc pipe on SMB
+*/
 NTSTATUS dcerpc_pipe_connect_ncacn_np_smb(TALLOC_CTX *tmp_ctx,
 					  struct dcerpc_pipe_connect *io)
 {