Logged-In As
ACCOUNT
Not Logged In
Describe the format of usermgmt.conf The NetBSD Project
Status: Closed Time to complete: 24 hrs Mentors: Julian Coleman, Julian Fagir Tags: man, system

The file usermgmt.conf contains default values used by user management tools (like useradd(8)).

But currently, the manpage usermgmt.conf(5) contains only a description of the fields, but not the format of the file itself. So review code about what is possible (spaces, tabs, etc.) and create an EXAMPLE section.

Our preferred format for the submission is some form of plain text, as that is most portable and can be read anywhere.  If you want to use a word processor, please export the file as text.

Uploaded Work
File name/URL File size Date submitted
usermgmt.conf.5.syntax.txt 399 bytes December 05 2012 00:05 UTC
usermgmt.conf.5 4.9 KB December 05 2012 00:06 UTC
usermgmt.conf.5.diff 375 bytes December 05 2012 00:06 UTC
usermgmt.conf.5 5.0 KB December 05 2012 00:18 UTC
usermgmt.conf.5.diff 540 bytes December 05 2012 00:18 UTC
usermgmt.conf.5 5.0 KB December 05 2012 01:55 UTC
usermgmt.conf.5.diff 508 bytes December 05 2012 01:55 UTC
Comments
Matthew on December 2 2012 04:21 UTC Task Claimed

I would like to work on this task.

Matthew on December 2 2012 05:17 UTC Basic SYNTAX Section

Here's a basic syntax section based upon user.c's source. IS it acceptable or do I need more?


 


NAME


     usermgmt.conf — user management tools configuration file


 


SYNOPSIS


     usermgmt.conf


 


SYNTAX


     The usermgmt.conf file has a simple syntax format:


 


     Each line must contain one option.


 


     The 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 


 


DESCRIPTION


     The usermgmt.conf file defines the default values used by the


     user management tools, useradd(8) and friends.


 


     Options in this file can be set by manually editing


     /etc/usermgmt.conf or using the -D option to useradd(8).


 


     base_dir   sets the base directory name, in which new users'


                home directories are created when using the -m


                option to useradd(8).


 


     class      sets the default login class for new users.  See


                login.conf(5) for more information on user login


                classes.


 


     expire     sets the default time at which the current password


                expires.  This can be used to implement password


                aging.  Both the expire and inactive fields should


                be entered in the form “month day year”, where month


                is the month name (the first three characters are


                sufficient), day is the day of the month, and year


                is the year.  Time in seconds since the epoch (UTC)


                is also valid.  A value of 0 can be used to disable


                this feature.


 


     group      sets the default primary group for new users.  If


                this is ‘=uid’, then a uid and gid will be picked


                which are both unique and the same, and a line will


                be added to /etc/group to describe the new group.


                It has the format:


                      group gid | name | =uid


 


     homeperm   sets the default permissions of the newly created


                home directory if -m is given to useradd(8).  The


                permission is specified as an octal number, with or


                without a leading zero.


 


     inactive   sets the default time at which new accounts expire.


                A value of 0 can be used to disable this feature.


                Also see the expire field.


 


     password   specifies an already-encrypted default password.


 


     preserve   If this value is one of ‘true’, ‘yes’, or a non-zero


                number, then the user login information will be


                preserved when removing a user with userdel(8).


 


     range      specifies the uid boundaries for new users.  If


                unspecified, the default is “1000..60000”.  It has


                the format:


                      range starting-uid..ending-uid


 


     gid_range  specifies the gid boundaries for new groups.  If


                unspecified, the default is “1000..60000”.  It has


                the format:


                      gid_range starting-gid..ending-gid


 


     shell      sets the default login shell for new users.


 


     skel_dir   sets the default skeleton directory in which to find


                files with which to populate the new user's home


                directory.


 


FILES


     /etc/usermgmt.conf


     /etc/skel/*


     /etc/login.conf


 


SEE ALSO


     login.conf(5), passwd(5), user(8), useradd(8), userdel(8),


     usermod(8)


 


HISTORY


     The usermgmt.conf configuration file first appeared in


     NetBSD 1.5.

Matthew on December 2 2012 05:19 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

Julian Fagir on December 2 2012 16:34 UTC Why did you remove the claim?

Why did you remove the claim?


Your only task now would be to write this down in mdoc. Now you only have to take this file:  http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/user/usermgmt.conf.5 and modify it. 

Georgi Tsanev on December 3 2012 14:47 UTC Task Claimed

I would like to work on this task.

Julian Fagir on December 3 2012 15:49 UTC Suspended

I'm sorry, but this task is suspended for now until Matthew will respond. Matthew solved the task, but then removed the claim.

Julian Fagir on December 3 2012 15:49 UTC Task Reopened

This task has been Reopened.

Matthew on December 4 2012 23:14 UTC Task Claimed

I would like to work on this task.

Julian Fagir on December 4 2012 23:20 UTC Task Assigned

This task has been assigned to Matthew. You have 24 hours to complete this task, good luck!

Matthew on December 5 2012 00:18 UTC Ready for review

The work on this task is ready to be reviewed.

Matthew on December 5 2012 22:45 UTC Rereview

Sorry about that - I didn't realize I had not sanatized the tabs.


But I've uploaded the new one (the latest usermgmt.conf.5 file) which fixes that and other issues.


 


I'm not sure what happens - but I've only got about 30 minutes left on the clock - I hope to have it review by then.

Melange on December 5 2012 23:20 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Julian Fagir on December 6 2012 00:46 UTC Deadline extended

The deadline of the task has been extended with 1 days and 12 hours.

Julian Fagir on December 6 2012 00:50 UTC Task Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Matthew on December 6 2012 01:07 UTC Ready for review

The work on this task is ready to be reviewed.

Julian Fagir on December 6 2012 23:52 UTC This is fine

Ok, the manpage is fine, thank you!

Julian Fagir on December 6 2012 23:52 UTC Task Closed

Congratulations, this task has been completed successfully.