opensolaris man page for pool_strerror

pool_error(3POOL)				 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 <pool.h>

       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 functions 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 permissions.

       POE_BADPARAM	     A bad parameter was supplied.

       POE_BAD_PROP_TYPE     An incorrect property type was submitted 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.

       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 property 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  corre-
       sponding 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Unstable			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    23 Sep 2003 						 pool_error(3POOL)