OpenSS7
SS7 for the
Common Man
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.
Last modified: Tue, 29 Apr 2008 07:10:31 GMT
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manpage of SLI
Quick Links

Download

SCTP

SIGTRAN

SS7

Hardware

STREAMS

Asterisk

Related

Package

Manual

FAQ

Man Pages

Applications

SS7 Stack

ISDN Stack

SIGTRAN Stack

VoIP Stack

MG Stack

SS7/ISDN Devices

IP Transport

Embedded Systems

OS

Documentation

FAQ

SIGTRAN

Design

Conformance

Performance

References

Man Pages

Manuals

Papers

Home

Overview

Status

Documentation

Resources

About

News

Manpage of SLI

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci


SLI

Section: The OpenSS7 Project Signalling Link Interface (SLI) (7)
Updated: Thu, 14 Dec 2017 14:51:19 GMT
Index Return to Main Contents

NAME

sli - Signalling System No. 7 Signalling Link (SL) Interface

SYNOPSIS

#include <ss7/sli.h>
#include <ss7/sli_ioctl.h>

int fd = open(``/dev/sl'', flags);
int retval = ioctl(fd, cmd, ... /* arg */ );

DESCRIPTION


This man page describes the STREAMS interface which is used to configure and exchange data with an SS7 Signalling Link Interface (SLI) for all SS7 devices conforming to the OpenSS7 Signalling Link Interface (SLI) specification.

LOCAL MANAGEMENT INTERFACE

SLI drivers are normally linked using streamio(2) I_LINK ioctl commands under a Signalling Link Set (SLS) STREAMS multiplexor conforming to the Signalling Link Set Interface (SLSI) specification slsi(7) such as sls(4), by the SS7 Configuration Daemon ss7d(8). Yet, this interface is available for the purpose of ferry-clip conformance and diagnostic testing of the SS7 Signalling Link.

SLI Stype 1 and Style 2 drivers may be configured to automatically link under the sls(4) multiplexor and appear as slsi(7) drivers. Not all SS7 drivers need be written to the SL or lower interfaces: drivers may be written to the slsi(7) and even mtpi(7) interfaces.

SLI provides a local management interface which utilizes M_PROTO and M_PCPROTO messages which can be exchanged with the interface using putmsg(2) and getmsg(2) system calls on the stream head once the interface is opened. The local management interfae controls local management (STREAMS configuration functions) which are normally used by the SS7 Configuration Daemon ss7d(8) on the driver interface before linking under an sls(4) multiplexor.

The Local Management Interface (LMI) is common to all OpenSS7 drivers and modules and is described in detail in lmi(7).

DEVICE CONTROL INTERFACE

SLI provides a device control interface which utilizes ioctl(2) transparent calls or an I_STR ioctl under streamio(2) from a stream head or multiplexor control channel to the driver. The device control interface controls aspects of the SL driver device which are outside the scope of the SS7 protocol. These controls are normally issued by the SS7 Configuration Daemon ss7d(8) on the driver interface or multiplexor control channel before or after the protocol stack has been assembled.

The device control interface (DEVI) is common to all OpenSS7 drivers and modules and is described in detail in devi(7).

PROTOCOL SERVICE INTERFACE

SLI provides a protocol service interface which uses M_DATA, M_PROTO and M_PCPROTO STREAMS messages which can be exchanged with write(2), read(2), putmsg(2) or getmsg(2) system calls on the stream head, or which can be exchanged with the driver by upstream pushed or linked modules. The protocol service interface exchanges SS7 protocol service primitives between the Signalling Link (SL) and the Signalling Link Set (SLS), but may also be used for ferry-clip conformance testing or diagnostics.

The protocol service interface for SLI is described in detail in section PROTOCOL SERVICE INTERFACE, below.

PROTOCOL MANAGEMENT INTERFACE

SLI provides a protocol mangement interface which uses M_CTL messages between modules or M_IOCTL messages from a stream head or multiplexor control channel. This interface uses the controls defined in the Local Management Interface (LMI) as detailed under INPUT OUTPUT CONTROL INTERFACE in lmi(7). The protocol management interface provides protocol configuration, state inquiry, statistics and event management (SNMP functions). This interface is normally used by the SS7 Configuration Daemon ss7d(8) on the stream after opening or during operation.

The protocol service interface for SLI is described in detail in section PROTOCOL MANAGEMENT INTERFACE below.

PROTOCOL SERVICE INTERFACE

Protocol service interface commands are from the stream head to the SL driver using putmsg(2) and getmsg(2) commands as follows:

fd = open("/dev/sl");
ret = putmsg(fd, ctlptr, dataptr, flags);
ret = getmsg(fd, ctlptr, dataptr, flags);

Downstream messages are sent from the stream head using putmsg(2); upstream messages are received at the stream head using getmsg(2).

flags is either RS_HIPRI or not indicating a M_PCPROTO or an M_PROTO message respectively. ctlptr and dataptr are pointers to a strbuf structure which contains the following members:

struct strbuf {
    int     maxlen;
    int     len;
    void    *buf;
};

buf contains a pointer to a SL_primitive union which contains one of the following primitives and structures:

Downstream Primitives

Downstream primitives are sent from the stream head to the protocol state machines using putmsg(2) system calls as described above. Except where otherwise noted, buf contains only the sl_primitive field which is set to the value of the primitive.

SL_PDU_REQ(7)
Transmit a Protocol Data Unit (PDU). This primitive must be sent with an accompanying M_DATA block which is pointed to by the dataptr in a putmsg(2) or is the buffer which is the argument of a write(2) on the stream file descriptor.
SL_EMERGENCY_REQ(7)
Set emergency alignment procedures on the signalling link.
SL_EMERGENCY_CEASES_REQ(7)
Set normal alignment procedures on the signalling link.
SL_START_REQ(7)
Start the signalling link.
SL_STOP_REQ(7)
Stop the signalling link.
SL_RETRIEVE_BSNT_REQ(7)
Retreive the BSNT value for buffer updating.
SL_RETREIVAL_REQUEST_AND_FSNC_REQ(7)
Retreive the buffers from the TB/RTB up to and including FSNC. This primitive uses a sl_retrieval_request_and_fsnc_t structure which includes the sl_fsnc value in addition to the sl_primitive as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_fsnc;
} sl_retreival_req_and_fsnc_t;
sl_primitive
Contains the primitive SL_RETRIEVAL_REQ_AND_FSNC_REQ(7).
sl_fsnc
Contains the last Forward Sequence Number (FSNC) which was successfully received by the far end. Buffers in the RTB with FSN up to and including this value should be cleared as part of the retrieval.
SL_RESUME_REQ(7)
Recover from local processor outage.
SL_CLEAR_BUFFERS_REQ(7)
Clear signalling link buffers.
SL_LOCAL_PROCESSOR_OUTAGE_REQ(7)
Institute local processor outage procedures.
SL_CONGESTION_DISCARD_REQ(7)
Set congestion discard on the signalling link.
SL_CONGESTION_ACCEPT_REQ(7)
Set congestion accept on the signalling link.
SL_NO_CONGESTION_REQ(7)
Indicate cessation of congestion to the signalling link.
SL_POWER_ON_REQ(7)
Power on the signalling link.

Upstream Primitives

Upstream primitives are collected at the stream head from the protocol state machines using getmsg(2) system calls as described above. Except where otherwise noted, buf contains only the sl_primitive field which is set to the value of the primitive.

SL_PDU_IND(7)
Receive a Protocol Data Unit (PDU). This primitive is received with an accompanying M_DATA block which is pointed to by the dataptr in a getmsg(2) or is the buffer which is returned from a read(2) on the stream file descriptor.
SL_LINK_CONGESTED_IND(7)
Indicates that the signalling link is congested. This primitive indicates addtional information in the sl_link_cong_ind_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_timestamp;
    sl_ulong    sl_cong_level;
    sl_ulong    sl_disc_level;
} sl_link_cong_ind_t;
sl_primitive
Contains the primitive SL_LINK_CONGESTED_IND(7).
sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose of event reporting.
sl_cong_level
Contains the current congestion status for this link.
sl_disc_level
Contains the current discard status for this link.
SL_LINK_CONGESTION_CEASED_IND(7)
Indicates that signalling link congestion has ceased. This primitive indicates additional information in the sl_cong_ceased_ind_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_timestamp;
    sl_ulong    sl_cong_level;
    sl_ulong    sl_disc_level;
} sl_link_cong_ceased_ind_t;
sl_primitive
Contains the primitive SL_LINK_CONGESTION_CEASED_IND(7).
sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose of event reporting.
sl_cong_level
Contains the current congestion status for this link.
sl_disc_level
Contains the current discard status for this link.
SL_RETREIVED_MESSAGE_IND(7)
Indicates one retreived message during buffer retreival.
SL_RETREIVAL_COMPLETE_IND(7)
Indicates that buffer retrieval is complete and not to expect further retrieved messages.
SL_RB_CLEARED_IND(7)
Indicates that the Receive Buffer (RB) has been cleared.
SL_BSNT_IND(7)
Indicates the value of BSNT which was requested by a SL_RETRIEV_BSNT_REQ(7). This primitive indicates additional information in the sl_bsnt_ind_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_bsnt;
} sl_bsnt_ind_t;
sl_primitive
Contains the primitive SL_BSNT_IND(7).
sl_bsnt
Contains the Backward Sequence Number (BSN) for transmission (BSNT) which is the Backwards Sequence Number which will be next sent acknowledging a received MSU. This is the SN of the last successfully received MSU for use in changeover procedures and buffer updating.
SL_IN_SERVICE_IND(7)
Indicates that the signalling link is in service and ready to accept traffic.
SL_OUT_OF_SERVICE_IND(7)
Indicates that the signalling link is out of service and can no longer accept traffic. This primitive indicates additional information in the sl_out_of_service_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_timestamp;
    sl_ulong    sl_reason;
} sl_out_of_service_t;
sl_primitive
Contains the primitive SL_IN_SERVICE_IND(7).
sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose of event reporting.
sl_reason
Contains the failure reason for management reporting. The reason may be one of the following:

SL_FAIL_UNSPECIFIEDUnknown.
SL_FAIL_CONG_TIMEOUTTimeout (T6).
SL_FAIL_ACK_TIMEOUTTimeout (T7).
SL_FAIL_ABNORMAL_BSNRAbnormal BSN.
SL_FAIL_ABNORMAL_FIBRAbnormal FIB.
SL_FAIL_SUERM_EIMSUERM/EIM failure.
SL_FAIL_ALIGNMENT_NOT_POSSIBLEAlignment failure.
SL_FAIL_RECEIVED_SIOReceived SIO.
SL_FAIL_RECEIVED_SINReceived SIN.
SL_FAIL_RECEIVED_SIEReceived SIE.
SL_FAIL_RECEIVED_SIOSReceived SIOS.
SL_FAIL_T1_TIMEOUTTimeout (T1).
SL_REMOTE_PROCESSOR_OUTAGE_IND
Indicates that the remote side of the link has lost communication with its L3 processor. This primitive indicates additional information for event reporting in the sl_rem_proc_out_ind_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_timestamp;
} sl_rem_proc_out_ind_t;
sl_primitive
Contains the primitive SL_REMOTE_PROCESSOR_OUTAGE_IND(7).
sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose of event reporting.
SL_REMOTE_PROCESSOR_RECOVERED_IND(7)
Indicates that the remote side of the link has re-established communications with its L3 processor. This primitive indicates additional information for event reporting in the sl_rem_proc_recovered_ind_t structure as follows:

typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_timestamp;
} sl_rem_proc_recovered_ind_t;
sl_primitive
Contains the primitive SL_REMOTE_PROCESSOR_RECOVERED_IND(7).
sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose of event reporting.
SL_RTB_CLEARED_IND(7)
Indicates that the Re-Transmission Buffer (RTB) has been cleared.

PROTOCOL MANAGEMENT INTERFACE

Protocol management interface comands are from the stream head to the SL driver using streamio(2) I_STR commands as follows:

fd = open("/dev/sl");
ret = ioctl(fd, I_STR, arg);

Where arg is a pointer to a strioctl structure which contains the following members:

struct strioctl {
    int     ic_cmd;
    int     ic_timout;
    int     ic_len;
    char    *ic_dp;
};

ic_cmd can be one of the protocol management interface commands described in the following subsections:

Protocol Options

Protocol management controls which affect protocol options are used by local management to set protocol variants and protocol options inherent to the SL provider.

The ic_cmd contains one of the following options commands:

SL_IOCGOPTIONS
Gets the protocol variant pvar and protocol options popt assigned to the Signalling Link into the provided lmi_option structure.
SL_IOCSOPTIONS
Sets the protocol variant pvar and protocol options popt to the Signalling Link as provided in the lmi_option structure.

ic_dp points to a lmi_option structure which represents the protocol variant and options parameters as follows:

typedef struct lmi_option {
    lmi_ulong   pvar;
    lmi_ulong   popt;
} lmi_option_t;
pvar
Specifies the protocol variant to be used for the Signalling Link and may be one of the following values:
SS7_PVAR_ITUT_88ITU-T Q.703 1988 (Blue Book)
SS7_PVAR_ITUT_93ITU-T Q.703 1993 (Grey Book)
SS7_PVAR_ITUT_96ITU-T Q.703 1996 (White Book)
SS7_PVAR_ITUT_00ITU-T Q.703 2000 (? Book)
SS7_PVAR_ANSI_88ANSI T1.113-1988
SS7_PVAR_ANSI_92ANSI T1.113-1992
SS7_PVAR_ANSI_96ANSI T1.113-1996
SS7_PVAR_ANSI_00ANSI T1.113-2000
SS7_PVAR_ETSI_88ETSI 300 008-1 1988
SS7_PVAR_ETSI_93ETSI 300 008-1 1993
SS7_PVAR_ETSI_96ETSI 300 008-1 1996
SS7_PVAR_ETSI_00ETSI 300 008-1 2000
SS7_PVAR_JTTC_94JTTC JQ.703 1994
popt
Specifies the protocol options to be used for the Signalling Link and may be a bitwise OR of any of the following values:
SS7_POPT_MPLEVMulti Priority/Cong Levels
SS7_POPT_PCRPreventative Cyclic Retrans
SS7_POPT_HSLHigh Speed Links
SS7_POPT_XSNExtended Sequence Numbers
SS7_POPT_ALLAll options

Protocol Configuration

Protocol management controls which affect protocol configuration are invoked by local management to configure or request configuration information from the SL provider.

The ic_cmd contains one of the following configuration commands:

SL_IOCGCONFIG
Gets the protocol configuration of the Signalling Link into the provided sl_config structure.
SL_IOCSCONFIG
Sets the protocol configuration of the Signalling Link from the provided sl_config structure.
SL_IOCTCONFIG
Tests the protocol configuration as provided in the sl_config structure against the Signalling Link for consistency and validity. Also locks the configuration of the SL provider awaiting a commit.
SL_IOCCCONFIG
Commits the protocol configuration as provided in the sl_config structure to the Signalling Link. Also unlocks the configuration of the SL provider.

ic_dp points to a sl_config structure which represents the Signalling Link protocol configuration as follows:

typedef struct sl_config {
    sl_ulong    t1;
    sl_ulong    t2;
    sl_ulong    t2l;
    sl_ulong    t2h;
    sl_ulong    t3;
    sl_ulong    t4n;
    sl_ulong    t4e;
    sl_ulong    t5;
    sl_ulong    t6;
    sl_ulong    t7;
    sl_ulong    rb_abate;
    sl_ulong    rb_accept;
    sl_ulong    rb_discard;
    sl_ulong    tb_abate_1;
    sl_ulong    tb_onset_1;
    sl_ulong    tb_discd_1;
    sl_ulong    tb_abate_2;
    sl_ulong    tb_onset_2;
    sl_ulong    tb_discd_2;
    sl_ulong    tb_abate_3;
    sl_ulong    tb_onset_3;
    sl_ulong    tb_discd_3;
    sl_ulong    N1;
    sl_ulong    N2;
    sl_ulong    M;
} sl_config_t;
t1, t2, t2l, t2h, t3, t4n, t4e, t5, t6, t7
Contains the timeout values for Level 2 timers (in jiffies or ticks).
rb_abate, rb_accept, rb_discard
Contains the accept, discard and abate levels of the Receive Buffer (RB) in integer numbers of messages.
tb_abate_1, tb_onset_1, tb_discd_1
Contains the onset, discard and abate levels for congestion level 1 of the Transmission/Re-Transmission Buffers (TB/RTB) in number of message bytes.
tb_abate_2, tb_onset_2, tb_discd_2
Contains the onset, discard and abate levels for congestion level 2 of the Transmission/Re-Transmission Buffers (TB/RTB) in number of message bytes.
tb_abate_3, tb_onset_3, tb_discd_3
Contains the onset, discard and abate levels for congestion level 3 of the Transmission/Re-Transmission Buffers (TB/RTB) in number of message bytes.
N1, N2
Contains the Re-Transmission Buffer (RTB) occupancy which triggers forced retransmission in numbers of messages (N1) and number of message bytes (N2).
M
Contains the number of normal proving periods which must be successfully passed during normal alignment procedures (usually 5).

Protocol State

Protocol management controls which affect protocol state are invoked by local management to request information about the state of the protocol state machines in the SL provider.

The ic_cmd contains one of the following state commands:

SL_IOCGSTATEM
Gets the protocol state machine variables of the Signalling Link into the provided sl_statem structure.
SL_IOCCMRESET
Performs a master reset on the protocol state machines and returns the power-on settings of the state machine variables of the Signalling Link into the provided sl_statem structure.

ic_dp points to a sl_statem structure which represents the Signalling Link protocol state as follows:

typedef struct sl_statem {
    sl_ulong    lsc_state;
    sl_ulong      local_processor_outage;
    sl_ulong      remote_processor_outage;
    sl_ulong      processor_outage;
    sl_ulong      emergency;
    sl_ulong      l3_indication_received;
    sl_ulong      failure_reason;
    sl_ulong    iac_state;
    sl_ulong      further_proving;
    sl_ulong      t4v;
    sl_ulong      Cp;
    sl_ushort   ib_mask;
    sl_ushort   sn_mask;
    sl_ulong    txc_state;
    tx_sni_t      tx;
    sl_ulong      msu_inhibited;
    sl_ulong      lssu_available;
    sl_ulong      rtb_full;
    sl_ulong      clear_rtb;
    sl_ulong      sib_received;
    sl_ulong      retrans_cycle;
    sl_ulong      forced_retransmission;
    sl_ulong      Cm;
    sl_ulong      Ct;
    sl_ulong      cong_level;
    sl_ulong      disc_level;
    sl_ulong      Z;
    void          *z_ptr;
    sl_ulong    rc_state;
    rx_sni_t      rx;
    sl_ulong      rtr;
    sl_ulong      unb;
    sl_ulong      unf;
    sl_ulong      msu_fisu_accepted;
    sl_ulong      abnormal_bsnr;
    sl_ulong      abnormal_fibr;
    sl_ulong      congestion_discard;
    sl_ulong      congestion_accept;
    sl_ulong      l2_congestion_detect;
    sl_ulong      l3_congestion_detect;
    sl_ulong      Cr;
    sl_ulong    cc_state;
    sl_ulong    poc_state;
} sl_statem_t;
lsc_state,
local_processor_outage, remote_processor_outage, processor_outage, emergency, l3_indication_received, failure_reason
State variable, flags and counters for the Link State Control (LSC) state machine.
iac_state,
further_proving, t4v, Cp
State variable, flags and counters for the Initial Alignment Control (IAC) state machine.
ib_mask, sn_mask
Indicator bit and sequence number masks.
txc_state,
tx, msu_inhibited, lssu_available, rtb_full, clear_rtb, sib_received, retrans_cycle, forced_retransmission, Cm, Ct, cong_level, disc_level, Z, z_ptr
State variable, flags and counters for the Transmission Control (TXC) state machine.
rc_state,
rx, rtr, unb, unf, msu_fisu_accepted, abnormal_bsnr, abnormal_fibr, congestion_discard, congestion_accept, l2_congestion_detect, l3_congestion_detect, Cr
State variable, flags and counters for the Reception Control (RC) state machine.
cc_state
State variable for the Congestion Control (CC) state machine.
poc_state
State variable for the Processor Outage Control (POC) state machine.

State variables can assume one of the following values (not all values are valid for all state variables):

SL_STATE_IDLE
SL_STATE_NORMAL
SL_STATE_POWER_OFF
SL_STATE_BUSY
SL_STATE_IN_SERVICE
SL_STATE_LOCAL_PROCESSOR_OUTAGE
SL_STATE_PROVING
SL_STATE_INITIAL_ALIGNMENT
SL_STATE_NOT_ALIGNED
SL_STATE_REMOTE_PROCESSOR_OUTAGE
SL_STATE_SLEEPING
SL_STATE_ALIGNED
SL_STATE_ALIGNED_NOT_READY
SL_STATE_BOTH_PROCESSORS_OUT
SL_STATE_ALIGNED_READY
SL_STATE_OUT_OF_SERVICE
SL_STATE_PROCESSOR_OUTAGE

Protocol Data Collection

Protocol management controls which affect protocol measurement data collection are invoked by local management to request and alter collection periods for data collection within the SL provider.

ic_cmd contains one of the following collection commands:

SL_IOCGSTATSP
Get the protocol measurement collection period information of the identified object_id into the provided lmi_sta structure.
SL_IOCSSTATSP
Set the protocol measurement collection period information of the identified object_id using the provided lmi_sta structure.

ic_dp points to a lmi_sta structure which represnts the Signalling Link collection periods as follows:

typedef struct lmi_sta {
    lmi_ulong   object_id;
    lmi_ulong   colperiod;
    lmi_ulong   timestamp;
} lmi_sta_t;
object_id
Contains the object idenitfier for the managed object to which the collection information applies.
colperiod
Contains the collection period (in jiffies). The managed object measurement data must be collected and notified once for each collection period interval.
timestamp
Contains a timestamp (in seconds since epoch) which identifies the system time at which a collection period ends. This value is used in conjunction with the collection period to calculate the time of the next collection interval.

Protocol Statistics

Protocol management controls which affect protocol statistics are invoked by local management to request information about statistics pertaining to the SL provider.

ic_cmd contains one of the following statistics commands:

SL_IOCGSTATS
Get the protocol statistics of the Signalling Link for the current collection period into the provided sl_stats structure.
SL_IOCCSTATS
Clear the protocol statisics of the Signalling Link for the current collection period and return the statistics which were accumulated to the point of clearing during the current interval sl_stats structure.

ic_dp points to a sl_stats structure which represents the Signalling Link protocol statistics as follows:

typedef struct sl_stats {
    lmi_sta_t   header;
    sl_ulong    sl_dur_in_service;
    sl_ulong    sl_fail_align_or_proving;
    sl_ulong    sl_nacks_received;
    sl_ulong    sl_dur_unavail;
    sl_ulong    sl_dur_unavail_failed;
    sl_ulong    sl_dur_unavail_rpo;
    sl_ulong    sl_sibs_sent;
    sl_ulong    sl_tran_sio_sif_octets;
    sl_ulong    sl_retrans_octets;
    sl_ulong    sl_tran_msus;
    sl_ulong    sl_recv_sio_sif_octets;
    sl_ulong    sl_recv_msus;
    sl_ulong    sl_cong_onset_ind[4];
    sl_ulong    sl_dur_cong_level[4];
    sl_ulong    sl_msus_cong_discard;
    sl_ulong    sl_cong_discd_ind[4];
} sl_stats_t;

header
Contains the timestamp for the current collection interval for which statistics are being reported.
sl_dur_in_service
(Q.752 Table 0.9) Contains the duration of time that the signalling link has been in service.
sl_fail_align_or_proving
(Q.752 Table 1.7) Contains the number of times that the signalling link has failed during alignement or proving.
sl_nacks_received
(Q.752 Table 1.9) Contains the number of negative acknowledgements of MSUs received.
sl_dur_unavail
(Q.752 Table 2.1) Contains the duration of time that the signalling link has been uavailable for all reasons.
sl_dur_unavail_failed
(Q.752 Table 2.7) Contains the duration of time that the signalling link has been unavailable due to failure.
sl_dur_unavail_rpo
(Q.752 Table 2.9) Contains the duration of time that the signalling link has been unavailable due to remote processor outage.
sl_sibs_sent
(Q.752 Table 2.15) Contains the number of SIBs sent.
sl_tran_sio_sif_octets
(Q.752 Table 3.1) Contains the number of SIO/SIF octets transmitted.
sl_retrans_octets
(Q.752 Table 3.2) Contains the number of octets retransmitted.
sl_tran_msus
(Q.752 Table 3.3) Contains the number of MSUs transmitted.
sl_recv_sio_sif_octets
(Q.752 Table 3.4) Contains the number of SIO/SIF octets received.
sl_recv_msus
(Q.752 Table 3.5) Contains the number of MSUs received.
sl_cong_onset_ind[4]
(Q.752 Table 3.6) Contains the number of times that a congestion onset threshold was passed.
sl_dur_cong_level[4]
(Q.752 Table 3.7) Contains the duration of time spent in each congestion level.
sl_msus_cong_discard
(Q.752 Table 3.10) Contains the number of MSUs discarded due to congestion.
sl_cong_discd_ind[4]
(Q.752 Table 3.11) Contains the number of times that a congestion discard threshold was passed.

Protocol Events

Protocol management controls which affect notification of events to local management are invoked by local management to request information about notifications which have been requested as well as to set notification by event.

The ic_cmd contians one of the following notify commands:

SL_IOCGNOTIFY
Gets the protocol notification bitmask of the Signalling Link into the provided sl_notify structure.
SL_IOCSNOTIFY
Sets protocol notification for the Signalling Link events identified by set bits in the provided sl_notify structure.
SL_IOCCNOTIFY
Clears protocol notification for the Signalling Link events identified by set bits in the provided sl_notify structure.

ic_dp points to a sl_notify structure which represents the Signalling Link protocol event notifications as follows:

typedef struct sl_notify {
    sl_ulong   events;
} sl_notify_t;
events
Contains a bit mask with bits set for each Signalling Link event for which notification has been requested. May also contain set bits for events for which notification should be set (SL_IOCSNOTIFY) or cleared (SL_IOCCNOTIFY). The mask is the bitwise OR of any of the following values:
SL_EVT_FAIL_UNSPECIFIED
SL_EVT_FAIL_CONG_TIMEOUTQ.752 Table 1.6
SL_EVT_FAIL_ACK_TIMEOUTQ.752 Table 1.4
SL_EVT_FAIL_ABNORMAL_BSNR
SL_EVT_FAIL_ABNORMAL_FIBR
SL_EVT_FAIL_ABORMALQ.752 Table 1.3
SL_EVT_FAIL_SUERM_EIMQ.752 Table 1.5
SL_EVT_FAIL_ALIGNMENT
SL_EVT_FAIL_RECEIVED_SIO
SL_EVT_FAIL_RECEIVED_SIN
SL_EVT_FAIL_RECEIVED_SIE
SL_EVT_FAIL_RECEIVED_SIOS
SL_EVT_FAIL_T1_TIMEOUT
SL_EVT_RPO_BEGINQ.752 Table 2.10
SL_EVT_RPO_ENDQ.752 Table 2.11
SL_EVT_CONGEST_ONSET_INDQ.752 Table 3.6 1st&D
SL_EVT_CONGEST_DISCD_INDQ.752 Table 3.11 1st&D

SEE ALSO

devi(7), getmsg(2), ioctl(2), lmi(7), mtpi(7), putmsg(2), read(2), sls(4), slsi(7), ss7d(8), streamio(2), write(2)

BUGS

Too many to mention.

HISTORY

This STREAMS interface for SS7 is an original part of the OpenSS7 package.

REFERENCES

[1]
ITU-T Recommendation Q.702, Signalling System No. 7 --- Signalling Data Link, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.702/>
[2]
ITU-T Recommendation Q.703, Signalling System No. 7 --- Signalling Link, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.703/>
[3]
ITU-T Recommendation Q.704, Message Transfer Part --- Signalling Network Functions and Messages, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.704/>

TRADEMARKS

OpenSS7tm
is a trademark of OpenSS7 Corporation.
Linux®
is a registered trademark of Linus Torvalds.
UNIX®
is a registered trademark of The Open Group.
Solaris®
is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Thu, 14 Dec 2017 14:51:19 GMT.

Copyright©1997-2008OpenSS7 Corp.
All Rights Reserved.
(See roff source for permission notice.)



Index

NAME
SYNOPSIS
DESCRIPTION
LOCAL MANAGEMENT INTERFACE
DEVICE CONTROL INTERFACE
PROTOCOL SERVICE INTERFACE
PROTOCOL MANAGEMENT INTERFACE
PROTOCOL SERVICE INTERFACE
Downstream Primitives
Upstream Primitives
PROTOCOL MANAGEMENT INTERFACE
Protocol Options
Protocol Configuration
Protocol State
Protocol Data Collection
Protocol Statistics
Protocol Events
SEE ALSO
BUGS
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 14:51:19 GMT, December 14, 2017
OpenSS7
SS7 for the
Common Man
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manpage of SLI
Last modified: Tue, 29 Apr 2008 07:10:31 GMT
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.