r6677: Unused variables.

[samba.git] / source / libnet / userman.c

diff --git a/source/libnet/userman.c b/source/libnet/userman.c
index 6724206b2ebe7e302fe68ecc2c25bc57e5309d9b..1bba0ff718441a86b77182dbc0ebd52729ce66ad 100644 (file)
--- a/source/libnet/userman.c
+++ b/source/libnet/userman.c
@@ -95,12 +95,12 @@ static void useradd_handler(struct rpc_request *req)
  * @param p dce/rpc call pipe 
  * @param io arguments and results of the call
  */
+
 struct composite_context *rpc_composite_useradd_send(struct dcerpc_pipe *p,
                                                     struct rpc_composite_useradd *io)
 {
        struct composite_context *c;
        struct useradd_state *s;
-       struct dom_sid *sid;
        
        c = talloc_zero(p, struct composite_context);
        if (c == NULL) goto failure;
@@ -141,7 +141,7 @@ failure:
 /**
  * Waits for and receives result of asynchronous useradd call
  * 
- * @param c composite context returned by asynchronous userinfo call
+ * @param c composite context returned by asynchronous useradd 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
@@ -185,7 +185,7 @@ NTSTATUS rpc_composite_useradd(struct dcerpc_pipe *pipe,
 
 
 /*
- * Composite user del function
+ * Composite user delete function
  */
 
 static void userdel_handler(struct rpc_request*);
@@ -204,6 +204,9 @@ struct userdel_state {
 };
 
 
+/**
+ * Stage 1: Lookup the user name and resolve it to rid
+ */
 static NTSTATUS userdel_lookup(struct composite_context *c,
                               struct userdel_state *s)
 {
@@ -239,11 +242,12 @@ failure:
 }
 
 
+/**
+ * Stage 2: Open user account.
+ */
 static NTSTATUS userdel_open(struct composite_context *c,
                             struct userdel_state *s)
 {
-       NTSTATUS status = NT_STATUS_UNSUCCESSFUL;
-       
        c->status = dcerpc_ndr_request_recv(s->req);
        NT_STATUS_NOT_OK_RETURN(c->status);
        
@@ -260,11 +264,12 @@ static NTSTATUS userdel_open(struct composite_context *c,
 }
 
 
+/**
+ * Stage 3: Delete user account
+ */
 static NTSTATUS userdel_delete(struct composite_context *c,
                               struct userdel_state *s)
 {
-       NTSTATUS status = NT_STATUS_UNSUCCESSFUL;
-       
        c->status = dcerpc_ndr_request_recv(s->req);
        NT_STATUS_NOT_OK_RETURN(c->status);
        
@@ -274,6 +279,12 @@ static NTSTATUS userdel_delete(struct composite_context *c,
 }
 
 
+/**
+ * Event handler for asynchronous request. Handles transition through
+ * intermediate stages of the call.
+ *
+ * @param req rpc call context
+ */
 static void userdel_handler(struct rpc_request *req)
 {
        struct composite_context *c = req->async.private;
@@ -302,6 +313,13 @@ static void userdel_handler(struct rpc_request *req)
 }
 
 
+/**
+ * Sends asynchronous userdel request
+ *
+ * @param p dce/rpc call pipe
+ * @param io arguments and results of the call
+ */
+
 struct composite_context *rpc_composite_userdel_send(struct dcerpc_pipe *p,
                                                     struct rpc_composite_userdel *io)
 {
@@ -314,18 +332,23 @@ struct composite_context *rpc_composite_userdel_send(struct dcerpc_pipe *p,
        s = talloc_zero(c, struct userdel_state);
        if (s == NULL) goto failure;
 
-       s->pipe = p;
        c->state      = SMBCLI_REQUEST_SEND;
        c->private    = s;
        c->event_ctx  = dcerpc_event_context(p);
 
+       s->pipe          = p;
+       s->domain_handle = io->in.domain_handle;
+       
+       /* preparing parameters to send rpc request */
        s->lookupname.in.domain_handle = &io->in.domain_handle;
        s->lookupname.in.num_names     = 1;
        s->lookupname.in.names         = talloc_zero(s, struct samr_String);
        s->lookupname.in.names->string = io->in.username;
 
+       /* send the request */
        s->req = dcerpc_samr_LookupNames_send(p, c, &s->lookupname);
-       
+
+       /* callback handler */
        s->req->async.callback = userdel_handler;
        s->req->async.private  = c;
        s->stage = USERDEL_LOOKUP;
@@ -338,6 +361,15 @@ failure:
 }
 
 
+/**
+ * Waits for and receives results of asynchronous userdel call
+ *
+ * @param c composite context returned by asynchronous userdel 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 rpc_composite_userdel_recv(struct composite_context *c, TALLOC_CTX *mem_ctx,
                                    struct rpc_composite_userdel *io)
 {
@@ -356,6 +388,15 @@ NTSTATUS rpc_composite_userdel_recv(struct composite_context *c, TALLOC_CTX *mem
 }
 
 
+/**
+ * Synchronous version of userdel 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 rpc_composite_userdel(struct dcerpc_pipe *pipe,
                               TALLOC_CTX *mem_ctx,
                               struct rpc_composite_userdel *io)