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(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

lgrp_cookie_stale(3LGRP), lgrp_init(3LGRP), liblgrp(3LIB),
attributes(7)

April 16, 2003 LGRP_FINI(3LGRP)