Manual Pages for UNIX Operating System command usage for man pool_error

Pool Configuration Manipulation Library Functions
                                                pool_error(3POOL)



NAME
     pool_error, pool_strerror  -  error  interface  to  resource
     pools library

SYNOPSIS
     cc [ flag... ] file... -lpool [ library... ]
     #include 

     int pool_error(void);


     const char *pool_strerror(int perr);


DESCRIPTION
     The pool_error() function returns the  error  value  of  the
     last  failure recorded by the invocation of one of the func-
     tions of the resource pool configuration library, libpool.


     The pool_strerror() function  returns  a  descriptive  null-
     terminated string for each of the valid pool error codes.


     The following error codes can be returned by pool_error():

RETURN VALUES
     The pool_error() function returns  the  current  pool  error
     value for the calling thread from among the following:

     POE_ACCESS            The operation could not  be  performed
                           because   the  configuration  was  not
                           opened with the correct  opening  per-
                           missions.


     POE_BADPARAM          A bad parameter was supplied.


     POE_BAD_PROP_TYPE     An incorrect property type was submit-
                           ted  or  encountered  during  the pool
                           operation.


     POE_DATASTORE         An  error  occurred  within  permanent
                           storage.


     POE_INVALID_CONF      The pool configuration  presented  for
                           the operation is invalid.




SunOS 5.11          Last change: 23 Sep 2003                    1






Pool Configuration Manipulation Library Functions
                                                pool_error(3POOL)



     POE_INVALID_SEARCH    A query whose outcome  set  was  empty
                           was attempted.


     POE_NOTSUP            An    unsupported    operation     was
                           attempted.


     POE_PUTPROP           An attempt to write a  read-only  pro-
                           perty was made.


     POE_OK                The previous pool operation succeeded.


     POE_SYSTEM            An underlying system call  or  library
                           function    failed;    errno(3C)    is
                           preserved where possible.



     The pool_strerror() function returns a pointer to the string
     corresponding  to  the  requested  error value. If the error
     value has no corresponding string, -1 is returned and  errno
     is set to indicate the error.

ERRORS
     The pool_strerror() function will fail if:

     ESRCH    The specified error value is  not  defined  by  the
              pools error facility.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:


















SunOS 5.11          Last change: 23 Sep 2003                    2






Pool Configuration Manipulation Library Functions
                                                pool_error(3POOL)



______________________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     errno(3C), libpool(3LIB), pool_error(3POOL), attributes(5)









































SunOS 5.11          Last change: 23 Sep 2003                    3






Pool Configuration Manipulation Library Functions
                                                pool_error(3POOL)






















































SunOS 5.11          Last change: 23 Sep 2003                    4