yp_bootparam(1M)					      yp_bootparam(1M)

NAME    [Toc]    [Back]

     yp_bootparam - update the NIS bootparams database

SYNOPSIS    [Toc]    [Back]

     yp_bootparam -h host -a [ -b ] [ -k key_file ] -f file
     yp_bootparam -h host -a [ -b ] [ -k key_file ] params
     yp_bootparam -h host -d [ -b ] [ -k key_file ]

DESCRIPTION    [Toc]    [Back]

     yp_bootparam is the user interface	tool to	update the NIS bootparams(4)
     database directly on client workstation without running on	ypmaster.
     yp_bootparam uses the ypupdated(1M) service on ypmaster to	update the
     bootparams	database.

     User can either add an entry to database or delete	an entry.  As long as
     the hostname is registered	in the NIS hosts database and the bootparam
     entry does	not exist, the user can	always add an entry to the bootparams
     database.	In this	process, a security key	can be requested on return.
     When deleting an entry, the same key (if there is one) must be submitted
     in	the same command line.	Otherwise, the request is rejected.  The
     update daemon on ypmaster stores the keys in /var/boot/keystore, while
     yp_bootparam saves	the key	in the file specified by the input parameter.

OPTIONS    [Toc]    [Back]

     -h	host   Use host	as the key in bootparams database.  The	host is
	       checked against NIS hosts database unless -b is specified.  If
	       host is an alias, the real key found in hosts data base is used
	       instead.

     -a	       Add an entry.

     -d	       Remove an entry.

     -b	       Use host	as key without checking	NIS hosts database.

     -k	key_file
	       When adding an entry, the key_file is used to save the returned
	       key.  When deleting an entry, it	is used	to pass	the original
	       key.

     -f	file   The file	contains the data part in the bootparam	entry.	It
	       should have the following format:

		    root=root_server:root_path
		    sbin=share_server:sbin_path
		    swap=root_server:swap_path
		    dump=root_server:dump_path

	       The dump	value is optional.






									Page 1






yp_bootparam(1M)					      yp_bootparam(1M)



     params    If -f is	not used, the boot parameters should be	passed at
	       command level.

EXAMPLE    [Toc]    [Back]

	  yp_bootparam -a -h bonnie -k /mykey
	       root=clyde:/dl/client/bonnie sbin=clyde:/dl/share/sbin
	       swap=clyde:/dl/swap/bonnie

     Creates a bootparam entry in ypmaster.  The security key returned is left
     in	/mykey.

NOTE    [Toc]    [Back]

     After using yp_bootparam, it takes	a short	time for the NIS bootparams
     database, as seen by the client, to reflect the change.

CAVEAT    [Toc]    [Back]

     yp_bootparam does not communicate with non-SGI NIS	masters.

FILES    [Toc]    [Back]

     /var/yp/yp_bootparam
     /var/boot/keystore
     /usr/include/rpcsvc/ypclnt.h     error code listing

SEE ALSO    [Toc]    [Back]

     updbootparam(1M), ypupdated(1M), bootparams(4).


									PPPPaaaaggggeeee 2222