LIBRARY

       OSPP (libospp, -lospp)

SYNOPSIS

       #include <ospp.h>

DESCRIPTION

       To be written.

USAGE

       ospp_init(3)         initialize the OSPP library without opening a con-
                            nection to the OTAF

       ospp_bind(3)         create an OSPP session with the OTAF

       ospp_attach(3)       asynchronously request the OTAF to set up an OTASP
                            data call to the mobile station

       ospp_attach_s(3)     synchronously  request the OTAF to set up an OTASP
                            data call to the mobile station

       ospp_proceed(3)      asynchronously request the OTAF to release the TRN
                            at the MSC

       ospp_proceed_s(3)    synchronously  request the OTAF to release the TRN
                            at the MSC

       ospp_upload(3)       asynchronously request that  the  MS  upload  data
                            messages to the OTAF

       ospp_upload_s(3)     synchronously request that the MS upload data mes-
                            sages to the OTAF

       ospp_unlock(3)       asynchronously request that the  OTAF  unlock  the
                            mobile station for data downloading or uploading

       ospp_unlock_s(3)     synchronously  request  that  the  OTAF unlock the
                            mobile station for data downloading or uploading

       ospp_download(3)     asynchronously  request  that  the  OTAF  download
                            OTASP data messages to the mobile station

       ospp_download_s(3)   synchronously request that the OTAF download OTASP
                            data messages to the mobile station

       ospp_commit(3)       asynchronously commits previously downloaded  data
                            to the mobile station's permanent memory

       ospp_commit_s(3)     synchronously  commits  previously downloaded data
                            to the mobile station's permanent memory

       ospp_detach(3)       asynchronously  terminates  the  data   connection
                            sion.

       ospp_autoprl_s(3)    synchronously request  that  the  OTAF  create  an
                            OTASP  data  call  with the mobile station, upload
                            phone's MDN, select PRL from AutoPRL  Table  using
                            phone's MDN, optionally unlock the mobile station,
                            download the new PRL, and terminate the call  ses-
                            sion.

       ospp_result(3)       wait for the result from an asynchronous operation

       ospp_get_value       returns the OSPP data message from the result

       ospp_memfree(3)      frees memory allocated by OSPP calls

       ospp_msgfree(3)      frees memory used by OSPP result

       ospp_msgid(3)        returns the msgid of a message

       ospp_msgtype(3)      returns the msgtype of a message

       ospp_perror(3)       prints OSPP error message to stderr

       ospp_result2error(3) returns the  corresponding  error  to  the  result
                            returned from ospp_result(3)

CONFORMING TO

       This  API  implements  most  of version 1.4 of the Over-the-air Service
       Provisioning Protocol (OSPP) Protocol Specification published by Logica
       Mobile Networks.

NOTES

       CSC     Customer Service Center

       MDN     Mobile Directory Number

       MIN     Mobile Identification Number

       MS      Mobile Station (handset)

       MSC     Mobile Switching Center is a switch that bridges a mobile tele-
               phone network with another telephone network such as the  PSTN.

       OSPP    Over-the-air Service Provisioning Protocol

       OTAF    Over-The-Air  service  provisioning Function is the node in the
               network which allows entities to provision IS-95 handsets.

       OTASP   Over-The-Air Service Provisioning

       PSTN    Public Switched Telephone Network

       Over-The-Air Service Provisioning Protocol Specification,
       XDR: External Data Representation Standard (RFC 1832)



ospp 0.0.7-0.0.8                  March 2006                           OSPP(3)