lgrp_cookie_stale(3LGRP) 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 <sys/lgrp_user.h>
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 processor set binding and changes in its pro-
cessor 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 attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
lgrp_init(3LGRP), lgrp_fini(3LGRP), lgrp_view(3LGRP), liblgrp(3LIB), attributes(5)
SunOS 5.11 16 Apr 2003 lgrp_cookie_stale(3LGRP)