Networking Services Library Functions     rpcgssgeterror(3NSL)



NAME
     rpcgssgeterror - get error codes on failure

SYNOPSIS
     #include 

     boolt rpcgssgeterror(rpcgsserrort*error);


DESCRIPTION
     rpcgssgeterror() fetches an error code when an RPCSECGS
     routine fails.


     rpcgssgeterror() uses a rpcgsserrort structure of  the
     following form:

       typedef struct {
       int  rpcgsserror;      RPCSECGS error
       int  systemerror;       system error
       } rpcgsserrort;



     Currently the only error codes defined for this function are

       #define RPCGSERSUCES         0    /* no error */
       #define RPCGSERSYSTEMEROR     1    /* system error */


PARAMETERS
     Information on RPCSECGS data types for parameters  may  be
     found on the rpcsecgss(3NSL) man page.

     error     A     rpcgsserrort    structure.     If     the
               rpcgsserror      field      is      equal     to
               RPCGSERSYSTEMEROR,  the   systemerror  field
               will be set to the value of errno.


RETURN VALUES
     Unless  there  is  a  failure  indication  from  an  invoked
     RPCSECGS function,  rpcgssgeterror() does not set error
     to a meaningful value.

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







SunOS 5.11           Last change: 5 Feb 2002                    1






Networking Services Library Functions     rpcgssgeterror(3NSL)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    
     Availability                 SUNWrsg (32-bit)            
    
                                  SUNWrsgx (64-bit)           
    


SEE ALSO
     perror(3C), rpc(3NSL), rpcsecgss(3NSL), attributes(5)


     ONC] Developer's Guide


     Linn, J. RFC 2078, Generic Security Service Application Pro-
     gram  Interface,  Version  2. Network Working Group. January
     1997.

NOTES
     Only system errors are currently returned.































SunOS 5.11           Last change: 5 Feb 2002                    2