From owner-freebsd-doc@FreeBSD.ORG Mon Oct 24 18:00:35 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EC79C16A41F for ; Mon, 24 Oct 2005 18:00:34 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DB89F43D4C for ; Mon, 24 Oct 2005 18:00:30 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j9OI0Ug1025773 for ; Mon, 24 Oct 2005 18:00:30 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j9OI0UOY025772; Mon, 24 Oct 2005 18:00:30 GMT (envelope-from gnats) Resent-Date: Mon, 24 Oct 2005 18:00:30 GMT Resent-Message-Id: <200510241800.j9OI0UOY025772@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Fernan Aguero Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EBCD116A41F for ; Mon, 24 Oct 2005 17:56:31 +0000 (GMT) (envelope-from fernan@pi.iib.unsam.edu.ar) Received: from smtp.unsam.edu.ar (smtp.unsam.edu.ar [170.210.48.3]) by mx1.FreeBSD.org (Postfix) with ESMTP id B59D443D64 for ; Mon, 24 Oct 2005 17:56:25 +0000 (GMT) (envelope-from fernan@pi.iib.unsam.edu.ar) Received: from pi.iib.unsam.edu.ar (pi.iib.unsam.edu.ar [192.168.10.11]) by smtp.unsam.edu.ar (8.12.6/8.12.6) with ESMTP id j9OHtU7Z058052 for ; Mon, 24 Oct 2005 14:55:30 -0300 (ART) (envelope-from fernan@pi.iib.unsam.edu.ar) Received: from pi.iib.unsam.edu.ar (localhost [127.0.0.1]) by pi.iib.unsam.edu.ar (8.13.1/8.13.1) with ESMTP id j9OHtjVv051143 for ; Mon, 24 Oct 2005 14:55:45 -0300 (ART) (envelope-from fernan@pi.iib.unsam.edu.ar) Received: (from fernan@localhost) by pi.iib.unsam.edu.ar (8.13.1/8.13.1/Submit) id j9OHtjFl051142; Mon, 24 Oct 2005 14:55:45 -0300 (ART) (envelope-from fernan) Message-Id: <200510241755.j9OHtjFl051142@pi.iib.unsam.edu.ar> Date: Mon, 24 Oct 2005 14:55:45 -0300 (ART) From: Fernan Aguero To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/87936: Chapter on NIS/YP lacks good information on adding new users X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Fernan Aguero List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Oct 2005 18:00:35 -0000 >Number: 87936 >Category: docs >Synopsis: Chapter on NIS/YP lacks good information on adding new users >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Oct 24 18:00:27 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Fernan Aguero >Release: FreeBSD 4.10-RELEASE i386 >Organization: IIB-UNSAM >Environment: FreeBSD pi.iib.unsam.edu.ar 4.10-RELEASE FreeBSD 4.10-RELEASE #0: Wed May 26 12:56:43 ART 2004 fernan@pi.iib.unsam.edu.ar:/usr/obj/usr/src/sys/PI i386 >Description: 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? >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: