1. Scope

The library provides set of functions for call waiting, divert and barring 
control on Nokia modems. The library builds on top of libisi, therefore
in order to build the package the libisi-dev package must be installed first.
The libss is a development library itself. Users of the library can easily
build own applications using library functions.

2. Documentation

Doxygen style documentation is used througout the code for the API 
documentation.

Contacts: 
- Andras.Domokos@nokia.com (main author)
- Pekka.Pessi@nokia.com (USSD)
- ext-Olli.Kettunen@nokia.com (Renesas, ss server on modem side)

3. Building the debian package

Execute the following command from the top directory where the sources are 
stored:

dpkg-buildpackage -rfakeroot

The debian package can be built for the x86 environment, or the phone target
in the scratchbox environment.

4. Use case for the library

The sserv command line tool in the tools directory can serv as an example for
how to implement applications usning libss library. 
The sserv command line tool can be used for making changes or querying the 
call waiting, divert and barring configurations.
Note that the application can be compiled for both, phone ARM target and 
desktop (x86) environment (for use with USB phonet link) with no changes.

In order to compile your application that uses libss, first the package 
containing the ISI header files (e.g.:cellmo-rnd-headers), libisi-dev and 
libss-dev packages need to be installed. In the next lines an example shell 
script is given showing how to get the compiler and linker flags in order to 
build an user application using the libss library.

-------------------------------------------------------------------------------
#!/bin/sh
#
# make.sh file for manually compiling sserv.c
#

IPKG_ISIHDR=`pkg-config --cflags isihdr`
IPKG_ISI=`pkg-config --cflags isi`
LPKG_ISI=`pkg-config --libs isi`
IPKG_SS=`pkg-config --cflags ss`
LPKG_SS=`pkg-config --libs ss`
IPKG_GLIB=`pkg-config --cflags glib-2.0`
LPKG_GLIB=`pkg-config --libs glib-2.0`
CFLAGS="$IPKG_SS $IPKG_ISIHDR $IPKG_ISI  $IPKG_GLIB -g3 -O0 -c"
LDFLAGS="$LPKG_SS $LPKG_ISI $LPKG_GLIB"

gcc $CFLAGS sserv.c -o sserv.o
gcc sserv.o -o sserv $LDFLAGS 

-------------------------------------------------------------------------------
