From owner-svn-src-user@FreeBSD.ORG  Fri Jan  8 10:15:11 2010
Return-Path: <owner-svn-src-user@FreeBSD.ORG>
Delivered-To: svn-src-user@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 836FF1065694;
	Fri,  8 Jan 2010 10:15:11 +0000 (UTC) (envelope-from ed@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 73DAE8FC18;
	Fri,  8 Jan 2010 10:15:11 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o08AFBVr042161;
	Fri, 8 Jan 2010 10:15:11 GMT (envelope-from ed@svn.freebsd.org)
Received: (from ed@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id o08AFBgo042159;
	Fri, 8 Jan 2010 10:15:11 GMT (envelope-from ed@svn.freebsd.org)
Message-Id: <201001081015.o08AFBgo042159@svn.freebsd.org>
From: Ed Schouten <ed@FreeBSD.org>
Date: Fri, 8 Jan 2010 10:15:11 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-user@freebsd.org
X-SVN-Group: user
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r201780 - user/ed/utmpx/include
X-BeenThere: svn-src-user@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the experimental &quot; user&quot;
	src tree" <svn-src-user.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-user>,
	<mailto:svn-src-user-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-user>
List-Post: <mailto:svn-src-user@freebsd.org>
List-Help: <mailto:svn-src-user-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-user>,
	<mailto:svn-src-user-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 08 Jan 2010 10:15:11 -0000

Author: ed
Date: Fri Jan  8 10:15:11 2010
New Revision: 201780
URL: http://svn.freebsd.org/changeset/base/201780

Log:
  Document the definitions in <utmpx.h>.

Modified:
  user/ed/utmpx/include/utmpx.h

Modified: user/ed/utmpx/include/utmpx.h
==============================================================================
--- user/ed/utmpx/include/utmpx.h	Fri Jan  8 10:14:27 2010	(r201779)
+++ user/ed/utmpx/include/utmpx.h	Fri Jan  8 10:15:11 2010	(r201780)
@@ -39,34 +39,35 @@ typedef	__pid_t		pid_t;
 #endif
 
 struct utmpx {
-	char		ut_user[32];
-	char		ut_id[8];
-	char		ut_line[32];
+	char		ut_user[32];	/* User login name. */
+	char		ut_id[8];	/* Process identifier. */
+	char		ut_line[32];	/* Device name. */
 #if __BSD_VISIBLE
-	char		ut_host[128];
+	char		ut_host[128];	/* Remote hostname. */
 #else
 	char		__ut_host[128];
 #endif
-	pid_t		ut_pid;
-	short		ut_type;
-#define	EMPTY		0
-#define	BOOT_TIME	1
-#define	OLD_TIME	2
-#define	NEW_TIME	3
-#define	USER_PROCESS	4
-#define	INIT_PROCESS	5
-#define	LOGIN_PROCESS	6
-#define	DEAD_PROCESS	7
+	pid_t		ut_pid;		/* Process ID. */
+	short		ut_type;	/* Type of entry. */
+	struct timeval	ut_tv;		/* Time entry was made. */
+};
+
+#define	EMPTY		0	/* No valid user accounting information. */
+#define	BOOT_TIME	1	/* Time of system boot. */
+#define	OLD_TIME	2	/* Time when system clock changed. */
+#define	NEW_TIME	3	/* Time after system clock changed. */
+#define	USER_PROCESS	4	/* A process. */
+#define	INIT_PROCESS	5	/* A process spawned by the init process. */
+#define	LOGIN_PROCESS	6	/* The session leader of a logged-in user. */
+#define	DEAD_PROCESS	7	/* A session leader who has exited. */
 #if __BSD_VISIBLE
-#define	SHUTDOWN_TIME	8
+#define	SHUTDOWN_TIME	8	/* Time of system shutdown. */
 #endif
-	struct timeval	ut_tv;
-};
 
 #if __BSD_VISIBLE
-#define	UTXDB_ACTIVE	0
-#define	UTXDB_LASTLOGIN	1
-#define	UTXDB_LOG	2
+#define	UTXDB_ACTIVE	0	/* Active login sessions. */
+#define	UTXDB_LASTLOGIN	1	/* Last login sessions. */
+#define	UTXDB_LOG	2	/* Log indexed by time. */
 #endif
 
 __BEGIN_DECLS