opensolaris man page for lgrp_cookie_stale

Query: lgrp_cookie_stale

OS: opensolaris

Section: 3lgrp

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
liblgrp(3lib) - opensolaris
lgrp_cookie_stale(3lgrp) - opensolaris
lgrp_cookie_stale(3lgrp) - sunos
lgrp_init(3lgrp) - sunos
liblgrp(3lib) - php
Similar Topics in the Unix Linux Community
Need help in logic
VMDB Failure&quot; followed by &quot;Unable to open snapshot file&quot;
Syncvg
Snapshot revert fails in my KVM setup
awk and sum