Issue #7876 has been updated by Ben Hughes.

Status changed from Unreviewed to Accepted
Assignee set to Ken Barber

Well volunteered! (:

Added Captain Documentation Nick as a watcher so he can chime in.
----------------------------------------
Bug #7876: system attribute documentation in 'user' type is ambiguous
https://projects.puppetlabs.com/issues/7876

Author: Ken Barber
Status: Accepted
Priority: Normal
Assignee: Ken Barber
Category: documentation
Target version: 
Affected Puppet version: 2.7.0rc3
Keywords: 
Branch: 


In the reference documentation for the 'user' type:

http://docs.puppetlabs.com/references/stable/type.html#user-3

There is a 'system' attribute which is described as:

Whether the user is a system user with lower UID. Valid values are true, false.

The problem - is that this documentation can be misleading to the real 
behaviour. It may lead people to consider that this attribute is mandatory to 
create users within the SYS_UID_* range from login.defs. This is simply not 
true by default on all systems:

<pre>
useradd foo1 -u 172
useradd foo2 -u 173 -r 
</pre>

Both examples work fine - the only difference being (on Debian) that the 
password aging information is not added and the gid is also within the system 
range.

I think explaining that this maps to the '-r' function might be wiser ... or at 
least talking about what it _really_ does is a better thing?


-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to