Networking Services Library Functions              nisping(3NSL)



NAME
     nisping, nischeckpoint - NIS] log administration functions

SYNOPSIS
     cc [ flag ... ] file ... -lnsl [ library ... ]
     #include 



     void nisping(nisname dirname, uint32t utime, nisobject *dirobj);


     nisresult *nischeckpoint(nisname dirname);


DESCRIPTION
     nisping() is called by the master server  for  a  directory
     when a change has occurred within that directory. The param-
     eter dirname identifies the directory with  the  change.  If
     the  parameter  dirobj  is  NUL, this function looks up the
     directory object for dirname and uses the list  of  replicas
     it  contains.  The parameter utime contains the timestamp of
     the last change made to the  directory.  This  timestamp  is
     used  by  the  replicas  when retrieving updates made to the
     directory.


     The effect of calling nisping() is to schedule an update on
     the  replica.  A  short time after a ping is received, typi-
     cally about two  minutes,  the  replica  compares  the  last
     update  time  for its databases to the timestamp sent by the
     ping. If the ping timestamp is  later,  the  replica  estab-
     lishes  a connection with the master  server and request all
     changes from the log that occurred  after  the  last  update
     that it had recorded in its local log.


     nischeckpoint() is used to force the service to  checkpoint
     information  that  has  been  entered in the log but has not
     been checkpointed to disk. When called, this function check-
     points  the  database  for  each table in the directory, the
     database containing the directory and the  transaction  log.
     Care  should  be  used in calling this function since direc-
     tories that have seen a lot  of  changes  may  take  several
     minutes to checkpoint. During the checkpointing process, the
     service will be unavailable for updates for all  directories
     that are served by this machine as master.


     nischeckpoint() returns a pointer to  a  nisresult  struc-
     ture.  See  nistables(3NSL). This structure should be freed
     with  nisfreeresult(). See nisnames(3NSL). The only  items



SunOS 5.11          Last change: 10 Nov 2005                    1






Networking Services Library Functions              nisping(3NSL)



     of  interest in the returned result are the status value and
     the statistics.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     nislog(1M), nisnames(3NSL), nistables(3NSL),  nisfiles(4),
     attributes(5)

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.





























SunOS 5.11          Last change: 10 Nov 2005                    2