Get Started

From reSIProcate
Jump to: navigation, search

How to Get Started[edit]

#1 - Get a copy of the code[edit]

Either grab a tarball of the latest release from the ReSIProcate Releases page or use Git to grab the latest working code (DeveloperQuickstart).

#2 - Select Project/API to Start Working With[edit]

reSIProcate stack[edit]

  • Overview: Core SIP stack. Handles SIP transactions, manages transports. Does not work with SIP messaging at the Dialog layer. Most users will not start by exclusively using this layer, instead start with either the DUM, repro, or recon layers.
  • Location in source tree: resip/stack
  • Documentation:
    • There is information on this wiki - Resip Overview.
    • Some crude design diagrams and documentation can be found in main/resip/stack/doc
    • There is Doxygen generated documentation for the stack and the underlying rutil library.
  • Samples: The unit test programs provide good sample uses of the classes, they can be found at main/resip/stack/test and main/rutil/test. In particular, check out testStack.cxx.

The Dialog Usage Manager (DUM)[edit]

  • Overview: Sits above the core SIP stack and deals with SIP Dialog creation and handling. Can be used to setup Registrations, Calls/InviteSessions, Subscriptions, Publications, etc. For Invite Sessions, hands received SDP bodies to the application for handling. Does not have any logic for forming an SDP answer from an offer, or any media handling capability. Most applications start with this layer, as it offers the high degree of flexibility and extensibility for building SIP based applications.
  • Location in source tree: resip/dum
  • Documentation:
    • There is information on this wiki - DUM Overview.
    • Some crude design diagrams and documentation can be found in main/resip/dum/doc
    • There is Doxygen generated documentation for DUM.
  • Samples: The unit test programs provide good sample uses, they can be found at main/resip/dum/test. In particular, check out the files pre-fixed as basicClient.

Conversation Manager (recon)[edit]

  • Overview: Sits above the core SIP stack and DUM layers and deals with media, Offer/Answer and the required SIP messaging. Uses the sipXtapi media stack to provide audio RTP handling.
  • Location in source tree: resip/recon
  • Documentation:
  • Samples: The unit test programs provide good sample uses, they can be found at main/resip/recon/test. In particular, check out testUA.cxx.

repro SIP Proxy[edit]

  • Overview: Sits above the core SIP stack, uses DUM for registration handling and the core stack to proxy SIP messaging.
  • Location in source tree: main/repro
  • Documentation: