sdp: sdp_print.c File Reference

#include "config.h"
#include <sofia-sip/su_alloc.h>
#include "sofia-sip/sdp.h"
#include <stddef.h>
#include <stdlib.h>
#include <string.h>
#include <stdarg.h>
#include <stdio.h>
#include <assert.h>

Function Documentation

char const* sdp_message ( sdp_printer_t * p )

Get encoded SDP message.

Return a pointer to a C string containing the SDP message.

Parameters:

Pointer to an sdp_printer_t object.

Returns:: Return a pointer to a C string containing the encoded SDP message, or NULL upon an error.

isize_t sdp_message_size ( sdp_printer_t * p )

Get size of encoded SDP message.

Return the size of the encoded SDP message.

Parameters:

Pointer to an sdp_printer_t object.

Returns:: Number of bytes in SDP message excluding final NUL or 0 upon an error.

sdp_printer_t* sdp_print	(	su_home_t *	home,
		sdp_session_t const *	session,
		char	msgbuf[],
		isize_t	msgsize,
		int	flags
	)

Print a SDP description.

Encode the contents of the SDP session structure sdp_session_t to the msgbuf. The msgbuf has size msgsize bytes. If msgbuf is NULL, the sdp_print() function allocates the required buffer from the home heap.

Parameters:

	home	Memory home (may be NULL).
	session	SDP session description structure to be encoded.
	msgbuf	Buffer to which encoding is stored (may be NULL).
	msgsize	Size of msgbuf.
	flags	Flags specifying the encoding options.

The flags specify encoding options as follows:

sdp_f_strict - Printer should only emit messages conforming strictly to the * specification.

sdp_f_realloc - If this flag is specified, and msgbuf is too small for the resulting SDP message, sdp_print() may allocate a new buffer for it from the heap.

sdp_f_print_prefix - The buffer provided by caller already contains valid data. The result will concatenated to the string in the buffer.

sdp_f_mode_always - Always add mode attributes to media

sdp_f_mode_manual - Do not generate mode attributes

Returns:: Always return a handle to an sdp_printer_t object.

See also:: sdp_printer_t, sdp_session_t, sdp_printing_error(), sdp_message(), sdp_message_size(), sdp_printer_free(), sdp_parse().

void sdp_printer_free ( sdp_printer_t * p )

Free a SDP printer.

Free the printer object p and the message buffer possibly associated with it.

Parameters:

Pointer to an sdp_printer_t object.

char const* sdp_printing_error ( sdp_printer_t * p )

Get encoding error.

Return a message describing the encoding error.

Parameters:

Pointer to an sdp_printer_t object.

Returns:: Return a pointer to C string describing printing errors, or NULL if no error was encountered.

sdp_print.c File Reference

Detailed Description

Functions

Function Documentation


Functions
sdp_printer_t *	sdp_print (su_home_t home, sdp_session_t const session, char msgbuf[], isize_t msgsize, int flags)
	Print a SDP description.
char const *	sdp_printing_error (sdp_printer_t *p)
	Get encoding error.
char const *	sdp_message (sdp_printer_t *p)
	Get encoded SDP message.
isize_t	sdp_message_size (sdp_printer_t *p)
	Get size of encoded SDP message.
void	sdp_printer_free (sdp_printer_t *p)
	Free a SDP printer.