Section 4 of Chapter 24 of the FreeBSD Handbook describes the
NIS/YP system and guides users on setting up NIS master servers,
slave servers and clients.
However, upon trying to follow the instructions on the handbook,
it is apparent that some information regarding the addition of
new users is lacking.
After having set up NIS (at least a master server and a client),
there is a section on 'Important things to remember' that
address the issue of adding new users. I've found this
It correctly tells you that you should only add new users to the
master NIS server. But it does not tell you WHERE you should add
the new users. Should you use vipw and edit /etc/master.passwd?
Or should you edit /var/yp/master.passwd? The answer is obvious
for any experienced NIS user, but it's not for someone who has
not used NIS before.
Also, the example that follows seems to be misleading (pw useradd
jsmith ...) If you run it without modification the new user
would not be allowed to log in into NIS clients (i.e. it will
not be propagated). This is because the new user will be added
to /etc/master.passwd, while /var/yp/master.passwd will remain
unchanged. This works only if you want to add new 'local' users.
The chapter lacks information regarding how to create new
'network' users (those that will be allowed to log in into other
See these threads for the kind of confusion that arises:
Perhaps a note could be added clarifying this and mentioning the
possible use of 'pw -V /var/yp' when adding new users?
For bugs matching the following criteria:
Status: In Progress Changed: (is less than) 2014-06-01
Reset to default assignee and clear in-progress tags.
Mail being skipped