Manual Pages for UNIX Operating System command usage for man lgrp_cookie_stale

Locality Group Library Functions         lgrp_cookie_stale(3LGRP)



NAME
     lgrp_cookie_stale - determine  whether  snapshot  of  lgroup
     hierarchy is stale

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

     int lgrp_cookie_stale(lgrp_cookie_t cookie);


DESCRIPTION
     The lgrp_cookie_stale() function takes a cookie representing
     the   snapshot   of   the  lgroup  hierarchy  obtained  from
     lgrp_init(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
     LGRP_VIEW_OS,  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 LGRP_VIEW_CALLER 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, lgrp_fini(3LGRP) should
     be  called  with  the  old  cookie and lgrp_init() should be
     called to obtain a new snapshot.

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

ERRORS
     The lgrp_cookie_stale() function will fail if:

     EINVAL    The cookie is not valid.


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












SunOS 5.11          Last change: 16 Apr 2003                    1






Locality Group Library Functions         lgrp_cookie_stale(3LGRP)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     lgrp_init(3LGRP),    lgrp_fini(3LGRP),     lgrp_view(3LGRP),
     liblgrp(3LIB), attributes(5)











































SunOS 5.11          Last change: 16 Apr 2003                    2