lgrp_fini(3lgrp) [minix man page]

lgrp_fini(3LGRP)					 Locality Group Library Functions					  lgrp_fini(3LGRP)

NAME

       lgrp_fini - finished using lgroup interface

SYNOPSIS

       cc [ flag... ] file... -llgrp [ library... ]
       #include <sys/lgrp_user.h>

       int lgrp_fini(lgrp_cookie_t cookie);

DESCRIPTION

       The  lgrp_fini()  function  takes  a cookie, frees the snapshot of the lgroup hierarchy created by lgrp_init(3LGRP), and cleans up anything
       else set up by lgrp_init().  After this function is called, any memory allocated and returned by the lgroup interface might  no	longer	be
       valid and should not be used.

RETURN VALUES

       Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

       The lgrp_fini() 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_cookie_stale(3LGRP), liblgrp(3LIB), attributes(5)

SunOS 5.10							    16 Apr 2003 						  lgrp_fini(3LGRP)

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
       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 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.10							    16 Apr 2003 					  lgrp_cookie_stale(3LGRP)