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

[mimir at samba.org]

Author: mimir
Date: 2005-07-27 21:59:16 +0000 (Wed, 27 Jul 2005)
New Revision: 8808

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

Log:
More comments.


rafal


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


Changeset:
Modified: branches/SAMBA_4_0/source/libnet/userman.c
===================================================================
--- branches/SAMBA_4_0/source/libnet/userman.c	2005-07-27 21:46:06 UTC (rev 8807)
+++ branches/SAMBA_4_0/source/libnet/userman.c	2005-07-27 21:59:16 UTC (rev 8808)
@@ -465,6 +465,9 @@
 };
 
 
+/**
+ * Step 1: Lookup user name
+ */
 static NTSTATUS usermod_lookup(struct composite_context *c,
 			       struct usermod_state *s)
 {
@@ -497,6 +500,9 @@
 }
 
 
+/**
+ * Stage 2: Open user account
+ */
 static NTSTATUS usermod_open(struct composite_context *c,
 			     struct usermod_state *s)
 {
@@ -577,6 +583,9 @@
 }
 
 
+/**
+ * Stage 3: Set new user account data
+ */
 static NTSTATUS usermod_modify(struct composite_context *c,
 			       struct usermod_state *s)
 {
@@ -589,6 +598,13 @@
 }
 
 
+/**
+ * Event handler for asynchronous request. Handles transition through
+ * intermediate stages of the call.
+ *
+ * @param req rpc call context
+ */
+
 static void usermod_handler(struct rpc_request *req)
 {
 	struct composite_context *c = req->async.private;
@@ -622,6 +638,13 @@
 }
 
 
+/**
+ * Sends asynchronous usermod request
+ *
+ * @param p dce/rpc call pipe
+ * @param io arguments and results of the call
+ */
+
 struct composite_context *libnet_rpc_usermod_send(struct dcerpc_pipe *p,
 						  struct libnet_rpc_usermod *io)
 {
@@ -661,6 +684,15 @@
 }
 
 
+/**
+ * Waits for and receives results of asynchronous usermod call
+ *
+ * @param c composite context returned by asynchronous usermod call
+ * @param mem_ctx memory context of the call
+ * @param io pointer to results (and arguments) of the call
+ * @return nt status code of execution
+ */
+
 NTSTATUS libnet_rpc_usermod_recv(struct composite_context *c, TALLOC_CTX *mem_ctx,
 				 struct libnet_rpc_usermod *io)
 {
@@ -674,6 +706,15 @@
 }
 
 
+/**
+ * Synchronous version of usermod call
+ *
+ * @param pipe dce/rpc call pipe
+ * @param mem_ctx memory context for the call
+ * @param io arguments and results of the call
+ * @return nt status code of execution
+ */
+
 NTSTATUS libnet_rpc_usermod(struct dcerpc_pipe *pipe,
 			    TALLOC_CTX *mem_ctx,
 			    struct libnet_rpc_usermod *io)