1pool_error(3POOLP)ool Configuration Manipulation Library Functiopnosol_error(3POOL)
2
3
4

NAME

6       pool_error, pool_strerror - error interface to resource pools library
7

SYNOPSIS

9       cc [ flag... ] file... -lpool [ library... ]
10       #include <pool.h>
11
12       int pool_error(void);
13
14
15       const char *pool_strerror(int perr);
16
17

DESCRIPTION

19       The  pool_error()  function returns the error value of the last failure
20       recorded by the invocation of one of the functions of the resource pool
21       configuration library, libpool.
22
23
24       The  pool_strerror()  function  returns  a  descriptive null-terminated
25       string for each of the valid pool error codes.
26
27
28       The following error codes can be returned by pool_error():
29

RETURN VALUES

31       The pool_error() function returns the current pool error value for  the
32       calling thread from among the following:
33
34       POE_ACCESS            The  operation could not be performed because the
35                             configuration was not  opened  with  the  correct
36                             opening permissions.
37
38
39       POE_BADPARAM          A bad parameter was supplied.
40
41
42       POE_BAD_PROP_TYPE     An  incorrect  property  type  was  submitted  or
43                             encountered during the pool operation.
44
45
46       POE_DATASTORE         An error occurred within permanent storage.
47
48
49       POE_INVALID_CONF      The pool configuration presented for  the  opera‐
50                             tion is invalid.
51
52
53       POE_INVALID_SEARCH    A   query   whose   outcome  set  was  empty  was
54                             attempted.
55
56
57       POE_NOTSUP            An unsupported operation was attempted.
58
59
60       POE_PUTPROP           An attempt to  write  a  read-only  property  was
61                             made.
62
63
64       POE_OK                The previous pool operation succeeded.
65
66
67       POE_SYSTEM            An  underlying  system  call  or library function
68                             failed; errno(3C) is preserved where possible.
69
70
71
72       The pool_strerror() function returns a pointer  to  the  string  corre‐
73       sponding to the requested error value. If the error value has no corre‐
74       sponding string, −1 is returned and errno is set to indicate the error.
75

ERRORS

77       The pool_strerror() function will fail if:
78
79       ESRCH    The specified error value is not defined by  the  pools  error
80                facility.
81
82

ATTRIBUTES

84       See attributes(5) for descriptions of the following attributes:
85
86
87
88
89       ┌─────────────────────────────┬─────────────────────────────┐
90       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
91       ├─────────────────────────────┼─────────────────────────────┤
92       │CSI                          │Enabled                      │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │Interface Stability          │Unstable                     │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │MT-Level                     │Safe                         │
97       └─────────────────────────────┴─────────────────────────────┘
98

SEE ALSO

100       errno(3C), libpool(3LIB), pool_error(3POOL), attributes(5)
101
102
103
104SunOS 5.11                        23 Sep 2003                pool_error(3POOL)
Impressum