libosmocore 1.10.0.57-8972
Osmocom core library
|
gsmtap header, pseudo-header in front of the actua GSM payload. More...
#include <stdint.h>
Go to the source code of this file.
Data Structures | |
struct | gsmtap_hdr |
Structure of the GSMTAP pseudo-header. More... | |
struct | gsmtap_osmocore_log_hdr |
Structure of the GSMTAP libosmocore logging header. More... | |
Macros | |
#define | GSMTAP_VERSION 0x02 |
#define | GSMTAP_TYPE_UM 0x01 |
#define | GSMTAP_TYPE_ABIS 0x02 |
#define | GSMTAP_TYPE_UM_BURST 0x03 /* raw burst bits */ |
#define | GSMTAP_TYPE_SIM 0x04 /* ISO 7816 smart card interface */ |
#define | GSMTAP_TYPE_TETRA_I1 0x05 /* tetra air interface */ |
#define | GSMTAP_TYPE_TETRA_I1_BURST 0x06 /* tetra air interface */ |
#define | GSMTAP_TYPE_WMX_BURST 0x07 /* WiMAX burst */ |
#define | GSMTAP_TYPE_GB_LLC 0x08 /* GPRS Gb interface: LLC */ |
#define | GSMTAP_TYPE_GB_SNDCP 0x09 /* GPRS Gb interface: SNDCP */ |
#define | GSMTAP_TYPE_GMR1_UM 0x0a /* GMR-1 L2 packets */ |
#define | GSMTAP_TYPE_UMTS_RLC_MAC 0x0b |
#define | GSMTAP_TYPE_UMTS_RRC 0x0c |
#define | GSMTAP_TYPE_LTE_RRC 0x0d /* LTE interface */ |
#define | GSMTAP_TYPE_LTE_MAC 0x0e /* LTE MAC interface */ |
#define | GSMTAP_TYPE_LTE_MAC_FRAMED 0x0f /* LTE MAC with context hdr */ |
#define | GSMTAP_TYPE_OSMOCORE_LOG 0x10 /* libosmocore logging */ |
#define | GSMTAP_TYPE_QC_DIAG 0x11 /* Qualcomm DIAG frame */ |
#define | GSMTAP_TYPE_LTE_NAS 0x12 /* LTE Non-Access Stratum */ |
#define | GSMTAP_TYPE_E1T1 0x13 /* E1/T1 Lines */ |
#define | GSMTAP_TYPE_GSM_RLP 0x14 /* GSM RLP frames as per 3GPP TS 24.022 */ |
#define | GSMTAP_BURST_UNKNOWN 0x00 |
#define | GSMTAP_BURST_FCCH 0x01 |
#define | GSMTAP_BURST_PARTIAL_SCH 0x02 |
#define | GSMTAP_BURST_SCH 0x03 |
#define | GSMTAP_BURST_CTS_SCH 0x04 |
#define | GSMTAP_BURST_COMPACT_SCH 0x05 |
#define | GSMTAP_BURST_NORMAL 0x06 |
#define | GSMTAP_BURST_DUMMY 0x07 |
#define | GSMTAP_BURST_ACCESS 0x08 |
#define | GSMTAP_BURST_NONE 0x09 |
#define | GSMTAP_BURST_CDMA_CODE 0x10 /* WiMAX CDMA Code Attribute burst */ |
#define | GSMTAP_BURST_FCH 0x11 /* WiMAX FCH burst */ |
#define | GSMTAP_BURST_FFB 0x12 /* WiMAX Fast Feedback burst */ |
#define | GSMTAP_BURST_PDU 0x13 /* WiMAX PDU burst */ |
#define | GSMTAP_BURST_HACK 0x14 /* WiMAX HARQ ACK burst */ |
#define | GSMTAP_BURST_PHY_ATTRIBUTES 0x15 /* WiMAX PHY Attributes burst */ |
#define | GSMTAP_CHANNEL_UNKNOWN 0x00 |
#define | GSMTAP_CHANNEL_BCCH 0x01 |
#define | GSMTAP_CHANNEL_CCCH 0x02 |
#define | GSMTAP_CHANNEL_RACH 0x03 |
#define | GSMTAP_CHANNEL_AGCH 0x04 |
#define | GSMTAP_CHANNEL_PCH 0x05 |
#define | GSMTAP_CHANNEL_SDCCH 0x06 |
#define | GSMTAP_CHANNEL_SDCCH4 0x07 |
#define | GSMTAP_CHANNEL_SDCCH8 0x08 |
#define | GSMTAP_CHANNEL_FACCH_F 0x09 /* Actually, it's FACCH/F (signaling) */ |
#define | GSMTAP_CHANNEL_FACCH_H 0x0a /* Actually, it's FACCH/H (signaling) */ |
#define | GSMTAP_CHANNEL_PACCH 0x0b |
#define | GSMTAP_CHANNEL_CBCH52 0x0c |
#define | GSMTAP_CHANNEL_PDTCH 0x0d |
#define | GSMTAP_CHANNEL_PDCH GSMTAP_CHANNEL_PDTCH |
#define | GSMTAP_CHANNEL_PTCCH 0x0e |
#define | GSMTAP_CHANNEL_CBCH51 0x0f |
#define | GSMTAP_CHANNEL_VOICE_F 0x10 /* voice codec payload (FR/EFR/AMR) */ |
#define | GSMTAP_CHANNEL_VOICE_H 0x11 /* voice codec payload (HR/AMR) */ |
#define | GSMTAP_CHANNEL_TCH_F GSMTAP_CHANNEL_FACCH_F /* We used the wrong naming in 2008 when we were young */ |
#define | GSMTAP_CHANNEL_TCH_H GSMTAP_CHANNEL_FACCH_H /* We used the wrong naming in 2008 when we were young */ |
#define | GSMTAP_GPRS_CS_BASE 0x20 |
#define | GSMTAP_GPRS_CS(N) (GSMTAP_GPRS_CS_BASE + N) |
#define | GSMTAP_GPRS_MCS_BASE 0x30 |
#define | GSMTAP_GPRS_MCS(N) (GSMTAP_GPRS_MCS_BASE + N) |
#define | GSMTAP_CHANNEL_ACCH 0x80 |
#define | GSMTAP_SIM_APDU 0x00 /* APDU data (complete APDU) */ |
#define | GSMTAP_SIM_ATR 0x01 /* card ATR data */ |
#define | GSMTAP_SIM_PPS_REQ 0x02 /* PPS request data */ |
#define | GSMTAP_SIM_PPS_RSP 0x03 /* PPS response data */ |
#define | GSMTAP_SIM_TPDU_HDR 0x04 /* TPDU command header */ |
#define | GSMTAP_SIM_TPDU_CMD 0x05 /* TPDU command body */ |
#define | GSMTAP_SIM_TPDU_RSP 0x06 /* TPDU response body */ |
#define | GSMTAP_SIM_TPDU_SW 0x07 /* TPDU response trailer */ |
#define | GSMTAP_TETRA_BSCH 0x01 |
#define | GSMTAP_TETRA_AACH 0x02 |
#define | GSMTAP_TETRA_SCH_HU 0x03 |
#define | GSMTAP_TETRA_SCH_HD 0x04 |
#define | GSMTAP_TETRA_SCH_F 0x05 |
#define | GSMTAP_TETRA_BNCH 0x06 |
#define | GSMTAP_TETRA_STCH 0x07 |
#define | GSMTAP_TETRA_TCH_F 0x08 |
#define | GSMTAP_TETRA_DMO_SCH_S 0x09 |
#define | GSMTAP_TETRA_DMO_SCH_H 0x0a |
#define | GSMTAP_TETRA_DMO_SCH_F 0x0b |
#define | GSMTAP_TETRA_DMO_STCH 0x0c |
#define | GSMTAP_TETRA_DMO_TCH 0x0d |
#define | GSMTAP_GMR1_UNKNOWN 0x00 |
#define | GSMTAP_GMR1_BCCH 0x01 |
#define | GSMTAP_GMR1_CCCH 0x02 /* either AGCH or PCH */ |
#define | GSMTAP_GMR1_PCH 0x03 |
#define | GSMTAP_GMR1_AGCH 0x04 |
#define | GSMTAP_GMR1_BACH 0x05 |
#define | GSMTAP_GMR1_RACH 0x06 |
#define | GSMTAP_GMR1_CBCH 0x07 |
#define | GSMTAP_GMR1_SDCCH 0x08 |
#define | GSMTAP_GMR1_TACCH 0x09 |
#define | GSMTAP_GMR1_GBCH 0x0a |
#define | GSMTAP_GMR1_SACCH 0x01 /* to be combined with _TCH{6,9} */ |
#define | GSMTAP_GMR1_FACCH 0x02 /* to be combines with _TCH{3,6,9} */ |
#define | GSMTAP_GMR1_DKAB 0x03 /* to be combined with _TCH3 */ |
#define | GSMTAP_GMR1_TCH3 0x10 |
#define | GSMTAP_GMR1_TCH6 0x14 |
#define | GSMTAP_GMR1_TCH9 0x18 |
#define | GSMTAP_UMTS_CH_PCCH 0x01 |
#define | GSMTAP_UMTS_CH_CCCH 0x02 |
#define | GSMTAP_UMTS_CH_DCCH 0x03 |
#define | GSMTAP_LTE_CH_BCCH 0x01 |
#define | GSMTAP_LTE_CH_CCCH 0x02 |
#define | GSMTAP_LTE_CH_DCCH 0x03 |
#define | GSMTAP_LTE_CH_MCCH 0x04 |
#define | GSMTAP_LTE_CH_PCCH 0x05 |
#define | GSMTAP_LTE_CH_DTCH 0x06 |
#define | GSMTAP_LTE_CH_MTCH 0x07 |
#define | GSMTAP_E1T1_LAPD 0x01 /* Q.921 LAPD */ |
#define | GSMTAP_E1T1_FR 0x02 /* Frame Relay */ |
#define | GSMTAP_E1T1_RAW 0x03 /* raw/transparent B-channel */ |
#define | GSMTAP_E1T1_TRAU16 0x04 /* 16k TRAU frames; sub-slot 0-3 */ |
#define | GSMTAP_E1T1_TRAU8 0x05 /* 8k TRAU frames; sub-slot 0-7 */ |
#define | GSMTAP_E1T1_V5EF 0x06 /* V5 Envelope Function */ |
#define | GSMTAP_E1T1_X75 0x07 /* X.75 B-channel data */ |
#define | GSMTAP_E1T1_V120 0x08 /* V.120 B-channel data */ |
#define | GSMTAP_E1T1_V110 0x09 /* V.110 B-channel data */ |
#define | GSMTAP_E1T1_H221 0x0a /* H.221 B-channel data */ |
#define | GSMTAP_E1T1_PPP 0x0b /* PPP */ |
#define | GSMTAP_ARFCN_F_PCS 0x8000 |
#define | GSMTAP_ARFCN_F_UPLINK 0x4000 |
#define | GSMTAP_ARFCN_MASK 0x3fff |
#define | GSMTAP_UDP_PORT 4729 |
Functions | |
struct gsmtap_hdr | __attribute__ ((packed)) |
Variables | |
uint8_t | version |
version, set to 0x01 currently More... | |
uint8_t | hdr_len |
length in number of 32bit words More... | |
uint8_t | type |
see GSMTAP_TYPE_* More... | |
uint8_t | timeslot |
timeslot (0..7 on Um) More... | |
uint16_t | arfcn |
ARFCN (frequency) More... | |
int8_t | signal_dbm |
signal level in dBm More... | |
int8_t | snr_db |
signal/noise ratio in dB More... | |
uint32_t | frame_number |
GSM Frame Number (FN) More... | |
uint8_t | sub_type |
Type of burst/channel, see above. More... | |
uint8_t | antenna_nr |
Antenna Number. More... | |
uint8_t | sub_slot |
sub-slot within timeslot More... | |
uint8_t | res |
reserved for future use (RFU) More... | |
struct { | |
uint32_t sec | |
uint32_t usec | |
} | ts |
char | proc_name [16] |
name of process More... | |
uint32_t | pid |
process ID More... | |
uint8_t | level |
logging level More... | |
uint8_t | _pad [3] |
char | subsys [16] |
logging sub-system More... | |
struct { | |
char name [32] | |
source file name More... | |
uint32_t line_nr | |
line number More... | |
} | src_file |
enum gsmtap_um_voice_type | __attribute__ |
gsmtap header, pseudo-header in front of the actua GSM payload.
GSMTAP is a generic header format for GSM protocol captures, it uses the IANA-assigned UDP port number 4729 and carries payload in various formats of GSM interfaces such as Um MAC blocks or Um bursts.
Example programs generating GSMTAP data are airprobe (http://airprobe.org/) or OsmocomBB (http://bb.osmocom.org/)
#define GSMTAP_ARFCN_F_PCS 0x8000 |
#define GSMTAP_ARFCN_F_UPLINK 0x4000 |
#define GSMTAP_ARFCN_MASK 0x3fff |
#define GSMTAP_BURST_ACCESS 0x08 |
#define GSMTAP_BURST_CDMA_CODE 0x10 /* WiMAX CDMA Code Attribute burst */ |
#define GSMTAP_BURST_COMPACT_SCH 0x05 |
#define GSMTAP_BURST_CTS_SCH 0x04 |
#define GSMTAP_BURST_DUMMY 0x07 |
#define GSMTAP_BURST_FCCH 0x01 |
#define GSMTAP_BURST_FCH 0x11 /* WiMAX FCH burst */ |
#define GSMTAP_BURST_FFB 0x12 /* WiMAX Fast Feedback burst */ |
#define GSMTAP_BURST_HACK 0x14 /* WiMAX HARQ ACK burst */ |
#define GSMTAP_BURST_NONE 0x09 |
#define GSMTAP_BURST_NORMAL 0x06 |
#define GSMTAP_BURST_PARTIAL_SCH 0x02 |
#define GSMTAP_BURST_PDU 0x13 /* WiMAX PDU burst */ |
#define GSMTAP_BURST_PHY_ATTRIBUTES 0x15 /* WiMAX PHY Attributes burst */ |
#define GSMTAP_BURST_SCH 0x03 |
#define GSMTAP_BURST_UNKNOWN 0x00 |
#define GSMTAP_CHANNEL_ACCH 0x80 |
#define GSMTAP_CHANNEL_AGCH 0x04 |
#define GSMTAP_CHANNEL_BCCH 0x01 |
#define GSMTAP_CHANNEL_CBCH51 0x0f |
#define GSMTAP_CHANNEL_CBCH52 0x0c |
#define GSMTAP_CHANNEL_CCCH 0x02 |
#define GSMTAP_CHANNEL_FACCH_F 0x09 /* Actually, it's FACCH/F (signaling) */ |
#define GSMTAP_CHANNEL_FACCH_H 0x0a /* Actually, it's FACCH/H (signaling) */ |
#define GSMTAP_CHANNEL_PACCH 0x0b |
#define GSMTAP_CHANNEL_PCH 0x05 |
#define GSMTAP_CHANNEL_PDCH GSMTAP_CHANNEL_PDTCH |
#define GSMTAP_CHANNEL_PDTCH 0x0d |
#define GSMTAP_CHANNEL_PTCCH 0x0e |
#define GSMTAP_CHANNEL_RACH 0x03 |
#define GSMTAP_CHANNEL_SDCCH 0x06 |
#define GSMTAP_CHANNEL_SDCCH4 0x07 |
#define GSMTAP_CHANNEL_SDCCH8 0x08 |
#define GSMTAP_CHANNEL_TCH_F GSMTAP_CHANNEL_FACCH_F /* We used the wrong naming in 2008 when we were young */ |
#define GSMTAP_CHANNEL_TCH_H GSMTAP_CHANNEL_FACCH_H /* We used the wrong naming in 2008 when we were young */ |
#define GSMTAP_CHANNEL_UNKNOWN 0x00 |
#define GSMTAP_CHANNEL_VOICE_F 0x10 /* voice codec payload (FR/EFR/AMR) */ |
#define GSMTAP_CHANNEL_VOICE_H 0x11 /* voice codec payload (HR/AMR) */ |
#define GSMTAP_E1T1_FR 0x02 /* Frame Relay */ |
#define GSMTAP_E1T1_LAPD 0x01 /* Q.921 LAPD */ |
#define GSMTAP_E1T1_PPP 0x0b /* PPP */ |
#define GSMTAP_E1T1_RAW 0x03 /* raw/transparent B-channel */ |
#define GSMTAP_E1T1_TRAU16 0x04 /* 16k TRAU frames; sub-slot 0-3 */ |
#define GSMTAP_E1T1_TRAU8 0x05 /* 8k TRAU frames; sub-slot 0-7 */ |
#define GSMTAP_E1T1_V5EF 0x06 /* V5 Envelope Function */ |
#define GSMTAP_GMR1_AGCH 0x04 |
#define GSMTAP_GMR1_BACH 0x05 |
#define GSMTAP_GMR1_BCCH 0x01 |
#define GSMTAP_GMR1_CBCH 0x07 |
#define GSMTAP_GMR1_CCCH 0x02 /* either AGCH or PCH */ |
#define GSMTAP_GMR1_DKAB 0x03 /* to be combined with _TCH3 */ |
#define GSMTAP_GMR1_FACCH 0x02 /* to be combines with _TCH{3,6,9} */ |
#define GSMTAP_GMR1_GBCH 0x0a |
#define GSMTAP_GMR1_PCH 0x03 |
#define GSMTAP_GMR1_RACH 0x06 |
#define GSMTAP_GMR1_SACCH 0x01 /* to be combined with _TCH{6,9} */ |
#define GSMTAP_GMR1_SDCCH 0x08 |
#define GSMTAP_GMR1_TACCH 0x09 |
#define GSMTAP_GMR1_TCH3 0x10 |
#define GSMTAP_GMR1_TCH6 0x14 |
#define GSMTAP_GMR1_TCH9 0x18 |
#define GSMTAP_GMR1_UNKNOWN 0x00 |
#define GSMTAP_GPRS_CS | ( | N | ) | (GSMTAP_GPRS_CS_BASE + N) |
#define GSMTAP_GPRS_CS_BASE 0x20 |
#define GSMTAP_GPRS_MCS | ( | N | ) | (GSMTAP_GPRS_MCS_BASE + N) |
#define GSMTAP_GPRS_MCS_BASE 0x30 |
#define GSMTAP_LTE_CH_BCCH 0x01 |
#define GSMTAP_LTE_CH_CCCH 0x02 |
#define GSMTAP_LTE_CH_DCCH 0x03 |
#define GSMTAP_LTE_CH_DTCH 0x06 |
#define GSMTAP_LTE_CH_MCCH 0x04 |
#define GSMTAP_LTE_CH_MTCH 0x07 |
#define GSMTAP_LTE_CH_PCCH 0x05 |
#define GSMTAP_SIM_APDU 0x00 /* APDU data (complete APDU) */ |
#define GSMTAP_SIM_ATR 0x01 /* card ATR data */ |
#define GSMTAP_SIM_PPS_REQ 0x02 /* PPS request data */ |
#define GSMTAP_SIM_PPS_RSP 0x03 /* PPS response data */ |
#define GSMTAP_SIM_TPDU_CMD 0x05 /* TPDU command body */ |
#define GSMTAP_SIM_TPDU_HDR 0x04 /* TPDU command header */ |
#define GSMTAP_SIM_TPDU_RSP 0x06 /* TPDU response body */ |
#define GSMTAP_SIM_TPDU_SW 0x07 /* TPDU response trailer */ |
#define GSMTAP_TETRA_AACH 0x02 |
#define GSMTAP_TETRA_BNCH 0x06 |
#define GSMTAP_TETRA_BSCH 0x01 |
#define GSMTAP_TETRA_DMO_SCH_F 0x0b |
#define GSMTAP_TETRA_DMO_SCH_H 0x0a |
#define GSMTAP_TETRA_DMO_SCH_S 0x09 |
#define GSMTAP_TETRA_DMO_STCH 0x0c |
#define GSMTAP_TETRA_DMO_TCH 0x0d |
#define GSMTAP_TETRA_SCH_F 0x05 |
#define GSMTAP_TETRA_SCH_HD 0x04 |
#define GSMTAP_TETRA_SCH_HU 0x03 |
#define GSMTAP_TETRA_STCH 0x07 |
#define GSMTAP_TETRA_TCH_F 0x08 |
#define GSMTAP_TYPE_ABIS 0x02 |
#define GSMTAP_TYPE_E1T1 0x13 /* E1/T1 Lines */ |
#define GSMTAP_TYPE_GB_LLC 0x08 /* GPRS Gb interface: LLC */ |
#define GSMTAP_TYPE_GB_SNDCP 0x09 /* GPRS Gb interface: SNDCP */ |
#define GSMTAP_TYPE_GMR1_UM 0x0a /* GMR-1 L2 packets */ |
#define GSMTAP_TYPE_GSM_RLP 0x14 /* GSM RLP frames as per 3GPP TS 24.022 */ |
#define GSMTAP_TYPE_LTE_MAC 0x0e /* LTE MAC interface */ |
#define GSMTAP_TYPE_LTE_MAC_FRAMED 0x0f /* LTE MAC with context hdr */ |
#define GSMTAP_TYPE_LTE_NAS 0x12 /* LTE Non-Access Stratum */ |
#define GSMTAP_TYPE_LTE_RRC 0x0d /* LTE interface */ |
#define GSMTAP_TYPE_OSMOCORE_LOG 0x10 /* libosmocore logging */ |
#define GSMTAP_TYPE_QC_DIAG 0x11 /* Qualcomm DIAG frame */ |
#define GSMTAP_TYPE_SIM 0x04 /* ISO 7816 smart card interface */ |
#define GSMTAP_TYPE_TETRA_I1 0x05 /* tetra air interface */ |
#define GSMTAP_TYPE_TETRA_I1_BURST 0x06 /* tetra air interface */ |
#define GSMTAP_TYPE_UM 0x01 |
#define GSMTAP_TYPE_UM_BURST 0x03 /* raw burst bits */ |
#define GSMTAP_TYPE_UMTS_RLC_MAC 0x0b |
#define GSMTAP_TYPE_UMTS_RRC 0x0c |
#define GSMTAP_TYPE_WMX_BURST 0x07 /* WiMAX burst */ |
#define GSMTAP_UDP_PORT 4729 |
#define GSMTAP_UMTS_CH_CCCH 0x02 |
#define GSMTAP_UMTS_CH_DCCH 0x03 |
#define GSMTAP_UMTS_CH_PCCH 0x01 |
#define GSMTAP_VERSION 0x02 |
anonymous enum |
anonymous enum |
enum gsmtap_um_voice_type |
First byte of type==GSMTAP_TYPE_UM sub_type==GSMTAP_CHANNEL_VOICE payload.
enum gsmtap_um_voice_type __attribute__ |
uint8_t _pad[3] |
uint8_t antenna_nr |
Antenna Number.
uint16_t arfcn |
ARFCN (frequency)
Referenced by gsmtap_makemsg(), and gsmtap_makemsg_ex().
uint32_t frame_number |
GSM Frame Number (FN)
uint8_t hdr_len |
length in number of 32bit words
uint8_t level |
logging level
Referenced by _file_raw_output(), _gsmtap_raw_output(), _msgb_eq(), _osmo_backtrace(), _output(), _output_buf(), _systemd_output(), _systemd_raw_output(), level_color(), log_cache_check(), log_cache_update(), log_check_level(), log_parse_category_mask(), log_set_category_filter(), logp2(), logp2syslog_level(), osmo_log_backtrace(), and osmo_vlogp().
uint32_t line_nr |
line number
char name[32] |
source file name
uint32_t pid |
process ID
Referenced by osmo_daemonize().
char proc_name[16] |
name of process
uint8_t res |
reserved for future use (RFU)
uint32_t sec |
int8_t signal_dbm |
signal level in dBm
Referenced by gsmtap_makemsg(), and gsmtap_makemsg_ex().
int8_t snr_db |
signal/noise ratio in dB
struct { ... } src_file |
uint8_t sub_slot |
sub-slot within timeslot
uint8_t sub_type |
Type of burst/channel, see above.
char subsys[16] |
logging sub-system
Referenced by _file_raw_output(), _gsmtap_raw_output(), _osmo_backtrace(), _output(), _output_buf(), _systemd_raw_output(), color(), log_category_name(), log_check_level(), logp(), logp2(), map_subsys(), osmo_log_backtrace(), osmo_signal_dispatch(), osmo_signal_register_handler(), osmo_signal_unregister_handler(), osmo_vlogp(), should_log_to_target(), and subsys_lib2index().
uint8_t timeslot |
timeslot (0..7 on Um)
struct { ... } ts |
Referenced by gsmtap_makemsg(), and gsmtap_makemsg_ex().
uint8_t type |
see GSMTAP_TYPE_*
uint32_t usec |
uint8_t version |
version, set to 0x01 currently