Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

rpc_gss_get_error(3C)

Name

rpc_gss_get_error - get error codes on failure

Synopsis

#include <rpc/rpcsec_gss.h> 

bool_t rpc_gss_get_error(rpc_gss_error_t*error);

Description

rpc_gss_get_error() fetches an error code when an RPCSEC_GSS routine fails.

rpc_gss_get_error() uses a rpc_gss_error_t structure of the following form:

typedef struct {
int	rpc_gss_error;		RPCSEC_GSS error	
int	system_error;		system error   
} rpc_gss_error_t;

Currently the only error codes defined for this function are

#define RPC_GSS_ER_SUCCESS		0	/* no error */
#define RPC_GSS_ER_SYSTEMERROR	1	/* system error */

Parameters

Information on RPCSEC_GSS data types for parameters may be found on the rpcsec_gss(3C) man page.

error

A rpc_gss_error_t structure. If the rpc_gss_error field is equal to RPC_GSS_ER_SYSTEMERROR, the system_error field will be set to the value of errno.

Return Values

Unless there is a failure indication from an invoked RPCSEC_GSS function, rpc_gss_get_error() does not set error to a meaningful value.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/security/rpcsec
MT-Level
MT-Safe

See Also

perror(3C), rpc(3C), rpcsec_gss(3C), attributes(7)

ONC+ RPC Developer’s Guide

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

Notes

Only system errors are currently returned.