sdli.7

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

'\" t
.\" -*- nroff -*-
.\"
.\" @(#) sdli.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
.\"
.\" =========================================================================
.\"
.\" sdli.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.7  2001/01/16 03:19:47  brian
.\" Updated man pages.
.\"
.\" Revision 0.7.2.6  2001/01/16 02:35:28  brian
.\" Updated SDLI man page.
.\"
.\" Revision 0.7.2.5  2001/01/15 10:14:30  brian
.\" Worked up LMI and SDLI man pages.
.\"
.\" =========================================================================
.TH SDLI 7 "2001/12/11 13:16:08" "OpenSS7 Man Page" "OpenSS7 Programmer's Manual"
.SH "NAME"
sdli \- Signalling System No. 7 Signalling Data Link (SDL) Interface
.SH "SYNOPSIS"
.nf
.B #include <ss7/sdli.h>
.B #include <ss7/sdli_ioctl.h>
.sp
\fIfd\fB = open ("\fI/dev/sdl\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 Data Link Interface (SDLI) for all
SS7 devices conforming to the \fIOpenSS7\fR Signalling Data Link Interface
(SDLI) specification.
.SS "LOCAL MANAGEMENT INTERFACE"
.PP
SDLI drivers are normally linked using \fBstreamio\fR(2) \fBI_PUSH\fR ioctl
commands under a Signalling Data Terminal (SDT) STREAMS module conforming to the
Signalling Data Terminal Interface (SDTI) specification \fBsdti\fR(7) such as
\fBsl\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 Data Link.
.PP
SDLI \fRStype 1\fR and \fIStyle 2\fR drviers may be configured to autopush the
\fBsl\fR(8) module and appear as \fBsdli\fR(7) drivers.  Not all SS7 drivers
need be written to the SDT interface: drivers may be written to the
\fBsdti\fR(7), \fBsli\fR(7) \fBslsi\fR(7) and even \fBmtpi\fR(7) interfaces.
.PP
SDLI 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 pushing an
\fBsl\fR(8) module onto the stream head.
.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
SDLI 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 to the driver.  The device control interface controls aspects of
the SDL 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
SDLI 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 Data Terminal (SDT) and the
Signalling Data Link (SDL), but may also be used for ferry-clip
conformance testing or diagnostics.
.PP
The protocol service interface for SDLI is described in detail in section
\fIPROTOCOL SERVICE INTERFACE\fR, below.
.SS "PROTOCOL MANAGEMENT INTERFACE"
.PP
SDLI provides a protocol mangement interface which uses \fBM_CTL\fR messages
between modules or \fBM_IOCTL\fR messages from a stream head.  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 SDLI 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 SDL driver
using \fBputmsg\fR(2) and \fBgetmsg\fR(2) commands as follows:

.RS 4
.nf
\fIfd\fB = open("\fI/dev/sdl\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;     /* not used       */
    int     len;        /* length of data */
    void    *buf;       /* ptr to buffer  */
};
.fi
.RE
.PP
\fIbuf\fR contains a pointer to a \fBSDL_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 \fBsdl_primitive\fR
field which is set to the value of the primitive.
.TP
.B SDL_DAEDT_TRANSMISSION_REQ
Transmit data.  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 SDL_DAEDT_START_REQ
Start the DAEDT state machine.
.TP
.B SDL_DAEDR_START_REQ
Start the DAEDR state machine.
.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 \fBsdl_primitive\fR field which
is set to the value of the primitive.
.TP
.B SDL_DAEDR_RECEIVED_BITS_IND
Receive data.  This primitive is received with an accompanying \fBM_DATA\fR
block which is pointed to by the \fIdataptr\fR in a \fBgetmsg\fR(2) or is the
buffer which is returned from a \fBread\fR(2) on the stream file descriptor.
This primitive indicates additional information in the
\fBsdl_daedr_received_bits_ind_t\fR structure as follows:
.sp
.RS
.nf
typedef struct {
    sdl_ulong   sdl_primitive;  /* SDL_DAEDR_RECEIVED_BITS_IND */
    sdl_ulong   sdl_count;
} sdl_daedr_received_bits_ind_t;
.fi
.TP
.I sdl_primitive
Contains the primitive which is set to \fBSDL_DAEDR_RECEIVED_BITS_IND\fR.
.TP
.I sdl_count
Contains the count of the number of consecutive times that this signal unit
was received since the last indication.
.RE
.TP
.B SDL_DAEDR_CORRECT_SU_IND
Correct Signal Unit received indication. This primitive indicates additional
information in the \fBsdl_daedr_correct_su_ind_t\fR structure as follows:
.sp
.RS
.nf
typedef struct {
    sdl_ulong   sdl_primitive;  /* SDL_DAEDR_CORRECT_SU_IND */
    sdl_ulong   sdl_count;
} sdl_daedr_correct_su_ind_t;
.fi
.TP
.I sdl_primitive
Contains the primitive which is set to \fBSDL_DAEDR_CORRECT_SU_IND\fR.
.TP
.I sdl_count
Contains the count of the number of correct signal units received since the
last indication.
.RE
.TP
.B SDL_DAEDR_SU_IN_ERROR_IND
Signal Unit received in error indication.

.SH "PROTOCOL MANAGEMENT INTERFACE"
.PP
Protocol management interface comands are from the stream head to the SDL
driver using \fBstreamio\fR(8) \fBI_STR\fR commands as follows:

.RS 4
.nf
\fIfd\fB = open("\fI/dev/sdl\fB");
\fIret\fB = ioctl(\fIfd\fB, \fRI_STR\fB, \fIarg\fB);
.fi
.RE
.PP
Where \fIarg\fR is a pointer to a \fBstrioctl\fR structure which contains the
following members:
.sp
.RS 4
.nf
struct strioctl {
    int     ic_cmd;
    int     ic_timout;
    int     ic_len;
    char    *ic_dp;
};
.fi
.RE
.PP
\fIic_cmd\fR can be one of the protocol management interface
commands described in the following subsections:

.SS "Protocol Options"
.PP
Protocol management controls which affect protocol options are used by local
management to set protocol variants and protocol options inherent to the SDL
provider.
.PP
The \fIic_cmd\fR contains one of the following options commands:
.TP
.B SDL_IOCGOPTIONS
Gets the protocol variant \fIpvar\fR and protocol options \fIpopt\fR
assigned to the Signalling Data Link into the provided \fBlmi_option\fR
structure.
.TP
.B SDL_IOCSOPTIONS
Sets the protocol variant \fIpvar\fR and protocol options \fIpopt\fR to the
Signalling Data Link as provided in the \fBlmi_option\fR structure.
.PP
\fIic_dp\fR points to a \fBlmi_option\fR structure which
represents the protocol variant and options parameters as follows:
.PP
.RS 4
.nf
typedef struct lmi_option {
    lmi_ulong   pvar;
    lmi_ulong   popt;
} lmi_option_t;
.fi
.TP
.I pvar
Specifies the protocol variant to be used for the Signalling Data Link and
may be one of the following values:
.RE
.RS 4
.IP
.TS
tab(:);
lbw(16) 2 l.
.TH
SS7_PVAR_ITUT_88:ITU-T Q.703 1988 (Blue Book)
SS7_PVAR_ITUT_93:ITU-T Q.703 1993 (Grey Book)
SS7_PVAR_ITUT_96:ITU-T Q.703 1996 (White Book)
SS7_PVAR_ITUT_00:ITU-T Q.703 2000 (? Book)
SS7_PVAR_ANSI_88:ANSI T1.113-1988
SS7_PVAR_ANSI_92:ANSI T1.113-1992
SS7_PVAR_ANSI_96:ANSI T1.113-1996
SS7_PVAR_ANSI_00:ANSI T1.113-2000
SS7_PVAR_ETSI_88:ETSI 300 008-1 1988
SS7_PVAR_ETSI_93:ETSI 300 008-1 1993
SS7_PVAR_ETSI_96:ETSI 300 008-1 1996
SS7_PVAR_ETSI_00:ETSI 300 008-1 2000
SS7_PVAR_JTTC_94:JTTC JQ.703 1994
.TE
.RE
.RS 4
.TP
.I popt
Specifies the protocol options to be used for the Signalling Data Link and
may be a bitwise OR of any of the following values:
.RE
.RS 4
.IP
.TS
tab(:);