Previous section.

Resource ReSerVation Protocol API (RAPI)
Copyright © 1998 The Open Group

Error Handling

Introduction

Errors can be detected synchronously or asynchronously.

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

Symbol Value Meaning
RSVP_Err_NONE 0 No error (confirmation)
RSVP_Err_ADMISSION 1 Admission control failure
RSVP_Err_POLICY 2 Policy control failure
RSVP_Err_NO_PATH 3 No path information
RSVP_Err_NO_SENDER 4 No sender information
RSVP_Err_BAD_STYLE 5 Conflicting style
RSVP_Err_UNKNOWN_STYLE 6 Unknown style
RSVP_Err_BAD_DSTPORT 7 Conflicting destination port in session
RSVP_Err_BAD_SNDPORT 8 Conflicting source port
  9 reserved
  10 reserved
  11 reserved
RSVP_Err_PREEMPTED 12 Service preempted
RSVP_Err_UNKN_OBJ_CLASS 13 Unknown object class
RSVP_Err_UNKNOWN_CTYPE 14 Unknown object C-Type
  15 reserved
  16 reserved
  17 reserved
  18 reserved
  19 reserved
RSVP_Err_API_ERROR 20 API error
RSVP_Err_TC_ERROR 21 Traffic control error
RSVP_Err_TC_SYS_ERROR 22 Traffic control system error
RSVP_Err_RSVP_SYS_ERROR 23 RSVP system error

Contents Next section Index