Loading...
Searching...
No Matches
gsup.h File Reference
Generic Subscriber Update Protocol

Osmocom Generic Subscriber Update Protocol message encoder/decoder. More...

`#include <stdint.h>`
`#include <osmocom/core/msgb.h>`
`#include <osmocom/core/defs.h>`
`#include <osmocom/core/endian.h>`
`#include <osmocom/core/socket.h>`
`#include <osmocom/gsm/gsup_sms.h>`
`#include <osmocom/gsm/protocol/gsm_23_003.h>`
`#include <osmocom/gsm/protocol/gsm_03_40.h>`
`#include <osmocom/gsm/protocol/gsm_04_08_gprs.h>`
`#include <osmocom/gsm/protocol/gsm_08_08.h>`
`#include <osmocom/gsm/gsm_utils.h>`
`#include <osmocom/crypt/auth.h>`

Go to the source code of this file.

## Data Structures

struct | osmo_gsup_pdp_info
| parsed/decoded PDP context information More...
struct | osmo_gsup_an_apdu
| AccessNetworkSignalInfo as in 3GPP TS 29.002. More...
struct | osmo_gsup_message
| parsed/decoded GSUP protocol message More...

## Macros

#define | OSMO_GSUP_PORT 4222
#define | OSMO_GSUP_MAX_NUM_PDP_INFO 10 /* GSM 09.02 limits this to 50 */
| Maximum nubmer of PDP inside osmo_gsup_message.
#define | OSMO_GSUP_MAX_NUM_AUTH_INFO 5
| Maximum number of auth info inside osmo_gsup_message.
#define | OSMO_GSUP_MAX_MSISDN_LEN 9
| Maximum number of octets encoding MSISDN in BCD format.
#define | OSMO_GSUP_MAX_CALLED_PARTY_BCD_LEN 43 /* TS 24.008 10.5.4.7 */
#define | OSMO_GSUP_MAX_PCO_LEN 251
#define | OSMO_GSUP_PDP_TYPE_IE OSMO_GSUP_PDP_ADDRESS_IE /* Backward compat */
#define | OSMO_GSUP_MSGT_E_ROUTING_ERROR OSMO_GSUP_MSGT_ROUTING_ERROR
#define | OSMO_GSUP_IS_MSGT_REQUEST(msgt) (((msgt) & 0b00000011) == 0b00)
#define | OSMO_GSUP_IS_MSGT_ERROR(msgt) (((msgt) & 0b00000011) == 0b01)
#define | OSMO_GSUP_IS_MSGT_RESULT(msgt) (((msgt) & 0b00000011) == 0b10)
#define | OSMO_GSUP_TO_MSGT_REQUEST(msgt) (((msgt) & 0b11111100))
#define | OSMO_GSUP_TO_MSGT_ERROR(msgt) (((msgt) & 0b11111100) | 0b01)
#define | OSMO_GSUP_TO_MSGT_RESULT(msgt) (((msgt) & 0b11111100) | 0b10)

## Enumerations

enum

osmo_gsup_iei {
OSMO_GSUP_IMSI_IE = 0x01 ,
OSMO_GSUP_CAUSE_IE = 0x02 ,
OSMO_GSUP_AUTH_TUPLE_IE = 0x03 ,
OSMO_GSUP_PDP_INFO_COMPL_IE = 0x04 ,
OSMO_GSUP_PDP_INFO_IE = 0x05 ,
OSMO_GSUP_CANCEL_TYPE_IE = 0x06 ,
OSMO_GSUP_FREEZE_PTMSI_IE = 0x07 ,
OSMO_GSUP_MSISDN_IE = 0x08 ,
OSMO_GSUP_HLR_NUMBER_IE = 0x09 ,
OSMO_GSUP_MESSAGE_CLASS_IE = 0x0a ,
OSMO_GSUP_PDP_CONTEXT_ID_IE = 0x10 ,
OSMO_GSUP_PDP_ADDRESS_IE = 0x11 ,
OSMO_GSUP_ACCESS_POINT_NAME_IE = 0x12 ,
OSMO_GSUP_PDP_QOS_IE = 0x13 ,
OSMO_GSUP_CHARG_CHAR_IE = 0x14 ,
OSMO_GSUP_PCO_IE = 0x15 ,
OSMO_GSUP_RAND_IE = 0x20 ,
OSMO_GSUP_SRES_IE = 0x21 ,
OSMO_GSUP_KC_IE = 0x22 ,
OSMO_GSUP_IK_IE = 0x23 ,
OSMO_GSUP_CK_IE = 0x24 ,
OSMO_GSUP_AUTN_IE = 0x25 ,
OSMO_GSUP_AUTS_IE = 0x26 ,
OSMO_GSUP_RES_IE = 0x27 ,
OSMO_GSUP_CN_DOMAIN_IE = 0x28 ,
OSMO_GSUP_SUPPORTED_RAT_TYPES_IE = 0x29 ,
OSMO_GSUP_CURRENT_RAT_TYPE_IE = 0x2a ,
OSMO_GSUP_SESSION_ID_IE = 0x30 ,
OSMO_GSUP_SESSION_STATE_IE = 0x31 ,
OSMO_GSUP_SS_INFO_IE = 0x35 ,
OSMO_GSUP_SM_RP_MR_IE = 0x40 ,
OSMO_GSUP_SM_RP_DA_IE = 0x41 ,
OSMO_GSUP_SM_RP_OA_IE = 0x42 ,
OSMO_GSUP_SM_RP_UI_IE = 0x43 ,
OSMO_GSUP_SM_RP_CAUSE_IE = 0x44 ,
OSMO_GSUP_SM_RP_MMS_IE = 0x45 ,
OSMO_GSUP_SM_ALERT_RSN_IE = 0x46 ,
OSMO_GSUP_IMEI_IE = 0x50 ,
OSMO_GSUP_IMEI_RESULT_IE = 0x51 ,
OSMO_GSUP_NUM_VECTORS_REQ_IE = 0x52 ,
OSMO_GSUP_SOURCE_NAME_IE = 0x60 ,
OSMO_GSUP_DESTINATION_NAME_IE = 0x61 ,
OSMO_GSUP_AN_APDU_IE = 0x62 ,
OSMO_GSUP_CAUSE_RR_IE = 0x63 ,
OSMO_GSUP_CAUSE_BSSAP_IE = 0x64 ,
OSMO_GSUP_CAUSE_SM_IE = 0x65 ,
_OSMO_GSUP_IEI_END_MARKER
}

| Information Element Identifiers for GSUP IEs. More...

enum

osmo_gsup_message_type {
OSMO_GSUP_MSGT_UPDATE_LOCATION_REQUEST = 0b00000100 ,
OSMO_GSUP_MSGT_UPDATE_LOCATION_ERROR = 0b00000101 ,
OSMO_GSUP_MSGT_UPDATE_LOCATION_RESULT = 0b00000110 ,
OSMO_GSUP_MSGT_SEND_AUTH_INFO_REQUEST = 0b00001000 ,
OSMO_GSUP_MSGT_SEND_AUTH_INFO_ERROR = 0b00001001 ,
OSMO_GSUP_MSGT_SEND_AUTH_INFO_RESULT = 0b00001010 ,
OSMO_GSUP_MSGT_AUTH_FAIL_REPORT = 0b00001011 ,
OSMO_GSUP_MSGT_PURGE_MS_REQUEST = 0b00001100 ,
OSMO_GSUP_MSGT_PURGE_MS_ERROR = 0b00001101 ,
OSMO_GSUP_MSGT_PURGE_MS_RESULT = 0b00001110 ,
OSMO_GSUP_MSGT_INSERT_DATA_REQUEST = 0b00010000 ,
OSMO_GSUP_MSGT_INSERT_DATA_ERROR = 0b00010001 ,
OSMO_GSUP_MSGT_INSERT_DATA_RESULT = 0b00010010 ,
OSMO_GSUP_MSGT_DELETE_DATA_REQUEST = 0b00010100 ,
OSMO_GSUP_MSGT_DELETE_DATA_ERROR = 0b00010101 ,
OSMO_GSUP_MSGT_DELETE_DATA_RESULT = 0b00010110 ,
OSMO_GSUP_MSGT_LOCATION_CANCEL_REQUEST = 0b00011100 ,
OSMO_GSUP_MSGT_LOCATION_CANCEL_ERROR = 0b00011101 ,
OSMO_GSUP_MSGT_LOCATION_CANCEL_RESULT = 0b00011110 ,
OSMO_GSUP_MSGT_PROC_SS_REQUEST = 0b00100000 ,
OSMO_GSUP_MSGT_PROC_SS_ERROR = 0b00100001 ,
OSMO_GSUP_MSGT_PROC_SS_RESULT = 0b00100010 ,
OSMO_GSUP_MSGT_MO_FORWARD_SM_REQUEST = 0b00100100 ,
OSMO_GSUP_MSGT_MO_FORWARD_SM_ERROR = 0b00100101 ,
OSMO_GSUP_MSGT_MO_FORWARD_SM_RESULT = 0b00100110 ,
OSMO_GSUP_MSGT_MT_FORWARD_SM_REQUEST = 0b00101000 ,
OSMO_GSUP_MSGT_MT_FORWARD_SM_ERROR = 0b00101001 ,
OSMO_GSUP_MSGT_MT_FORWARD_SM_RESULT = 0b00101010 ,
OSMO_GSUP_MSGT_READY_FOR_SM_REQUEST = 0b00101100 ,
OSMO_GSUP_MSGT_READY_FOR_SM_ERROR = 0b00101101 ,
OSMO_GSUP_MSGT_READY_FOR_SM_RESULT = 0b00101110 ,
OSMO_GSUP_MSGT_CHECK_IMEI_REQUEST = 0b00110000 ,
OSMO_GSUP_MSGT_CHECK_IMEI_ERROR = 0b00110001 ,
OSMO_GSUP_MSGT_CHECK_IMEI_RESULT = 0b00110010 ,
OSMO_GSUP_MSGT_E_PREPARE_HANDOVER_REQUEST = 0b00110100 ,
OSMO_GSUP_MSGT_E_PREPARE_HANDOVER_ERROR = 0b00110101 ,
OSMO_GSUP_MSGT_E_PREPARE_HANDOVER_RESULT = 0b00110110 ,
OSMO_GSUP_MSGT_E_PREPARE_SUBSEQUENT_HANDOVER_REQUEST = 0b00111000 ,
OSMO_GSUP_MSGT_E_PREPARE_SUBSEQUENT_HANDOVER_ERROR = 0b00111001 ,
OSMO_GSUP_MSGT_E_PREPARE_SUBSEQUENT_HANDOVER_RESULT = 0b00111010 ,
OSMO_GSUP_MSGT_E_SEND_END_SIGNAL_REQUEST = 0b00111100 ,
OSMO_GSUP_MSGT_E_SEND_END_SIGNAL_ERROR = 0b00111101 ,
OSMO_GSUP_MSGT_E_SEND_END_SIGNAL_RESULT = 0b00111110 ,
OSMO_GSUP_MSGT_E_PROCESS_ACCESS_SIGNALLING_REQUEST = 0b01000000 ,
OSMO_GSUP_MSGT_E_FORWARD_ACCESS_SIGNALLING_REQUEST = 0b01000100 ,
OSMO_GSUP_MSGT_E_CLOSE = 0b01000111 ,
OSMO_GSUP_MSGT_E_ABORT = 0b01001011 ,
OSMO_GSUP_MSGT_ROUTING_ERROR = 0b01001110 ,
OSMO_GSUP_MSGT_EPDG_TUNNEL_REQUEST = 0b01010000 ,
OSMO_GSUP_MSGT_EPDG_TUNNEL_ERROR = 0b01010001 ,
OSMO_GSUP_MSGT_EPDG_TUNNEL_RESULT = 0b01010010
}

| GSUP message type Make sure that new messages follow this scheme: More...
enum | osmo_gsup_cancel_type { OSMO_GSUP_CANCEL_TYPE_UPDATE = 1 , OSMO_GSUP_CANCEL_TYPE_WITHDRAW = 2 }
enum | osmo_gsup_cn_domain { OSMO_GSUP_CN_DOMAIN_PS = 1 , OSMO_GSUP_CN_DOMAIN_CS = 2 }
enum | osmo_gsup_imei_result { OSMO_GSUP_IMEI_RESULT_ACK = 1 , OSMO_GSUP_IMEI_RESULT_NACK = 2 }
enum | osmo_gsup_access_network_protocol { OSMO_GSUP_ACCESS_NETWORK_PROTOCOL_TS3G_48006 = 1 , OSMO_GSUP_ACCESS_NETWORK_PROTOCOL_TS3G_25413 = 2 }
enum | osmo_gsup_session_state { OSMO_GSUP_SESSION_STATE_NONE = 0x00 , OSMO_GSUP_SESSION_STATE_BEGIN = 0x01 , OSMO_GSUP_SESSION_STATE_CONTINUE = 0x02 , OSMO_GSUP_SESSION_STATE_END = 0x03 }
| TCAP-like session state. More...
enum | osmo_gsup_message_class { OSMO_GSUP_MESSAGE_CLASS_UNSET = 0 , OSMO_GSUP_MESSAGE_CLASS_SUBSCRIBER_MANAGEMENT = 1 , OSMO_GSUP_MESSAGE_CLASS_SMS = 2 , OSMO_GSUP_MESSAGE_CLASS_USSD = 3 , OSMO_GSUP_MESSAGE_CLASS_INTER_MSC = 4 , OSMO_GSUP_MESSAGE_CLASS_IPSEC_EPDG = 5 , OSMO_GSUP_MESSAGE_CLASS_ARRAYSIZE }

## Functions

static const char * | osmo_gsup_message_type_name (enum osmo_gsup_message_type val)
static const char * | osmo_gsup_session_state_name (enum osmo_gsup_session_state val)
static const char * | osmo_gsup_message_class_name (enum osmo_gsup_message_class val)
int | osmo_gsup_decode (const uint8_t *const_data, size_t data_len, struct osmo_gsup_message *gsup_msg)
| Decode (parse) a GSUP message.
int | osmo_gsup_encode (struct msgb *msg, const struct osmo_gsup_message *gsup_msg)
| Encode a GSUP message.
int | osmo_gsup_get_err_msg_type (enum osmo_gsup_message_type type_in)
| return the error message type corresponding to type_in.

## Variables

const struct value_string | osmo_gsup_message_type_names []
const struct value_string | osmo_gsup_session_state_names []
const struct value_string | osmo_gsup_message_class_names []

## Detailed Description

Osmocom Generic Subscriber Update Protocol message encoder/decoder.

## Macro Definition Documentation

## OSMO_GSUP_PDP_TYPE_IE

#define OSMO_GSUP_PDP_TYPE_IE OSMO_GSUP_PDP_ADDRESS_IE /* Backward compat */