causes.h

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 1999 - 2005, Digium, Inc.
 *
 * Martin Pycko <[email protected]>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*! \file
 * \brief Internal Asterisk hangup causes
 */

#ifndef _ASTERISK_CAUSES_H
#define _ASTERISK_CAUSES_H

/*! \page AstCauses Hangup Causes for Asterisk

The Asterisk hangup causes are delivered to the dialplan in the
${HANGUPCAUSE} channel variable after a call (after execution
of "dial").

In SIP, we have a conversion table to convert between SIP
return codes and Q.931 both ways. This is to improve SIP/ISDN
compatibility.

These are the current codes, based on the Q.850/Q.931
specification:

   - AST_CAUSE_UNALLOCATED                      1
   - AST_CAUSE_NO_ROUTE_TRANSIT_NET             2
   - AST_CAUSE_NO_ROUTE_DESTINATION             3
   - AST_CAUSE_MISDIALLED_TRUNK_PREFIX          5
   - AST_CAUSE_CHANNEL_UNACCEPTABLE             6
   - AST_CAUSE_CALL_AWARDED_DELIVERED           7
   - AST_CAUSE_PRE_EMPTED                       8
   - AST_CAUSE_NUMBER_PORTED_NOT_HERE          14
   - AST_CAUSE_NORMAL_CLEARING                 16
   - AST_CAUSE_USER_BUSY                       17
   - AST_CAUSE_NO_USER_RESPONSE                18
   - AST_CAUSE_NO_ANSWER                       19
   - AST_CAUSE_CALL_REJECTED                   21
   - AST_CAUSE_NUMBER_CHANGED                  22
   - AST_CAUSE_REDIRECTED_TO_NEW_DESTINATION   23
   - AST_CAUSE_ANSWERED_ELSEWHERE              26
   - AST_CAUSE_DESTINATION_OUT_OF_ORDER        27
   - AST_CAUSE_INVALID_NUMBER_FORMAT           28
   - AST_CAUSE_FACILITY_REJECTED               29
   - AST_CAUSE_RESPONSE_TO_STATUS_ENQUIRY      30
   - AST_CAUSE_NORMAL_UNSPECIFIED              31
   - AST_CAUSE_NORMAL_CIRCUIT_CONGESTION       34
   - AST_CAUSE_NETWORK_OUT_OF_ORDER            38
   - AST_CAUSE_NORMAL_TEMPORARY_FAILURE        41
   - AST_CAUSE_SWITCH_CONGESTION               42
   - AST_CAUSE_ACCESS_INFO_DISCARDED           43
   - AST_CAUSE_REQUESTED_CHAN_UNAVAIL          44
   - AST_CAUSE_FACILITY_NOT_SUBSCRIBED         50
   - AST_CAUSE_OUTGOING_CALL_BARRED            52
   - AST_CAUSE_INCOMING_CALL_BARRED            54
   - AST_CAUSE_BEARERCAPABILITY_NOTAUTH        57
   - AST_CAUSE_BEARERCAPABILITY_NOTAVAIL       58
   - AST_CAUSE_BEARERCAPABILITY_NOTIMPL        65
   - AST_CAUSE_CHAN_NOT_IMPLEMENTED            66
   - AST_CAUSE_FACILITY_NOT_IMPLEMENTED        69
   - AST_CAUSE_INVALID_CALL_REFERENCE          81
   - AST_CAUSE_INCOMPATIBLE_DESTINATION        88
   - AST_CAUSE_INVALID_MSG_UNSPECIFIED         95
   - AST_CAUSE_MANDATORY_IE_MISSING            96
   - AST_CAUSE_MESSAGE_TYPE_NONEXIST           97
   - AST_CAUSE_WRONG_MESSAGE                   98
   - AST_CAUSE_IE_NONEXIST                     99
   - AST_CAUSE_INVALID_IE_CONTENTS            100
   - AST_CAUSE_WRONG_CALL_STATE               101
   - AST_CAUSE_RECOVERY_ON_TIMER_EXPIRE       102
   - AST_CAUSE_MANDATORY_IE_LENGTH_ERROR      103
   - AST_CAUSE_PROTOCOL_ERROR                 111
   - AST_CAUSE_INTERWORKING                   127

For more information:
- \ref app_dial.c
*/

/*! \name Causes for disconnection (from Q.850/Q.931)
 *  These are the internal cause codes used in Asterisk.
 *  \ref AstCauses
 */
/*@{ */
#define AST_CAUSE_UNALLOCATED                    1
#define AST_CAUSE_NO_ROUTE_TRANSIT_NET           2
#define AST_CAUSE_NO_ROUTE_DESTINATION           3
#define AST_CAUSE_MISDIALLED_TRUNK_PREFIX        5
#define AST_CAUSE_CHANNEL_UNACCEPTABLE           6
#define AST_CAUSE_CALL_AWARDED_DELIVERED         7
#define AST_CAUSE_PRE_EMPTED                     8
#define AST_CAUSE_NUMBER_PORTED_NOT_HERE        14
#define AST_CAUSE_NORMAL_CLEARING               16
#define AST_CAUSE_USER_BUSY                     17
#define AST_CAUSE_NO_USER_RESPONSE              18
#define AST_CAUSE_NO_ANSWER                     19
#define AST_CAUSE_SUBSCRIBER_ABSENT             20
#define AST_CAUSE_CALL_REJECTED                 21
#define AST_CAUSE_NUMBER_CHANGED                22
#define AST_CAUSE_REDIRECTED_TO_NEW_DESTINATION 23
#define AST_CAUSE_ANSWERED_ELSEWHERE            26
#define AST_CAUSE_DESTINATION_OUT_OF_ORDER      27
#define AST_CAUSE_INVALID_NUMBER_FORMAT         28
#define AST_CAUSE_FACILITY_REJECTED             29
#define AST_CAUSE_RESPONSE_TO_STATUS_ENQUIRY    30
#define AST_CAUSE_NORMAL_UNSPECIFIED            31
#define AST_CAUSE_NORMAL_CIRCUIT_CONGESTION     34
#define AST_CAUSE_NETWORK_OUT_OF_ORDER          38
#define AST_CAUSE_NORMAL_TEMPORARY_FAILURE      41
#define AST_CAUSE_SWITCH_CONGESTION             42
#define AST_CAUSE_ACCESS_INFO_DISCARDED         43
#define AST_CAUSE_REQUESTED_CHAN_UNAVAIL        44
#define AST_CAUSE_FACILITY_NOT_SUBSCRIBED       50
#define AST_CAUSE_OUTGOING_CALL_BARRED          52
#define AST_CAUSE_INCOMING_CALL_BARRED          54
#define AST_CAUSE_BEARERCAPABILITY_NOTAUTH      57
#define AST_CAUSE_BEARERCAPABILITY_NOTAVAIL     58
#define AST_CAUSE_BEARERCAPABILITY_NOTIMPL      65
#define AST_CAUSE_CHAN_NOT_IMPLEMENTED          66
#define AST_CAUSE_FACILITY_NOT_IMPLEMENTED      69
#define AST_CAUSE_INVALID_CALL_REFERENCE        81
#define AST_CAUSE_INCOMPATIBLE_DESTINATION      88
#define AST_CAUSE_INVALID_MSG_UNSPECIFIED       95
#define AST_CAUSE_MANDATORY_IE_MISSING          96
#define AST_CAUSE_MESSAGE_TYPE_NONEXIST         97
#define AST_CAUSE_WRONG_MESSAGE                 98
#define AST_CAUSE_IE_NONEXIST                   99
#define AST_CAUSE_INVALID_IE_CONTENTS          100
#define AST_CAUSE_WRONG_CALL_STATE             101
#define AST_CAUSE_RECOVERY_ON_TIMER_EXPIRE     102
#define AST_CAUSE_MANDATORY_IE_LENGTH_ERROR    103
#define AST_CAUSE_PROTOCOL_ERROR               111
#define AST_CAUSE_INTERWORKING                 127

/* Special Asterisk aliases */
#define AST_CAUSE_BUSY          AST_CAUSE_USER_BUSY
#define AST_CAUSE_FAILURE       AST_CAUSE_NETWORK_OUT_OF_ORDER
#define AST_CAUSE_NORMAL        AST_CAUSE_NORMAL_CLEARING
#define AST_CAUSE_NOANSWER      AST_CAUSE_NO_ANSWER
#define AST_CAUSE_CONGESTION    AST_CAUSE_NORMAL_CIRCUIT_CONGESTION
#define AST_CAUSE_UNREGISTERED  AST_CAUSE_SUBSCRIBER_ABSENT
#define AST_CAUSE_NOTDEFINED    0
#define AST_CAUSE_NOSUCHDRIVER  AST_CAUSE_CHAN_NOT_IMPLEMENTED
/*@} */

#endif /* _ASTERISK_CAUSES_H */