Pool Configuration Manipulation Library Functions
                                                poolerror(3POL)



NAME
     poolerror, poolstrerror  -  error  interface  to  resource
     pools library

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

     int poolerror(void);


     const char *poolstrerror(int perr);


DESCRIPTION
     The poolerror() 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 poolstrerror() function  returns  a  descriptive  null-
     terminated string for each of the valid pool error codes.


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

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

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


     POEBADPARAM          A bad parameter was supplied.


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


     POEDATASTORE         An  error  occurred  within  permanent
                           storage.


     POEINVALIDCONF      The pool configuration  presented  for
                           the operation is invalid.




SunOS 5.11          Last change: 23 Sep 2003                    1






Pool Configuration Manipulation Library Functions
                                                poolerror(3POL)



     POEINVALIDSEARCH    A query whose outcome  set  was  empty
                           was attempted.


     POENOTSUP            An    unsupported    operation     was
                           attempted.


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


     POEOK                The previous pool operation succeeded.


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



     The poolstrerror() 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.

ERORS
     The poolstrerror() function will fail if:

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


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


















SunOS 5.11          Last change: 23 Sep 2003                    2






Pool Configuration Manipulation Library Functions
                                                poolerror(3POL)




           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     CSI                          Enabled                     
    
     Interface Stability          Unstable                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     errno(3C), libpool(3LIB), poolerror(3POL), attributes(5)









































SunOS 5.11          Last change: 23 Sep 2003                    3






Pool Configuration Manipulation Library Functions
                                                poolerror(3POL)






















































SunOS 5.11          Last change: 23 Sep 2003                    4