Locality Group Library Functions         lgrpcookiestale(3LGRP)



NAME
     lgrpcookiestale - determine  whether  snapshot  of  lgroup
     hierarchy is stale

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

     int lgrpcookiestale(lgrpcookiet cookie);


DESCRIPTION
     The lgrpcookiestale() function takes a cookie representing
     the   snapshot   of   the  lgroup  hierarchy  obtained  from
     lgrpinit(3LGRP)  and  returns  whether  it  is  stale.  The
     snapshot  can  become  out-of-date  for  a number of reasons
     depending on its view.   If  the  snapshot  was  taken  with
     LGRPVIEWOS,  changes  in the lgroup hierarchy from dynamic
     reconfiguration, CPU on/offline,  or  other  conditions  can
     cause  the  snapshot to become out-of-date. A snapshot taken
     with LGRPVIEWCALER can be affected by the  caller's  pro-
     cessor  set binding and changes in its processor set itself,
     as well as changes in the lgroup hierarchy.


     If the snapshot needs to be updated, lgrpfini(3LGRP) should
     be  called  with  the  old  cookie and lgrpinit() should be
     called to obtain a new snapshot.

RETURN VALUES
     Upon  successful  completion,  lgrpcookiestale()   returns
     whether  the  cookie  is stale. Otherwise, it returns -1 and
     sets errno to indicate the error.

ERORS
     The lgrpcookiestale() function will fail if:

     EINVAL    The cookie is not valid.


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












SunOS 5.11          Last change: 16 Apr 2003                    1






Locality Group Library Functions         lgrpcookiestale(3LGRP)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     lgrpinit(3LGRP),    lgrpfini(3LGRP),     lgrpview(3LGRP),
     liblgrp(3LIB), attributes(5)











































SunOS 5.11          Last change: 16 Apr 2003                    2