NAME

nisupdkeys − update the public keys in a NIS+ directory object

SYNOPSIS

/usr/lib/nis/nisupdkeys [ −a | −C ] [ −H host ] [ directory ]

DESCRIPTION

This command updates the public keys in an NIS+ directory object.  When the public key for a NIS+ server is changed, the new key must be propagated to all directory objects that reference that server. This command accomplishes that. 

nisupdkeys reads a directory object and attempts to get the public key for each server of that directory.  These keys are placed in the directory object and the object is then modified to reflect the new keys. 

If directory is present, the directory object for that directory is updated.  Otherwise the directory object for the default domain is updated. 

Before you do this operation, make sure that the new address/public key has been propagated to all replicas. 

OPTIONS

−a Update the universal addresses of the NIS+ servers in the directory object.  Currently, this only works for the TCP/IP family of transports.  This option should be used when the IP address of the server is changed.  The server’s new address is resolved using gethostbyname(3N) on this machine.  The /etc/nsswitch.conf file must point to the correct source for the hosts entry for this resolution to work. 

−C Specify to clear rather than set the public key.  Communication with a server that has no public key does not require the use of secure RPC. 

−H host Limit key changes only to the server named host. If the hostname is not a fully qualified NIS+ name, then it is assumed to be a host in the default domain.  If the named host does not serve the directory, no action is taken. 

EXAMPLES

The following example updates the keys for servers of the foo.bar.  domain. 

example% nisupdkeys foo.bar. 

This example updates the key for host fred which serves the foo.bar.  domain. 

example% nisupdkeys −H fred foo.bar. 

This example clears the public key for host wilma in the foo.bar.  directory. 

example% nisupdkeys −CH wilma foo.bar. 

SEE ALSO

chkey(1), niscat(1), nisaddcred(1M), gethostbyname(3N), nis_objects(3N)

NOTES

The user executing this command must have modify access to the directory object for it to succeed. The existing directory object can be displayed with the niscat(1) command using the −o option. 

This command does not update the directory objects stored in the NIS_COLD_START file on the NIS+ clients. 

Sun Microsystems  —  Last change: 22 Feb 1993