Forgot to put some more comments.

rafal
(This used to be commit b3efdcf0aeec5a115c53de8bbedaa9ca8225b689)

diff --git a/source3/utils/pdbedit.c b/source3/utils/pdbedit.c
index e744f359d360e02906549370fc051ad69c8aa2d5..af96413c5aecde7e84a7d0deccb174281f3b23d9 100644 (file)
--- a/source3/utils/pdbedit.c
+++ b/source3/utils/pdbedit.c
@@ -230,6 +230,13 @@ static int print_user_info (struct pdb_context *in, const char *username, BOOL v
 }
 
 
+/**
+ * Trust password flag name to flag conversion
+ *
+ * @param flag_name SAM_TRUST_PASSWD structure flag name
+ * @return flag value
+ **/
+
 static int trustpw_flag(const char* flag_name)
 {
        const int flag_num = 5;
@@ -251,6 +258,13 @@ static int trustpw_flag(const char* flag_name)
 }
 
 
+/**
+ * Trust password flag to flag name conversion
+ *
+ * @param val SAM_TRUST_PASSWD structure flag
+ * @return passed flag name
+ **/
+
 static char* trustpw_flag_name(const int val)
 {
        const int flag_num = 5;
@@ -272,6 +286,15 @@ static char* trustpw_flag_name(const int val)
 }
 
 
+/**
+ * Print trust password structure information
+ *
+ * @param mem_ctx memory context (for unicode name conversion)
+ * @param trust SAM_TRUST_PASSWD structure
+ * @param verbose verbose mode on/off
+ * @return 0 on success, otherwise failure
+ **/
+ 
 static int print_trustpw_info(TALLOC_CTX *mem_ctx, SAM_TRUST_PASSWD *trust, BOOL verbose)
 {
        char *dom_name;
@@ -297,6 +320,16 @@ static int print_trustpw_info(TALLOC_CTX *mem_ctx, SAM_TRUST_PASSWD *trust, BOOL
 }
 
 
+/**
+ * Print trust password information by given name
+ *
+ * @param in initialised pdb_context
+ * @param name domain name of the trust password
+ * @param verbose verbose mode on/off
+ * @param smbpwdstyle smbpassword-style output (ignored here)
+ * @return 0 on success, otherwise failure
+ **/
+ 
 static int print_trust_info(struct pdb_context *in, const char *name, BOOL verbose, BOOL smbpwdstyle)
 {
        SAM_TRUST_PASSWD trust;
@@ -340,6 +373,7 @@ static int print_users_list (struct pdb_context *in, BOOL verbosity, BOOL smbpwd
        return 0;
 }
 
+
 /**
  * List trust passwords
  *