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>

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. More...

#define	OSMO_GSUP_MAX_NUM_AUTH_INFO 5
	Maximum number of auth info inside osmo_gsup_message. More...

#define	OSMO_GSUP_MAX_MSISDN_LEN 9
	Maximum number of octets encoding MSISDN in BCD format. More...

#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. More...

int	osmo_gsup_encode (struct msgb msg, const struct osmo_gsup_message gsup_msg)
	Encode a GSUP message. More...

int	osmo_gsup_get_err_msg_type (enum osmo_gsup_message_type type_in)
	return the error message type corresponding to type_in. More...

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 []

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ OSMO_GSUP_PDP_TYPE_IE