Bug 87936 - Handbook chapter on NIS/YP lacks good information on adding new users
Summary: Handbook chapter on NIS/YP lacks good information on adding new users
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-10-24 19:00 UTC by Fernan Aguero
Modified: 2018-01-03 05:16 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Fernan Aguero 2005-10-24 19:00:27 UTC
	

	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.
	http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-nis.html

	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
	information confusing. 

	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
	NIS clients).
	
	See these threads for the kind of confusion that arises:
	http://docs.freebsd.org/cgi/getmsg.cgi?fetch=919628+0+archive/2002/freebsd-questions/20021124.freebsd-questions
	http://docs.freebsd.org/cgi/getmsg.cgi?fetch=71924+0+archive/1999/freebsd-isp/19990711.freebsd-isp
	
	Perhaps a note could be added clarifying this and mentioning the
	possible use of 'pw -V /var/yp' when adding new users?
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 08:01:01 UTC
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