svn commit: samba r12359 - in trunk/source/utils: .

[jra at samba.org]

Author: jra
Date: 2005-12-19 05:46:58 +0000 (Mon, 19 Dec 2005)
New Revision: 12359

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

Log:
Add comments.
Jeremy.

Modified:
   trunk/source/utils/netlookup.c


Changeset:
Modified: trunk/source/utils/netlookup.c
===================================================================
--- trunk/source/utils/netlookup.c	2005-12-19 05:42:58 UTC (rev 12358)
+++ trunk/source/utils/netlookup.c	2005-12-19 05:46:58 UTC (rev 12359)
@@ -23,6 +23,10 @@
 #include "includes.h"
 #include "utils/net.h"
 
+/********************************************************
+ Connection cachine struct. Goes away when ctx destroyed.
+********************************************************/
+
 struct con_struct {
 	BOOL failed_connect;
 	struct cli_state *cli;
@@ -32,6 +36,10 @@
 
 static struct con_struct *cs;
 
+/********************************************************
+ Close connection on context destruction.
+********************************************************/
+
 static int cs_destructor(void *p)
 {
 	if (cs->cli) {
@@ -41,6 +49,10 @@
 	return 0;
 }
 
+/********************************************************
+ Create the connection to localhost.
+********************************************************/
+
 static struct con_struct *create_cs(TALLOC_CTX *ctx)
 {
 	NTSTATUS nt_status;
@@ -108,6 +120,10 @@
 	return cs;
 }
 
+/********************************************************
+ Do a lookup_sids call to localhost.
+********************************************************/
+
 static BOOL lookup_name_from_sid_via_localhost(TALLOC_CTX *ctx,
 						DOM_SID *psid,
 						const char **ppdomain,
@@ -148,6 +164,10 @@
         return True;
 }
 
+/********************************************************
+ Do a lookup_sids call to winbindd.
+********************************************************/
+
 static BOOL lookup_name_from_sid_via_winbind(TALLOC_CTX *ctx,
 						DOM_SID *psid,
 						const char **ppdomain,
@@ -172,6 +192,10 @@
 	return True;
 }
 
+/********************************************************
+ The generic lookup name from sid call for net.
+********************************************************/
+
 BOOL net_lookup_name_from_sid(TALLOC_CTX *ctx, DOM_SID *psid, const char **ppdomain, const char **ppname)
 {
 	uint32 sidtype;
@@ -201,6 +225,10 @@
 	return False;
 }
 
+/********************************************************
+ The generic lookup sid from name call for net.
+********************************************************/
+
 BOOL net_lookup_sid_from_name(TALLOC_CTX *ctx, const char *domain, const char *name, DOM_SID *pret_sid)
 {
 	return False;