From owner-freebsd-doc  Wed Aug 19 04:20:06 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id EAA26577
          for freebsd-doc-outgoing; Wed, 19 Aug 1998 04:20:06 -0700 (PDT)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA26567
          for <doc@FreeBSD.ORG>; Wed, 19 Aug 1998 04:20:05 -0700 (PDT)
          (envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.8.8/8.8.5) id EAA07913;
	Wed, 19 Aug 1998 04:20:01 -0700 (PDT)
Received: (from nobody@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id EAA26254;
          Wed, 19 Aug 1998 04:15:36 -0700 (PDT)
          (envelope-from nobody)
Message-Id: <199808191115.EAA26254@hub.freebsd.org>
Date: Wed, 19 Aug 1998 04:15:36 -0700 (PDT)
From: nick.hibma@jrc.it
To: freebsd-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: www-1.0
Subject: docs/7679: NIS man pages are incomplete
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         7679
>Category:       docs
>Synopsis:       NIS man pages are incomplete
>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:   Wed Aug 19 04:20:01 PDT 1998
>Last-Modified:
>Originator:     Nick Hibma
>Organization:
Joint Research Centre
>Release:        2.2.5/2.2.6
>Environment:
n/a

>Description:
The manpages of the NIS server ypserv could be more complete wqith respect to the installation of the server

Especially that remark about the copying of files should be mentioned    
somewhere in the manpages because it is non-trivial. 

The section below could be added (after spell checking and man-ification)
just before the NOTES section or as the first entry in the NOTES section.
>How-To-Repeat:
man ypserv
>Fix:
INSTALLATION
  
        Master Server
  
        Create a directory <domainname>, like 'foo.bar' in the directory
        specified as the path, normally /var/yp. Specify in the 'all'   
        rule in the Makefile in /var/yp the files you want to be handled   
        by ypserv. Perform a 'make' to see which files it cannot yet 
        find. Create these files in the directory 'foo.bar' and type    
        make again to see which other files it misses.
  
        Create a file securenets as described below.
  
        Then start the ypserver up with the command 'ypserv'. Set the   
        domainname with 'domainname foo.bar'. You should now be able to
        bind to this domain by executing the command 
        'ypbind -S foo.bar,<servername>'. To see the server you are 
        bound to use the command ypwhich.
  
        Do a make again in the directory /var/yp to push the files to
        the local NIS server.
  
  
        Slave server
  
        Create a directory '/var/yp/<domainname>' and copy by hand the
        files from the same directory on the master server. This is
        necessary to get the initial maps there.
  
	Start the NIS server with the command 'ypserv'. Add the name
	of the slave server to the list of NIS servers in the file
	/var/yp/ypservers and do a make in the directory /var/yp on the
	master server. This should produce an updated version of the database
	in the /var/yp/foo.bar directory on the slave.

...

SEE ALSO
	...
	vipw(8)
	aliases(5)
	bootparams(5)
	ethers(5)
	netgroup(5)
	networks(5)
	hosts(5)
	protocols(5)
	rpc(5)
	services(5)
	group(5)
	ypservers
	amd(8)
	mknetid(8)
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message