Error Handling

Introduction

When an error is detected synchronously, a RAPI error code is returned via the Errnop argument of rapi_session(), or as the function return value of rapi_sender(), rapi_reserve(), rapi_release() or rapi_dispatch().

When an error is detected asynchronously, it is indicated by a RAPI_PATH_ERROR or RAPI_RESV_ERROR event. An RSVP error code and error value are then contained in the ErrorCode and ErrorValue arguments of the event upcall function. In case of an API error (RSVP error code 20), a RAPI error code is contained in the ErrorValue argument.

A description of RSVP error codes and values can be found in Appendix B of the referenced RFC 2205.

RAPI Error Codes

[RAPI_ERR_OK]

No error

[RAPI_ERR_INVAL]

Invalid parameter

[RAPI_ERR_MAXSESS]

Too many sessions

[RAPI_ERR_BADSID]

Session identity out of legal range

[RAPI_ERR_N_FFS]

Wrong filter number or flow number for style

[RAPI_ERR_BADSTYLE]

Illegal reservation style

[RAPI_ERR_SYSCALL]

A system error has occurred; its nature may be indicated by errno

[RAPI_ERR_OVERFLOW]

Parameter list overflow

[RAPI_ERR_MEMFULL]

Not enough memory

[RAPI_ERR_NORSVP]

RSVP implementation internal error

[RAPI_ERR_OBJTYPE]

Invalid object type

[RAPI_ERR_OBJLEN]

Invalid object length

[RAPI_ERR_NOTSPEC]

No sender Tspec

[RAPI_ERR_INTSERV]

Invalid Integrated Services parameter format

[RAPI_ERR_GPI_CONFLICT]

IPSEC: Conflicting C-type

[RAPI_ERR_BADPROTO]

IPSEC: Protocol not AH or ESP

[RAPI_ERR_BADVDPORT]

IPSEC: vDstPort is zero

[RAPI_ERR_GPISESS]

IPSEC: invalid parameters for GPI_SESSION flag, or other parameter error

[RAPI_ERR_BADSEND]

Sender address not my interface

[RAPI_ERR_BADRECV]

Receiver address not my interface

[RAPI_ERR_BADSPORT]

Invalid source port: the source port is non-zero when the destination port is zero.

[RAPI_ERR_UNSUPPORTED]

Unsupported feature

[RAPI_ERR_UNKNOWN]

Unknown error

Note that [RAPI_ERR_BADSEND], [RAPI_ERR_BADRECV] and [RAPI_ERR_BADSPORT] occur only asynchronously, as the ErrorValue when the ErrorCode is 20 (API error).

RSVP Error Codes