Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

nis_cachemgr


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 pro-
     cess has to search for servers. The cache contains  location
     information  necessary  to  contact  the  NIS+ servers. This
     includes transport addresses, information neeeded to authen-
     ticate  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   section,  below.  Additionally,  a
     "keylogin -r " should be done on the machine.

     svc:/network/rpc/keyserv:default is required for NIS+ opera-
     tion. See NOTES.


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


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



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


SEE ALSO
     keylogin(1),    svcs(1),    nisaddcred(1M),     nisinit(1M),
     nisprefadm(1M),  nisshowcache(1M), rpc.nisd(1M), svcadm(1M),
     mmap(2), rpc(3NSL), syslog(3C), nisfiles(4),  attributes(5),
     smf(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
     Solaris  operating  system.  Tools to aid the migration from
     NIS+ to LDAP are available in the current  Solaris  release.
     For            more            information,            visit
     http://www.sun.com/directory/nisplus/transition.html.

     The nis_cachemgr service is managed by the  service  manage-
     ment facility, smf(5), under the service identifier:

       svc:/network/rpc/nisplus:default



     Administrative actions on this service,  such  as  enabling,
     disabling,  or  requesting  restart,  can be performed using
     svcadm(1M). The service's status can be  queried  using  the
     svcs(1) command.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments