NetBSD Problem Report #50787

From www@NetBSD.org  Tue Feb  9 04:48:03 2016
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.NetBSD.org [199.233.217.200])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.netbsd.org", Issuer "Postmaster NetBSD.org" (verified OK))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 834227A21A
	for <gnats-bugs@gnats.NetBSD.org>; Tue,  9 Feb 2016 04:48:03 +0000 (UTC)
Message-Id: <20160209044802.282DF7ACB7@mollari.NetBSD.org>
Date: Tue,  9 Feb 2016 04:48:02 +0000 (UTC)
From: Tr@visPaul.me
Reply-To: Tr@visPaul.me
To: gnats-bugs@NetBSD.org
Subject: Describe the format of usermgmt.conf
X-Send-Pr-Version: www-1.0

>Number:         50787
>Category:       misc
>Synopsis:       Describe the format of usermgmt.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          closed
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Tue Feb 09 04:50:00 +0000 2016
>Closed-Date:    Tue Feb 09 14:14:24 +0000 2016
>Last-Modified:  Tue Feb 09 14:15:00 +0000 2016
>Originator:     Travis Paul
>Release:        current
>Organization:
>Environment:
NetBSD kagato.netverb.com 7.99.26 NetBSD 7.99.26 (kagato) #0: Sun Feb  7 11:33:50 EST 2016  tpaul@kagato.netverb.com:/build/obj/sys/arch/amd64/compile/kagato amd64

>Description:
While trying to figure out the format for usermgmt.conf I came across a 2012 Google Code-In task which had added a syntax example to the usermgmt.conf manpage:
https://www.google-melange.com/gci/task/view/google/gci2012/7958203

Patch below is taken from the diff submitted by Matthew Bauer, tested with man from current.
>How-To-Repeat:
The manpage for usermgmt.conf doesn't describe the configuration file format.
>Fix:
Index: usermgmt.conf.5
===================================================================
RCS file: /cvsroot/src/usr.sbin/user/usermgmt.conf.5,v
retrieving revision 1.7
diff -u -r1.7 usermgmt.conf.5
--- usermgmt.conf.5     31 Dec 2009 20:14:19 -0000      1.7
+++ usermgmt.conf.5     9 Feb 2016 04:36:04 -0000
@@ -135,6 +135,22 @@
 sets the default skeleton directory in which to find files
 with which to populate the new user's home directory.
 .El
+.Sh SYNTAX 
+The
+.Nm usermgmt.conf
+file uses a simple syntax format.
+Each line must contain one option.
+That option must be in the front of the line (no spaces).
+Any number of white spaces such as ' ' and '\\t' may follow.
+The line ends with a list of options from each.
+.Sh EXAMPLE
+.Bd -unfilled -offset indent -compact
+group     wheel
+base_dir  /home/
+skel_dir  /etc/skel
+shell     /bin/sh
+inactive  0
+.Ed
 .Sh FILES
 .Bl -tag -width /etc/usermgmt.conf -compact
 .It Pa /etc/usermgmt.conf

>Release-Note:

>Audit-Trail:

State-Changed-From-To: open->closed
State-Changed-By: wiz@NetBSD.org
State-Changed-When: Tue, 09 Feb 2016 14:14:24 +0000
State-Changed-Why:
Thanks, committed with slight changes.


From: "Thomas Klausner" <wiz@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/50787 CVS commit: src/usr.sbin/user
Date: Tue, 9 Feb 2016 14:14:02 +0000

 Module Name:	src
 Committed By:	wiz
 Date:		Tue Feb  9 14:14:02 UTC 2016

 Modified Files:
 	src/usr.sbin/user: usermgmt.conf.5

 Log Message:
 Document file format better. From Travis Paul and Matthew Bauer.

 Bump date.
 Addresses PR 50787.


 To generate a diff of this commit:
 cvs rdiff -u -r1.7 -r1.8 src/usr.sbin/user/usermgmt.conf.5

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

>Unformatted:

Home	PR Database Search