nis_cachemgr(1M)

NAME

     nis_cachemgr - NIS+ utility to  cache  location  information
     about NIS+ servers

SYNOPSIS

     /usr/sbin/nis_cachemgr [-i] [-v]

DESCRIPTION

     The nis_cachemgr daemon maintains a cache of NIS+  directory
     objects  and  active servers for domains.  It is responsible
     for locating servers  for  a  domain  on  behalf  of  client
     processes.
      This improves performance because only one process  has  to
     search  for servers. The cache contains location information
     necessary to contact the NIS+ servers.  This includes  tran-
     sport  addresses,  information  neeeded  to authenticate the
     server, and a time to live field which gives a hint  on  how
     long  the directory object can be cached. The cache helps to
     improve the performance of the clients that  are  traversing
     the  NIS+ name space.  nis_cachemgr should be running on all
     the machines that  are  using  NIS+.   However,  it  is  not
     required  that  the nis_cachemgr program be running in order
     for NIS+ requests to be serviced.

     The cache maintained by this program is shared  by  all  the
     processes  that access NIS+ on a machine. The cache is main-
     tained in a file that is memory mapped by all the processes.
     See   mmap(2).  On  start  up,  nis_cachemgr initializes the
     cache from the  cold  start  file  and  preserves  unexpired
     entries   that   already  exist   in  the  cache  file.  See
     nisinit(1M). Thus, the cache survives machine reboots.

     The nis_cachemgr program is normally started from  a  system
     startup  script. nisshowcache(1M) can be used to look at the
     cached objects and active servers.

     The  nisprefadm(1M) command can be  used  to  control  which
     NIS+ servers the nis_cachemgr program will try to select.

     The nis_cachemgr program makes NIS+ requests under the  NIS+
     principal name of the host on which it runs.  Before running
     nis_cachemgr, security credentials for the  host  should  be
     added  to  the cred.org_dir table in the host's domain using
     nisaddcred(1M). Credentials of type DES will  be  needed  if
     the  NIS+  service  is  operating  at  security level 2 (see
     rpc.nisd(1M)). See the DIAGNOSTICS section, below. Addition-
     ally, a "keylogin -r " should be done on the machine.

OPTIONS

     -i    Force nis_cachemgr to ignore the previous  cache  file
           and  reinitialize  the  cache from just the cold start
           file.   By  default,  the  cache  manager  initializes
           itself from both the cold start file and the old cache
           file, thereby maintaining the  entries  in  the  cache
           across machine reboots.

     -v    This  flag  sets  verbose  mode.  In  this  mode,  the
           nis_cachemgr  program  logs  not only errors and warn-
           ings, but also additional status messages.  The  addi-
           tional  messages  are  logged  using syslog(3C) with a
           priority of  LOG_INFO.

FILES

     /var/nis/NIS_SHARED_DIRCACHE
           the shared cache file

     /var/nis/NIS_COLD_START
           the coldstart file

     /etc/init.d/rpc
           initialization scripts for NIS+

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     keylogin(1),  nisaddcred(1M),  nisinit(1M),  nisprefadm(1M),
     nisshowcache(1M),    rpc.nisd(1M),    mmap(2),    rpc(3NSL),
     syslog(3C), nisfiles(4), attributes(5)

DIAGNOSTICS

     The nis_cachemgr daemon logs  error  messages  and  warnings
     using   syslog(3C). Error messages are logged to the  DAEMON
     facility with a priority of  LOG_ERR . Warning messages  are
     logged  with  a  priority of  LOG_WARNING. Additional status
     messages can be obtained using the -v option.

NOTES

     NIS+ might not  be  supported  in  future  releases  of  the
     SolarisTM  Operating Environment. Tools to aid the migration
     from NIS+ to LDAP are available in the Solaris  9  operating
     environment.      For      more      information,      visit
     http://www.sun.com/directory/nisplus/transition.html.