aboutsummaryrefslogtreecommitdiffstats
path: root/sualibrary/docs/en/index-3.html
diff options
context:
space:
mode:
Diffstat (limited to 'sualibrary/docs/en/index-3.html')
-rw-r--r--sualibrary/docs/en/index-3.html138
1 files changed, 138 insertions, 0 deletions
diff --git a/sualibrary/docs/en/index-3.html b/sualibrary/docs/en/index-3.html
new file mode 100644
index 0000000..17dc4f7
--- /dev/null
+++ b/sualibrary/docs/en/index-3.html
@@ -0,0 +1,138 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<HTML>
+<HEAD>
+ <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
+ <TITLE>The Sualibrary Handbook: Usage </TITLE>
+ <LINK HREF="index-4.html" REL=next>
+ <LINK HREF="index-2.html" REL=previous>
+ <LINK HREF="index.html#toc3" REL=contents>
+</HEAD>
+<BODY>
+<A HREF="index-4.html">Next</A>
+<A HREF="index-2.html">Previous</A>
+<A HREF="index.html#toc3">Contents</A>
+<HR>
+<H2><A NAME="s3">3. Usage </A></H2>
+
+<P>
+<H2><A NAME="ss3.1">3.1 General usage of the SUA library</A>
+</H2>
+
+<P>
+
+If you compile the entire project, and install the files sua.h in the directory /usr/local/includeand libsua.ain /usr/local/lib(by simply copying these from the libsua/sua/ subdirectory to their repective destinations: this is done automatically by the the make during installation), it is trivial to compile an application.
+
+Let’s assume, your application is named app and consists of the file app.c. If you use gccas compiler,
+
+it is sufficient to issue the command
+
+host:˜> gcc -o app app.c -lsctp –lglib -lsua
+
+
+
+in order to compile your application. Note though, that FreeBSD calls the glib-library by default
+
+libglib12, since it exists both in several versions (i.e. glib version 1.0 would be called libglib10
+
+under FreeBSD (and possibly other BSD unixes). So under this platform, you would use
+
+BSDhost:˜> gcc -o app app.c -lsctp -lglib12 –lsua
+
+
+
+Some features are selectable, see sua_debug.h for a overview of the switches.
+
+Switches include the displaying debug msg on the screen,
+
+Dumping SUA msg and debug info into a file, optional use of SUA ASP management, etc…
+
+<P>
+<P>
+<P>
+<H2><A NAME="ss3.2">3.2 Features of the implementation</A>
+</H2>
+<P>
+<P>
+The implementation is able to do the following:
+<P>
+Statically and dynamically setup of SCTP association for the transport of the SUA messages
+<P>
+Connectionless : CLDT message transfer
+<P>
+Connectionoriented: CORE, COAK, RELRE, RELCO, COREF & CODT message transfer
+<P>
+Adressing options: use of Ipv4 and Ipv6 addresses, SS7 pointcodes, hostname
+<P>
+SUA ASP management(optional)
+<P><P>
+It has been tested with implementations of 4 companies in the first SUA bakeoff.
+<P><P>
+The following flags are recognized when reading a configuration file for SUA:
+<P>
+-s : source address<P>
+
+-l: source portnumber (optional, default is set at 14001)<P>
+
+-d : destination address(optional)<P>
+
+-r : destination portnumber(optional, default is set at 14001)<P>
+
+-n : subsystem number to be used<P>
+
+-a : Application server number(optional)<P>
+
+-t : number of streams in & out(optional, default is set at 1)<P>
+
+-7d : SS7 destination pointcode(optional)<P>
+
+-7s : SS7 source pointcode(optional)<P>
+
+-sn: Source hostname<P>
+
+-dn: Destination hostname<P>
+
+<P>
+
+example of a association<P>
+
+-s 10.0.1.1 -7s 1 -d 10.0.3.1 -7d 66051 -r 14001 -n 255 -a 1 -t 16<P>
+
+example of a local listener<P>
+
+-s be.atea.sua01 –n 255 –a 1 –t 2 <P>
+
+
+<P>
+<P>
+<P>
+<H2><A NAME="ss3.3">3.3 What is missing.</A>
+</H2>
+<P>
+<P>
+
+Features to be included in future version:
+<P>
+- Relaying functionality<P>
+
+- SUA management: ASP , AS management, etc<P>
+<P>
+Features not to be included:
+<P>
+- NIF/interworking with classical SS7 SCCP<P>
+
+- Routing keys<P>
+
+- Registration of Applications<P>
+<P>
+Probably there is some more. Additions, comments, bug-reports and bug-fixes as welll as patches,
+
+patches, and patches are always welcome !
+<P>
+<P>
+<P>
+<HR>
+<A HREF="index-4.html">Next</A>
+<A HREF="index-2.html">Previous</A>
+<A HREF="index.html#toc3">Contents</A>
+</BODY>
+</HTML>