[Pkg-shadow-commits] r1570 - in upstream/trunk: . src

[nekral-guest at alioth.debian.org]

Author: nekral-guest
Date: 2007-12-31 14:03:14 +0000 (Mon, 31 Dec 2007)
New Revision: 1570

Modified:
   upstream/trunk/ChangeLog
   upstream/trunk/src/chfn.c
Log:
Document may_change_field().


Modified: upstream/trunk/ChangeLog
===================================================================
--- upstream/trunk/ChangeLog	2007-12-31 13:48:48 UTC (rev 1569)
+++ upstream/trunk/ChangeLog	2007-12-31 14:03:14 UTC (rev 1570)
@@ -7,6 +7,7 @@
 	* src/chfn.c: Before pam_end(), the return value of the previous
 	pam API was already checked. No need to validate it again.
 	* src/chfn.c: Avoid implicit brackets.
+	* src/chfn.c: Document may_change_field().
 
 2007-12-31  Nicolas François  <nicolas.francois at centraliens.net>
 

Modified: upstream/trunk/src/chfn.c
===================================================================
--- upstream/trunk/src/chfn.c	2007-12-31 13:48:48 UTC (rev 1569)
+++ upstream/trunk/src/chfn.c	2007-12-31 14:03:14 UTC (rev 1570)
@@ -105,7 +105,16 @@
 	exit (E_USAGE);
 }
 
-
+/*
+ * may_change_field - indicate if the user is allowed to change a given field
+ *                    of her gecos information
+ *
+ *	root can change any field.
+ *
+ *	field should be one of 'f', 'r', 'w', 'h'
+ *
+ *	Return 1 if the user can change the field and 0 otherwise.
+ */
 static int may_change_field (int field)
 {
 	const char *cp;