1lgrp_view(3LGRP)       Locality Group Library Functions       lgrp_view(3LGRP)
2
3
4

NAME

6       lgrp_view - get view of lgroup hierarchy
7

SYNOPSIS

9       cc [ flag ... ] file... -llgrp [ library ... ]
10       #include <sys/lgrp_user.h>
11
12       lgrp_view_t lgrp_view(lgrp_cookie_t cookie);
13
14

DESCRIPTION

16       The  lgrp_view()  function  takes a cookie representing the snapshot of
17       the lgroup hierarchy obtained from  lgrp_init(3LGRP)  and  returns  the
18       snapshot's view of the lgroup hierarchy.
19
20
21       If  the  given view is LGRP_VIEW_CALLER, the snapshot contains only the
22       resources that are available to the caller (such as those with  respect
23       to  processor  sets).  When the view is LGRP_VIEW_OS, the snapshot con‐
24       tains what is available to the operating system.
25

RETURN VALUES

27       Upon succesful completion, lgrp_view() returns the view for  the  snap‐
28       shot  of  the lgroup hierarchy represented by the given cookie.  Other‐
29       wise, −1 is returned and errno is set to indicate the error.
30

ERRORS

32       The lgrp_view() function will fail if:
33
34       EINVAL    The cookie is not valid.
35
36

ATTRIBUTES

38       See attributes(5) for descriptions of the following attributes:
39
40
41
42
43       ┌─────────────────────────────┬─────────────────────────────┐
44       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
45       ├─────────────────────────────┼─────────────────────────────┤
46       │Interface Stability          │Evolving                     │
47       ├─────────────────────────────┼─────────────────────────────┤
48       │MT-Level                     │MT-Safe                      │
49       └─────────────────────────────┴─────────────────────────────┘
50

SEE ALSO

52       lgrp_cookie_stale(3LGRP),      lgrp_fini(3LGRP),      lgrp_init(3LGRP),
53       liblgrp(3LIB), attributes(5)
54
55
56
57SunOS 5.11                        16 Apr 2003                 lgrp_view(3LGRP)
Impressum