nua 1.12.11devel
Loading...
Searching...
No Matches
NUA API Overview

This page gives a short overview of the NUA API: different functions, events, tags, and where and how they affect the workings of the NUA engine.

The application and the NUA engine can pass various parameters between them using tagged arguments. Tagged arguments can be used like named arguments in higher-lever languages.

NUA Agent

The NUA agent object is created with nua_create(). The nua_create() also creates the transports and binds the transport sockets used by the SIP stack.

The special tags controlling the transports are

See nta_agent_add_tport() for discussion about magic URIs used to initialize transports.

The agent-wide parameter can be later modified or obtained with nua_set_params() and nua_get_params(), respectively.

The su_root_t mainloop integration uses:

NUA Handles

Settings:

There are a few "sticky" headers that are used on subsequent requests if included with any handle-specific call:

Client Generating SIP Requests
Client Authenticating Requests
Server Processing Received SIP Requests
Registrations and Contact Header Generation

Settings:

Specifications:

INVITE Sessions and Call Model

Specifications:

In-Session Information requests

Settings:

SDP Processing

Settings:

Specifications:

Call Model Extensions ("100rel" and "precondition")

Early media:

Settings:

Specifications:

SIP Session Timers ("timer")

Periodic refresh of SIP Session initiated with INVITE with re-INVITE or UPDATE requests.

Settings:

Specifications:

Caller Preferences and Callee Caps
  • Caller preferences in an Accept-Contact header in a INVITE requests
  • Callee caps contained in a Contact header in a REGISTER request

Settings:

Specifications:

Instant Messaging

Settings:

Specifications:

Call Transfer

Settings:

Specifications:

Internal SIP Event Server
Settings

Specifications:

SIP Event Subscriber

Specifications:

SIP Event Notifier

Settings:

Specifications

SIP Event Publisher

Specifications:

SIP Event State Compositor (PUBLISH Server)

Settings:

Specifications:

Non-Standard Extension Methods

Settings:

Server Shutdown

Sofia-SIP 1.12.11devel - Copyright (C) 2006 Nokia Corporation. All rights reserved. Licensed under the terms of the GNU Lesser General Public License.