📄 sdti.7
字号:
the configuration of the SDT provider awaiting a commit..TP.B SDT_IOCCCONFIGCommits the protocol configuration as provided in the \fBsdt_config\fRstructure to the Signalling Data Terminal. Also unlocks the configuration ofthe SDT provider..PP\fIic_dp\fR points to a \fBsdt_config\fR structure which represents theSignalling Data Terminal protocol configuration as follows:.PP.RS 4.nftypedef struct sdt_config { sdt_ulong t8; /* T8 timeout */ sdt_ulong Tin; /* AERM normal proving threshold */ sdt_ulong Tie; /* AERM emergency proving threshold */ sdt_ulong T; /* SUERM error threshold */ sdt_ulong D; /* SUERM error rate parameter */ sdt_ulong Te; /* EIM error threshold */ sdt_ulong De; /* EIM correct decrement */ sdt_ulong Ue; /* EIM error increment */} sdt_config_t;.fi.TP.I t8Contains the T8 timeout value (in jiffies) for the T8 timer used with theoptional Errored Interval Monitor (EIM) procedure of ITU-T Q.703 Annex A..TP.I TinContains the T4 timeout value (in jiffies) for the normal proving period..TP.I TieContains the T4 timeout value (in jiffies) for the emergency proving period..TP.I TContains the Signal Unit Error Rate Monitor (SUERM) threshold value..TP.I DContains the Signal Unit Error Rate Monitor (SUERM) downcount value..TP.I TeContains the threshold value for use with the Errored Interval Monitor (EIM)procedure of ITU-T Q.703 Annex A..TP.I DeContains the downcount value for use with the Errored Interval Monitor (EIM)procedure of ITU-T Q.703 Annex A..TP.I UeContains the upcount value for use with the Errored Interval Monitor (EIM)procedure of ITU-T Q.703 Annex A..RE.SS "Protocol State".PPProtocol management controls which affect protocol state are invoked by localmanagement to request information about the state of the protocol statemachines in the SDT provider..PPThe \fIic_cmd\fR contains one of the following state commands:.TP.B SDT_IOCGSTATEMGets the protocol state machine variables of the Signalling Data Terminal intothe provided \fBsdt_statem\fR structure..TP.B SDT_IOCCMRESETPerforms a master reset on the protocol state machines and returns thepower-on settings of the state machine variables of the Signalling DataTerminal into the provided \fBsdt_statem\fR structure..PP\fIic_dp\fR points to a \fBsdt_statem\fR structure which represents theSignalling Data Terminal protocol state as follows:.PP.RS 4.nftypedef struct sdt_statem { sdt_ulong aerm_state; /* AERM state variable */ sdt_ulong aborted_proving; /* AERM aborted proving */ sdt_long Ca; /* AERM error counter */ sdt_ulong Ti; /* AERM threshold */ sdt_ulong suerm_state; /* SUERM state variable */ sdt_long Cs; /* SUERM error counter */ sdt_ulong Ns; /* SUERM su counter */ sdt_ulong eim_state; /* EIM state variable */ sdt_long Ce; /* EIM counter */ sdt_ulong su_received; /* EIM su received flag */ sdt_ulong interval_error; /* EIM interval error flag */ sdt_ulong daedt_state; /* DAEDT state variable */ sdt_ulong daedr_state; /* DAEDR state variable */ sdt_ulong octet_counting_mode;/* receivers freewheeling */} sdt_statem_t;.fi.TP\fIaerm_state\fR, \fIaborted_proving\fR, \fICa\fR, \fITi\fRContains the Alignment Error Rate Monitor (AERM) current state\fIaerm_state\fR; a flag indicating whether proving has been aborted\fIaborted_proving\fR; the current AERM count \fICa\fR, and current AERMthreshold \fITi\fR..TP\fIsuerm_state\fR, \fICs\fR, \fINs\fRContains the Signal Unit Error Rate Monitor (SUERM) current state\fIsuerm_state\fR; the current SUERM count \fICs\fR, and the number of erroredperiods \fINs\fR..TP\fIeim_state\fR, \fICe\fR, \fIsu_received\fR, \fIinterval_error\fRContains the Errored Interval Monitor (EIM) current state \fIeim_state\fR; thecurrent EIM count \fICe\fR, a flag indicating whether a Signal Unit wasreceived in the current interval \fIsu_received\fR; and a flag indicatingwhether an error occured in the current interval \fIinterval_error\fR..TP\fIdaedt_state\fRContains the Delimitation Alignment and Error Detection Transmit (DAEDT)current state..TP\fIdeadr_state\fR, \fIoctet_counting_mode\fRContains the Delimitation Alignment and Error Detection Receiving (DAEDR)current state; and a flag indicating whether the DAEDR is in octet countingmode \fIoctet_counting_mode\fR..RE.SS "Protocol Data Collection".PPProtocol management controls which affect protocol measurement data collectionare invoked by local management to request and alter collection periods fordata collection within the SDT provider..PP\fIic_cmd\fR contains one of the following collection commands:.TP.B SDT_IOCGSTATSPGet the protocol measurement collection period information of the identified\fIobject_id\fR into the provided \fBlmi_sta\fR structure..TP.B SDT_IOCSSTATSPSet the protocol measurement collection period information of the identified\fIobject_id\fR using the provided \fBlmi_sta\fR structure..PP\fIic_dp\fR points to a \fBlmi_sta\fR structure which represnts the SignallingData Terminal collection periods as follows:.PP.RS 4.nftypedef struct lmi_sta { lmi_ulong object_id; /* object id for stats */ lmi_ulong colperiod; /* collection period */ lmi_ulong timestamp; /* timestamp end of period */} lmi_sta_t;.fi.TP.I object_idContains the object idenitfier for the managed object to which the collectioninformation applies..TP.I colperiodContains the collection period (in jiffies). The managed object measurementdata must be collected and notified once for each collection period interval..TP.I timestampContains a timestamp (in seconds since epoch) which identifies the system timeat which a collection period ends. This value is used in conjunction with thecollection period to calculate the time of the next collection interval..RE.SS "Protocol Statistics".PPProtocol management controls which affect protocol statistics are invoked bylocal management to request information about statistics pertaining to the SDTprovider..PP\fIic_cmd\fR contains one of the following statistics commands:.TP.B SDT_IOCGSTATSGet the protocol statistics of the Signalling Data Terminal for the currentcollection period into the provided \fBsdt_stats\fR structure..TP.B SDT_IOCCSTATSClear the protocol statisics of the Signalling Data Terminal for the currentcollection period and return the statistics which were accumulated to thepoint of clearing during the current interval \fBsdt_stats\fR structure..PP\fIic_dp\fR points to a \fBsdt_stats\fR structure which represents theSignalling Data Terminal protocol statistics as follows:.PP.RS 4.nftypedef struct sdt_stats { lmi_sta_t header; sdt_ulong tx_bytes; sdt_ulong tx_sus; sdt_ulong tx_underruns; sdt_ulong tx_aborts; sdt_ulong tx_buffer_overflows; sdt_ulong tx_sus_in_error; sdt_ulong rx_bytes; sdt_ulong rx_sus; sdt_ulong rx_overruns; sdt_ulong rx_aborts; sdt_ulong rx_buffer_overflows; sdt_ulong rx_sus_in_error; sdt_ulong rx_sync_transitions; sdt_ulong rx_bits_octet_counted; sdt_ulong rx_crc_errors; sdt_ulong rx_frame_errors; sdt_ulong rx_frame_overflows; sdt_ulong rx_frame_too_long; sdt_ulong rx_frame_too_short; sdt_ulong rx_residue_errors; sdt_ulong carrier_cts_lost; sdt_ulong carrier_dcd_lost; sdt_ulong carrier_lost;} sdt_stats_t;.fi.TP.I headerContains the timestamp for the current collection interval for whichstatistics are being reported..TP.IR tx_bytes ", " tx_sus ", " tx_underruns ", " tx_aborts ", " tx_buffer_overflows ", " tx_sus_in_errorContains transmitter statistics for the current collection interval..TP.IR rx_bytes ", " rx_sus ", " rx_overruns ", " rx_aborts ", " rx_buffer_overflows ", " rx_sus_in_error ", " rx_sync_transitions ", " rx_bits_octet_counted ", " rx_crc_errors ", " rx_frame_errors ", " rx_frame_overflow ", " rx_frame_too_long ", " rx_frame_too_short ", " rx_residue_errorsContains receiver statistics for the current collection interval..TP.IR carrier_cts_lost ", " carrier_dcd_lost ", " carrier_lostContains interface statistics for the current collection interval..RE.SS "Protocol Events".PPProtocol management controls which affect notification of events to localmanagement are invoked by local management to request information aboutnotifications which have been requested as well as to set notification byevent..PPThe \fIic_cmd\fR contians one of the following notify commands:.TP.B SDT_IOCGNOTIFYGets the protocol notification bitmask of the Signalling Data Terminal intothe provided \fBsdt_notify\fR structure..TP.B SDT_IOCSNOTIFYSets protocol notification for the Signalling Data Terminal events identifiedby set bits in the provided \fBsdt_notify\fR structure..TP.B SDT_IOCCNOTIFYClears protocol notification for the Signalling Data Terminal events identifiedby set bits in the provided \fBsdt_notify\fR structure..PP\fIic_dp\fR points to a \fBsdt_notify\fR structure which represents theSignalling Data Terminal protocol event notifications as follows:.PP.RS 4.nftypedef struct sdt_notify { sdt_ulong sdt_mask;} sdt_notify_t;.fi.TP.I sdt_maskContains a bit mask with bits set for each Signalling Data Terminal event forwhich notification has been requested. May also contain set bits for eventsfor which notification should be set (\fBSDT_IOCSNOTIFY\fR) or cleared(\fBSDT_IOCCNOTIFY\fR). The mask is the bitwise OR of any of the followingvalues:.RE.RS 4.IP.TStab(:);lb 2 l..THSDT_EVT_TX_FAIL:Transmitter failure.SDT_EVT_RX_FAIL:Receiver failure.SDT_EVT_CARRIER:Carrier failure..TE.RE.\" .SH "ERROR HANDLING".\" .SS "ERRORS".SH "SEE ALSO".PP.BR devi (7),.BR getmsg (2),.BR ioctl (2),.BR lmi (7),.BR mtpi (7),.BR putmsg (2),.BR read (2),.BR sdli (7),.BR sl (8),.BR sl (8),.BR sli (7),.BR slsi (7),.BR ss7d (8),.BR streamio (2),.BR write (2).SH "BUGS".PPToo many to mention..SH "AUTHOR".PPBrian F. G. Bidulock, <bidulock@openss7.org>.SH "HISTORY".PPThis STREAMS interface for SS7 is an original part of the \fIOpenSS7\fR package..SH "REFERENCES".PP.TStab(:);l 1 li..TH[Q702]:ITU-T Rec. Q.702 Signalling Data Link[Q703]:ITU-T Rec. Q.703 Signalling Link[Q704]:ITU-T Rec. Q.704 Message Transfer Part.TE.SH "COPYRIGHT NOTICE".PPCopyright \(co 1997-2001 Brian Bidulock. All Rights Reserved..sp.ce 1PERMISSION NOTICE.PPPermission is granted to make and distribute verbatim copies of this manualprovided the copyright notice and this permission notice are preserved on allcopies..PPPermission is granted to copy and distribute modified versions of this manualunder the conditions for verbatim copyring, provided that the entire resultingderived work is distributed under the terms of a permission notice identicalto this one..PPSince the Linux kernel and libraries are constantly changing, this manual pagemay be incorrect or out-of-date. The author(s) assume no responsibility forerrors or omissions, or for damage resulting from the use of the informationcontained herein. The author(s) may not have taken the same level of care inthe production of this manual, which is licensed free of charge, as they mightwhen working professionally..PPFormatted or processed versions of this manual, if unaccompanied by thesource, must acknowledge the copyright and authors of this work.
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -