gprs_bssgp.h File Reference

#include <stdint.h>
#include <osmocom/core/timer.h>
#include <osmocom/core/linuxlist.h>
#include <osmocom/gsm/gsm48.h>
#include <osmocom/gsm/prim.h>
#include <osmocom/gprs/protocol/gsm_08_18.h>
#include <osmocom/gsm/tlv.h>
#include <osmocom/gprs/gprs_msgb.h>

Go to the source code of this file.

Data Structures
struct	osmo_bssgp_prim
struct	bssgp_flow_control
	BSSGP flow control (SGSN side) According to Section 8.2. More...
struct	bssgp_bvc_ctx
struct	bssgp_lv
struct	bssgp_dl_ud_par
struct	bssgp_paging_info
	BSSGP paging information. More...

Macros
#define	BVC_S_BLOCKED   0x0001
#define	BVC_F_BLOCKED   0x0001

Enumerations
enum	bssgp_prim {   PRIM_BSSGP_DL_UD,   PRIM_BSSGP_UL_UD,   PRIM_BSSGP_PTM_UD,   PRIM_BSSGP_GMM_SUSPEND,   PRIM_BSSGP_GMM_RESUME,   PRIM_BSSGP_GMM_PAGING,   PRIM_NM_FLUSH_LL,   PRIM_NM_LLC_DISCARDED,   PRIM_NM_BVC_RESET,   PRIM_NM_BVC_BLOCK,   PRIM_NM_BVC_UNBLOCK,   PRIM_NM_STATUS }
enum	bssgp_ctr {   BSSGP_CTR_PKTS_IN,   BSSGP_CTR_PKTS_OUT,   BSSGP_CTR_BYTES_IN,   BSSGP_CTR_BYTES_OUT,   BSSGP_CTR_BLOCKED,   BSSGP_CTR_DISCARDED,   BSSGP_CTR_STATUS }
enum	bssgp_paging_mode {   BSSGP_PAGING_PS,   BSSGP_PAGING_CS }
	BSSGP Paging mode. More...
enum	bssgp_paging_scope {   BSSGP_PAGING_BSS_AREA,   BSSGP_PAGING_LOCATION_AREA,   BSSGP_PAGING_ROUTEING_AREA,   BSSGP_PAGING_BVCI }
	BSSGP Paging scope. More...

Functions
struct msgb *	bssgp_msgb_alloc (void)
struct msgb *	bssgp_msgb_copy (const struct msgb *msg, const char *name)
const char *	bssgp_cause_str (enum gprs_bssgp_cause cause)
const char *	bssgp_pdu_str (enum bssgp_pdu_type pdu)
int	bssgp_tx_simple_bvci (uint8_t pdu_type, uint16_t nsei, uint16_t bvci, uint16_t ns_bvci)
int	bssgp_tx_status (uint8_t cause, uint16_t *bvci, struct msgb *orig_msg)
struct bssgp_bvc_ctx *	btsctx_by_raid_cid (const struct gprs_ra_id *raid, uint16_t cid)
struct bssgp_bvc_ctx *	btsctx_by_bvci_nsei (uint16_t bvci, uint16_t nsei)
int	bssgp_rcvmsg (struct msgb *msg)
int	bssgp_tx_dl_ud (struct msgb *msg, uint16_t pdu_lifetime, struct bssgp_dl_ud_par *dup)
uint16_t	bssgp_parse_cell_id (struct gprs_ra_id *raid, const uint8_t *buf)
int	bssgp_create_cell_id (uint8_t *buf, const struct gprs_ra_id *raid, uint16_t cid)
static int	bssgp_tlv_parse (struct tlv_parsed *tp, uint8_t *buf, int len)
int	bssgp_tx_paging (uint16_t nsei, uint16_t ns_bvci, struct bssgp_paging_info *pinfo)
void	bssgp_fc_init (struct bssgp_flow_control *fc, uint32_t bucket_size_max, uint32_t bucket_leak_rate, uint32_t max_queue_depth, int(*out_cb)(struct bssgp_flow_control *fc, struct msgb *msg, uint32_t llc_pdu_len, void *priv))
int	bssgp_fc_in (struct bssgp_flow_control *fc, struct msgb *msg, uint32_t llc_pdu_len, void *priv)
int	bssgp_fc_ms_init (struct bssgp_flow_control *fc_ms, uint16_t bvci, uint16_t nsei, uint32_t max_queue_depth)
void	bssgp_flush_all_queues ()
	Flush the queues of all BSSGP contexts. More...
void	bssgp_fc_flush_queue (struct bssgp_flow_control *fc)
	Flush the queue of the bssgp_flow_control. More...
int	bssgp_vty_init (void)
void	bssgp_set_log_ss (int ss)
int	bssgp_prim_cb (struct osmo_prim_hdr *oph, void *ctx)

Variables
struct gprs_ns_inst *	bssgp_nsi
struct llist_head	bssgp_bvc_ctxts

Macro Definition Documentation

#define BVC_F_BLOCKED   0x0001

#define BVC_S_BLOCKED   0x0001

Referenced by bssgp_rx_bvc_block(), bssgp_rx_bvc_reset(), bssgp_rx_bvc_unblock(), bssgp_rx_ptp(), and dump_bvc().

Enumeration Type Documentation

enum bssgp_ctr

Enumerator
BSSGP_CTR_PKTS_IN
BSSGP_CTR_PKTS_OUT
BSSGP_CTR_BYTES_IN
BSSGP_CTR_BYTES_OUT
BSSGP_CTR_BLOCKED
BSSGP_CTR_DISCARDED
BSSGP_CTR_STATUS

enum bssgp_paging_mode

BSSGP Paging mode.

Enumerator
BSSGP_PAGING_PS
BSSGP_PAGING_CS

enum bssgp_paging_scope

BSSGP Paging scope.

Enumerator
BSSGP_PAGING_BSS_AREA	all cells in BSS
BSSGP_PAGING_LOCATION_AREA	all cells in LA
BSSGP_PAGING_ROUTEING_AREA	all cells in RA
BSSGP_PAGING_BVCI	one cell

enum bssgp_prim

Enumerator
PRIM_BSSGP_DL_UD
PRIM_BSSGP_UL_UD
PRIM_BSSGP_PTM_UD
PRIM_BSSGP_GMM_SUSPEND
PRIM_BSSGP_GMM_RESUME
PRIM_BSSGP_GMM_PAGING
PRIM_NM_FLUSH_LL
PRIM_NM_LLC_DISCARDED
PRIM_NM_BVC_RESET
PRIM_NM_BVC_BLOCK
PRIM_NM_BVC_UNBLOCK
PRIM_NM_STATUS

Function Documentation

const char* bssgp_cause_str

(

enum gprs_bssgp_cause

cause

)

References get_value_string().

Referenced by bssgp_rx_bvc_reset(), bssgp_rx_status(), bssgp_tx_bvc_block(), bssgp_tx_bvc_ptp_reset(), bssgp_tx_bvc_reset(), bssgp_tx_status(), and common_tx_radio_status2().

int bssgp_create_cell_id	(	uint8_t *	buf,
		const struct gprs_ra_id *	raid,
		uint16_t	cid
	)

Referenced by bssgp_tx_bvc_reset(), and bssgp_tx_ul_ud().

void bssgp_fc_flush_queue

(

struct bssgp_flow_control *

fc

)

Flush the queue of the bssgp_flow_control.

Parameters

[in]

The

flow control object which holds the queue.

References bssgp_fc_queue_element::list, llist_del(), llist_for_each_entry_safe, bssgp_fc_queue_element::msg, msgb_free(), and bssgp_flow_control::queue.

Referenced by bssgp_flush_all_queues().

int bssgp_fc_in	(	struct bssgp_flow_control *	fc,
		struct msgb *	msg,
		uint32_t	llc_pdu_len,
		void *	priv
	)

References bssgp_fc_needs_queueing(), bssgp_flow_control::bucket_size_max, DBSSGP, fc_enqueue(), LOGL_NOTICE, LOGP, msgb_free(), osmo_gettimeofday(), bssgp_flow_control::out_cb, and bssgp_flow_control::time_last_pdu.

Referenced by bssgp_fc_ms_init(), and bssgp_tx_dl_ud().

void bssgp_fc_init	(	struct bssgp_flow_control *	fc,
		uint32_t	bucket_size_max,
		uint32_t	bucket_leak_rate,
		uint32_t	max_queue_depth,
		int(*)(struct bssgp_flow_control *fc, struct msgb *msg, uint32_t llc_pdu_len, void *priv)	out_cb
	)

References bssgp_flow_control::bucket_leak_rate, bssgp_flow_control::bucket_size_max, INIT_LLIST_HEAD, bssgp_flow_control::max_queue_depth, osmo_gettimeofday(), bssgp_flow_control::out_cb, bssgp_flow_control::queue, and bssgp_flow_control::time_last_pdu.

Referenced by bssgp_fc_ms_init(), and btsctx_alloc().

int bssgp_fc_ms_init	(	struct bssgp_flow_control *	fc_ms,
		uint16_t	bvci,
		uint16_t	nsei,
		uint32_t	max_queue_depth
	)

References bssgp_bvc_ctx::bmax_default_ms, bssgp_fc_in(), bssgp_fc_init(), btsctx_by_bvci_nsei(), and bssgp_bvc_ctx::r_default_ms.

void bssgp_flush_all_queues

(

)

Flush the queues of all BSSGP contexts.

References bssgp_bvc_ctxts, bssgp_fc_flush_queue(), bssgp_bvc_ctx::fc, bssgp_bvc_ctx::list, and llist_for_each_entry.

struct msgb* bssgp_msgb_alloc

(

void

)

References msgb::data, msgb_alloc_headroom(), msgb_bssgph, and OSMO_ASSERT.

Referenced by bssgp_tx_bvc_block(), bssgp_tx_bvc_reset(), bssgp_tx_bvc_unblock(), bssgp_tx_fc_bvc(), bssgp_tx_fc_bvc_ack(), bssgp_tx_fc_ms(), bssgp_tx_flush_ll_ack(), bssgp_tx_llc_discarded(), bssgp_tx_paging(), bssgp_tx_ra_capa_upd(), bssgp_tx_resume(), bssgp_tx_resume_ack(), bssgp_tx_resume_nack(), bssgp_tx_simple_bvci(), bssgp_tx_status(), bssgp_tx_suspend(), bssgp_tx_suspend_ack(), bssgp_tx_suspend_nack(), and common_tx_radio_status().

struct msgb* bssgp_msgb_copy	(	const struct msgb *	msg,
		const char *	name
	)

References msgb::_data, libgb_msgb_cb::bssgp_cell_id, libgb_msgb_cb::bssgph, libgb_msgb_cb::bvci, LIBGB_MSGB_CB, libgb_msgb_cb::llch, msgb_copy(), libgb_msgb_cb::nsei, and libgb_msgb_cb::tlli.

uint16_t bssgp_parse_cell_id	(	struct gprs_ra_id *	raid,
		const uint8_t *	buf
	)

Referenced by bssgp_rx_bvc_reset().

const char* bssgp_pdu_str

(

enum bssgp_pdu_type

pdu

)

References get_value_string().

Referenced by bssgp_rcvmsg(), bssgp_rx_ptp(), and bssgp_rx_sign().

int bssgp_prim_cb	(	struct osmo_prim_hdr *	oph,
		void *	ctx
	)

Referenced by bssgp_rx_bvc_block(), bssgp_rx_bvc_reset(), bssgp_rx_bvc_unblock(), bssgp_rx_llc_disc(), bssgp_rx_resume(), bssgp_rx_status(), bssgp_rx_suspend(), and bssgp_rx_ul_ud().

int bssgp_rcvmsg

(

struct msgb *

msg

)

References BSSGP_CAUSE_INV_MAND_INF, BSSGP_CAUSE_PDU_INCOMP_FEAT, BSSGP_CAUSE_UNKNOWN_BVCI, BSSGP_CTR_BYTES_IN, BSSGP_CTR_PKTS_IN, BSSGP_IE_BVCI, bssgp_pdu_str(), BSSGP_PDUT_BVC_RESET, BSSGP_PDUT_DL_UNITDATA, BSSGP_PDUT_STATUS, BSSGP_PDUT_UL_UNITDATA, bssgp_rx_ptp(), bssgp_rx_sign(), bssgp_rx_status(), bssgp_tlv_parse(), bssgp_tx_status(), btsctx_by_bvci_nsei(), bvci, BVCI_PTM, BVCI_SIGNALLING, rate_ctr_group::ctr, bssgp_bvc_ctx::ctrg, bssgp_ud_hdr::data, bssgp_normal_hdr::data, DBSSGP, LOG_CTX_GB_BVC, log_set_context(), LOGL_ERROR, LOGL_NOTICE, LOGP, msgb_bssgp_len, msgb_bssgph, msgb_bvci, msgb_hexdump(), msgb_nsei, pdu_type, bssgp_normal_hdr::pdu_type, rate_ctr_add(), and rate_ctr_inc().

void bssgp_set_log_ss

(

int

ss

)

References DBSSGP.

static int bssgp_tlv_parse ( struct tlv_parsed *  tp, uint8_t *  buf, int  len  )

inlinestatic

Referenced by bssgp_rcvmsg(), and bssgp_rx_paging().

int bssgp_tx_dl_ud	(	struct msgb *	msg,
		uint16_t	pdu_lifetime,
		struct bssgp_dl_ud_par *	dup
	)

References BSSGP_CTR_BYTES_OUT, BSSGP_CTR_PKTS_OUT, bssgp_fc_in(), BSSGP_IE_DRX_PARAMS, BSSGP_IE_IMSI, BSSGP_IE_LLC_PDU, BSSGP_IE_MS_RADIO_ACCESS_CAP, BSSGP_IE_PDU_LIFETIME, BSSGP_IE_TLLI, BSSGP_PDUT_DL_UNITDATA, btsctx_by_bvci_nsei(), bvci, BVCI_PTM, rate_ctr_group::ctr, bssgp_bvc_ctx::ctrg, DBSSGP, bssgp_dl_ud_par::drx_parms, bssgp_bvc_ctx::fc, bssgp_dl_ud_par::fc, bssgp_dl_ud_par::imsi, msgb::len, bssgp_lv::len, LOGL_ERROR, LOGP, bssgp_dl_ud_par::ms_ra_cap, msgb_bvci, msgb_free(), msgb_nsei, msgb_push(), msgb_tlli, nsei, OSMO_ASSERT, osmo_htonl, osmo_htons, bssgp_ud_hdr::pdu_type, bssgp_ud_hdr::qos_profile, bssgp_dl_ud_par::qos_profile, rate_ctr_add(), rate_ctr_inc(), bssgp_ud_hdr::tlli, tlli, bssgp_dl_ud_par::tlli, and bssgp_lv::v.

int bssgp_tx_paging	(	uint16_t	nsei,
		uint16_t	ns_bvci,
		struct bssgp_paging_info *	pinfo
	)

References BSSGP_IE_BSS_AREA_ID, BSSGP_IE_BVCI, BSSGP_IE_DRX_PARAMS, BSSGP_IE_IMSI, BSSGP_IE_LOCATION_AREA, BSSGP_IE_QOS_PROFILE, BSSGP_IE_TMSI, bssgp_msgb_alloc(), bssgp_msgb_ra_put(), bssgp_nsi, BSSGP_PAGING_BSS_AREA, BSSGP_PAGING_BVCI, BSSGP_PAGING_LOCATION_AREA, BSSGP_PAGING_PS, BSSGP_PAGING_ROUTEING_AREA, BSSGP_PDUT_PAGING_CS, BSSGP_PDUT_PAGING_PS, bvci, bssgp_paging_info::bvci, bssgp_paging_info::drx_params, gprs_ns_sendmsg(), bssgp_paging_info::imsi, bssgp_paging_info::mode, msgb_bvci, msgb_nsei, msgb_put(), nsei, osmo_htonl, osmo_htons, bssgp_normal_hdr::pdu_type, bssgp_paging_info::ptmsi, bssgp_paging_info::qos, bssgp_paging_info::raid, and bssgp_paging_info::scope.

int bssgp_tx_simple_bvci	(	uint8_t	pdu_type,
		uint16_t	nsei,
		uint16_t	bvci,
		uint16_t	ns_bvci
	)

References BSSGP_IE_BVCI, bssgp_msgb_alloc(), gprs_ns_sendmsg(), msgb_bvci, msgb_nsei, msgb_put(), nsei, osmo_htons, pdu_type, and bssgp_normal_hdr::pdu_type.

Referenced by bssgp_rx_bvc_block(), bssgp_rx_bvc_reset(), and bssgp_rx_bvc_unblock().

int bssgp_tx_status	(	uint8_t	cause,
		uint16_t *	bvci,
		struct msgb *	orig_msg
	)

References BSSGP_CAUSE_BVCI_BLOCKED, bssgp_cause_str(), BSSGP_CAUSE_UNKNOWN_BVCI, BSSGP_IE_BVCI, BSSGP_IE_CAUSE, BSSGP_IE_PDU_IN_ERROR, bssgp_msgb_alloc(), BSSGP_PDUT_STATUS, DBSSGP, gprs_ns_sendmsg(), LOGL_ERROR, LOGL_NOTICE, LOGP, msgb_bssgp_len, msgb_bssgph, msgb_bvci, msgb_nsei, msgb_put(), osmo_htons, and bssgp_normal_hdr::pdu_type.

Referenced by bssgp_rcvmsg(), bssgp_rx_bvc_block(), bssgp_rx_bvc_unblock(), bssgp_rx_fc_bvc(), bssgp_rx_ptp(), bssgp_rx_resume(), bssgp_rx_sign(), bssgp_rx_suspend(), and bssgp_rx_ul_ud().

int bssgp_vty_init

(

void

)

References bssgp_node, and config_write_bssgp().

struct bssgp_bvc_ctx* btsctx_by_bvci_nsei	(	uint16_t	bvci,
		uint16_t	nsei
	)

References bssgp_bvc_ctxts, bssgp_bvc_ctx::bvci, bssgp_bvc_ctx::list, llist_for_each_entry, and bssgp_bvc_ctx::nsei.

Referenced by bssgp_fc_ms_init(), bssgp_rcvmsg(), bssgp_rx_bvc_block(), bssgp_rx_bvc_reset(), bssgp_rx_bvc_unblock(), bssgp_tx_dl_ud(), and DEFUN().

struct bssgp_bvc_ctx* btsctx_by_raid_cid	(	const struct gprs_ra_id *	raid,
		uint16_t	cid
	)

References bssgp_bvc_ctxts, bssgp_bvc_ctx::cell_id, bssgp_bvc_ctx::list, llist_for_each_entry, and bssgp_bvc_ctx::ra_id.

Variable Documentation

struct llist_head bssgp_bvc_ctxts

Referenced by bssgp_flush_all_queues(), bssgp_tx_bvc_ptp_reset(), btsctx_alloc(), btsctx_by_bvci_nsei(), btsctx_by_raid_cid(), DEFUN(), and dump_bssgp().

struct gprs_ns_inst* bssgp_nsi

Referenced by _bssgp_tx_dl_ud(), bssgp_tx_bvc_block(), bssgp_tx_bvc_reset(), bssgp_tx_bvc_unblock(), bssgp_tx_fc_bvc(), bssgp_tx_fc_bvc_ack(), bssgp_tx_fc_ms(), bssgp_tx_flush_ll_ack(), bssgp_tx_llc_discarded(), bssgp_tx_paging(), bssgp_tx_ra_capa_upd(), bssgp_tx_resume(), bssgp_tx_resume_ack(), bssgp_tx_resume_nack(), bssgp_tx_suspend(), bssgp_tx_suspend_ack(), bssgp_tx_suspend_nack(), bssgp_tx_ul_ud(), and common_tx_radio_status2().