sli.7

No7信令,我需要交换类似的代码, 请店长审核,谢谢了,急着交换,谢谢

'\" t
.\" -*- nroff -*-
.\"
.\" @(#) sli.7,v 0.7.8.1 2001/12/11 13:16:08 brian Exp
.\"
.\" =========================================================================
.\"
.\" This manpage is Copyright (C) 1997, 1998, 1999, 2000 Brian Bidulock.
.\"
.\" All Rights Reserved.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified 2001/12/11 13:16:08 by brian
.\"
.\" =========================================================================
.\"
.\" sli.7,v
.\" Revision 0.7.8.1  2001/12/11 13:16:08  brian
.\" Branched for new development.
.\"
.\" Revision 0.7.6.1  2001/02/18 12:11:14  brian
.\" New working branch for next release.
.\"
.\" Revision 0.7.4.1  2001/02/18 09:44:48  brian
.\" Added new working branch.
.\"
.\" Revision 0.7.2.5  2001/01/16 03:19:48  brian
.\" Updated man pages.
.\"
.\" Revision 0.7.2.4  2001/01/16 00:35:20  brian
.\" Reworked SLI man page.
.\"
.\" =========================================================================
.TH SLI 7 "2001/12/11 13:16:08" "OpenSS7 Man Page" "OpenSS7 Programmer's Manual"
.SH "NAME"
sli \- Signalling System No. 7 Signalling Link (SL) Interface
.SH "SYNOPSIS"
.nf
.B #include <ss7/sli.h>
.B #include <ss7/sli_ioctl.h>
.sp
\fIfd\fB = open ("\fI/dev/sl\fB", \fIflags\fB);
\fIret\fB = ioctl(\fIfd\fB, \fIcmd\fB, ... /* \fIarg\fB */ );
.fi
.SH "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 \fIOpenSS7\fR Signalling Link Interface (SLI) specification.
.SS "LOCAL MANAGEMENT INTERFACE"
.PP
SLI drivers are normally linked using \fBstreamio\fR(2) \fBI_LINK\fR ioctl
commands under a Signalling Link Set (SLS) STREAMS multiplexor conforming to
the Signalling Link Set Interface (SLSI) specification \fBslsi\fR(7) such as
\fBsls\fR(8), by the SS7 Configuration Daemon \fBss7d\fR(8).  Yet, this
interface is available for the purpose of ferry-clip conformance and
diagnostic testing of the SS7 Signalling Link.
.PP
SLI \fRStype 1\fR and \fIStyle 2\fR drivers may be configured to automatically
link under the \fBsls\fR(8) multiplexor and appear as \fBslsi\fR(7) drivers.
Not all SS7 drivers need be written to the SL or lower interfaces: drivers may
be written to the \fBslsi\fR(7) and even \fBmtpi\fR(7) interfaces.
.PP
SLI provides a local management interface which utilizes \fBM_PROTO\fR and
\fBM_PCPROTO\fR messages which can be exchanged with the interface using
\fBputmsg\fR(2) and \fBgetmsg\fR(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 \fBss7d\fR(8) on the driver interface before linking
under an \fBsls\fR(8) multiplexor.
.PP
The Local Management Interface (LMI) is common to all \fIOpenSS7\fR drivers
and modules and is described in detail in \fBlmi\fR(7).
.SS "DEVICE CONTROL INTERFACE"
.PP
SLI provides a device control interface which utilizes \fBioctl\fR(2)
transparent calls or an \fBI_STR\fR ioctl under \fBstreamio\fR(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 \fBss7d\fR(8) on the driver interface or multiplexor
control channel before or after the protocol stack has been assembled.
.PP
The device control interface (DEVI) is common to all \fIOpenSS7\fR drivers and
modules and is described in detail in \fBdevi\fR(7).
.SS "PROTOCOL SERVICE INTERFACE"
.PP
SLI provides a protocol service interface which uses \fBM_DATA\fR,
\fBM_PROTO\fR and \fBM_PCPROTO\fR STREAMS messages which can be exchanged with
\fBwrite\fR(2), \fBread\fR(2), \fBputmsg\fR(2) or \fBgetmsg\fR(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.
.PP
The protocol service interface for SLI is described in detail in section
\fIPROTOCOL SERVICE INTERFACE\fR, below.
.SS "PROTOCOL MANAGEMENT INTERFACE"
.PP
SLI provides a protocol mangement interface which uses \fBM_CTL\fR messages
between modules or \fBM_IOCTL\fR messages from a stream head or multiplexor
control channel.  This interface uses the controls defined in the Local
Management Interface (LMI) as detailed under
\fIINPUT OUTPUT CONTROL INTERFACE\fR in \fBlmi\fR(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 \fBss7d\fR(8) on the stream after opening or during
operation.
.PP
The protocol service interface for SLI is described in detail in section
\fIPROTOCOL MANAGEMENT INTERFACE\fR below.

.SH "PROTOCOL SERVICE INTERFACE"
.PP
Protocol service interface commands are from the stream head to the SL driver
using \fBputmsg\fR(2) and \fBgetmsg\fR(2) commands as follows:

.RS 4
.nf
\fIfd\fB = open("\fI/dev/sl\fB");
\fIret\fB = putmsg(\fIfd\fB, \fIctlptr\fB, \fIdataptr\fB, \fIflags\fB);
\fIret\fB = getmsg(\fIfd\fB, \fIctlptr\fB, \fIdataptr\fB, \fIflags\fB);
.fi
.RE
.PP
Downstream messages are sent from the stream head using \fBputmsg\fR(2);
upstream messages are received at the stream head using \fBgetmsg\fR(2).
.PP
\fIflags\fR is either \fBRS_HIPRI\fR or not indicating a \fBM_PCPROTO\fR
or an \fBM_PROTO\fR message respectively.  \fIctlptr\fR and \fIdataptr\fR are
pointers to a \fBstrbuf\fR structure which contains the following members:

.RS 4
.nf
struct strbuf {
    int     maxlen;
    int     len;
    void    *buf;
};
.fi
.RE
.PP
\fIbuf\fR contains a pointer to a \fBSL_primitive\fR union which contains one
of the following primitives and structures:
.SS Downstream Primitives
.PP
Downstream primitives are sent from the stream head to the protocol state
machines using \fBputmsg\fR(2) system calls as described above.
Except where otherwise noted, \fIbuf\fR contains only the \fBsl_primitive\fR
field which is set to the value of the primitive.

.TP
.B SL_PDU_REQ
Transmit a Protocol Data Unit (PDU).  This primitive must be sent with an
accompanying \fBM_DATA\fR block which is pointed to by the \fIdataptr\fR in a
\fBputmsg\fR(2) or is the buffer which is the argument of a \fBwrite\fR(2) on
the stream file descriptor.
.TP
.B SL_EMERGENCY_REQ
Set emergency alignment procedures on the signalling link.
.TP
.B SL_EMERGENCY_CEASES_REQ
Set normal alignment procedures on the signalling link.
.TP
.B SL_START_REQ
Start the signalling link.
.TP
.B SL_STOP_REQ
Stop the signalling link.
.TP
.B SL_RETRIEVE_BSNT_REQ
Retreive the BSNT value for buffer updating.
.TP
.B SL_RETREIVAL_REQUEST_AND_FSNC_REQ
Retreive the buffers from the TB/RTB up to and including FSNC.  This
primitive uses a \fBsl_retrieval_request_and_fsnc_t\fB structure which
includes the \fIsl_fsnc\fR value in addition to the \fIsl_primitive\fR as
follows:
.sp
.RS
.nf
typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_fsnc;
} sl_retreival_req_and_fsnc_t;
.fi
.TP 14
.I sl_primitive
Contains the primitive \fBSL_RETRIEVAL_REQ_AND_FSNC_REQ\fR.
.TP
.I 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.
.RE
.TP
.B SL_RESUME_REQ
Recover from local processor outage.
.TP
.B SL_CLEAR_BUFFERS_REQ
Clear signalling link buffers.
.TP
.B SL_LOCAL_PROCESSOR_OUTAGE_REQ
Institute local processor outage procedures.
.TP
.B SL_CONGESTION_DISCARD_REQ
Set congestion discard on the signalling link.
.TP
.B SL_CONGESTION_ACCEPT_REQ
Set congestion accept on the signalling link.
.TP
.B SL_NO_CONGESTION_REQ
Indicate cessation of congestion to the signalling link.
.TP
.B SL_POWER_ON_REQ
Power on the signalling link.

.PP
.SS Upstream Primitives
Upstream primitives are collected at the stream head from the protocol state
machines using \fBgetmsg\fR(2) system calls as described above.  Except where
otherwise noted, \fIbuf\fR contains only the \fBsl_primitive\fR field which
is set to the value of the primitive.

.TP
.B SL_PDU_IND
Receive a Protocol Data Unit (PDU).  This primitive is received with an
accompanying \fBM_DATA\fR block which is pointed to by the \fBdataptr\fR in a
\fBgetmsg\fR(2) or is the buffer which is returned from a \fBread\fR(2) on the
stream file descriptor.
.TP
.B SL_LINK_CONGESTED_IND
Indicates that the signalling link is congested.  This primitive indicates
addtional information in the \fBsl_link_cong_ind_t\fR structure as follows:
.sp
.RS
.nf
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;
.fi
.TP 14
.I sl_primitive
Contains the primitive \fBSL_LINK_CONGESTED_IND\fR.
.TP
.I sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose
of event reporting.
.TP
.I sl_cong_level
Contains the current congestion status for this link.
.TP
.I sl_disc_level
Contains the current discard status for this link.
.RE
.TP
.B SL_LINK_CONGESTION_CEASED_IND
Indicates that signalling link congestion has ceased.  This primitive
indicates additional information in the \fBsl_cong_ceased_ind_t\fR structure
as follows:
.sp
.RS
.nf
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;
.fi
.TP 14
.I sl_primitive
Contains the primitive \fBSL_LINK_CONGESTION_CEASED_IND\fR.
.TP
.I sl_timestamp
Contains the timestamp (system time) that this event occured for the purpose
of event reporting.
.TP
.I sl_cong_level
Contains the current congestion status for this link.
.TP
.I sl_disc_level
Contains the current discard status for this link.
.RE
.TP
.B SL_RETREIVED_MESSAGE_IND
Indicates one retreived message during buffer retreival.
.TP
.B SL_RETREIVAL_COMPLETE_IND
Indicates that buffer retrieval is complete and not to expect further
retrieved messages.
.TP
.B SL_RB_CLEARED_IND
Indicates that the Receive Buffer (RB) has been cleared.
.TP
.B SL_BSNT_IND
Indicates the value of BSNT which was requested by a \fBSL_RETRIEV_BSNT_REQ\fR.
This primitive indicates additional information in the \fBsl_bsnt_ind_t\fR
structure as follows:
.sp
.RS
.nf
typedef struct {
    sl_ulong    sl_primitive;
    sl_ulong    sl_bsnt;
} sl_bsnt_ind_t;
.fi
.TP 14
.I sl_primitive
Contains the primitive \fBSL_BSNT_IND\fR.
.TP
.I 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.
.RE
.TP
.B SL_IN_SERVICE_IND
Indicates that the signalling link is in service and ready to accept traffic.
.TP
.B SL_OUT_OF_SERVICE_IND
Indicates that the signalling link is out of service and can no longer accept
traffic.  This primitive indicates additional information in the
\fBsl_out_of_service_t\fR structure as follows:
.sp
.RS
.nf
typedef struct {