Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SIP_ADD_BRANCHID_TO_VIA(3SIP)			 SIP_ADD_BRANCHID_TO_VIA(3SIP)

NAME
       sip_add_branchid_to_via	-  add	a  branch parameter to the topmost VIA
       header in the SIP message

SYNOPSIS
       cc [ flag ... ] file ... -lsip [ library ... ]
       #include <sip.h>

       int sip_add_branchid_to_via(sip_msg_t sip_msg, char *branchid);

DESCRIPTION
       The sip_add_branchid_to_via() function adds a branch param to the  top‐
       most  VIA  header in the SIP message sip_msg. Note that a new header is
       created as a result of adding the branch parameter and the  old	header
       is  marked  deleted.  Applications with multiple threads working on the
       same VIA header need to take note of this.

RETURN VALUES
       These functions return 0 on success and the appropriate error value  on
       failure.

ERRORS
       On  failure, functions that return an error value may return one of the
       following:

       EINVAL
		 Mandatory parameters are not provided or are NULL.

		 For sip_add_branchid_to_via(), the topmost VIA header already
		 has  a	 branch	 param	or the SIP message does not have a VIA
		 header.

       EPERM
		 The message cannot be modified.

       ENOMEM
		 There is  an  error  allocating  memory  for  creating	 head‐
		 ers/parameters.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Committed	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ MT-Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       libsip(3LIB)

				 Jan 25, 2007	 SIP_ADD_BRANCHID_TO_VIA(3SIP)

Vote for polarhome