new imported library in libmpdemux: freesdp (will be used by native rtsp demuxer)

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@18827 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
ben 2006-06-26 17:37:55 +00:00
parent b31df04b82
commit 155f9d742f
8 changed files with 3734 additions and 1 deletions

View File

@ -141,6 +141,10 @@ SRCS += realrtsp/asmrp.c \
SRCS += librtsp/rtsp.c \
librtsp/rtsp_session.c \
SRCS += freesdp/common.c \
freesdp/errorlist.c \
freesdp/parser.c \
ifeq ($(STREAMING_LIVE555),yes)
CPLUSPLUSSRCS = demux_rtp.cpp demux_rtp_codec.cpp
CPLUSPLUSINCLUDE = $(LIVE_INCLUDES)
@ -188,7 +192,8 @@ test: $(LIBNAME) test.c
clean:
rm -f *.o *.a *~ \
realrtsp/*.o realrtsp/*.a realrtsp/*~ \
librtsp/*.o librtsp/*.a librtsp/*~
librtsp/*.o librtsp/*.a librtsp/*~ \
freesdp/*.o freesdp/*.a freesdp/*~
distclean: clean
rm -f .depend test

226
libmpdemux/freesdp/common.c Normal file
View File

@ -0,0 +1,226 @@
/*
This file is part of FreeSDP
Copyright (C) 2001,2002,2003 Federico Montesino Pouzols <fedemp@suidzer0.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* @file common.c
*
* @short Implementation of routines common to parse and formatting
* modules .
*
* This file implements the routines that operate over data structures
* that are used in both the parse and formatting modules.
**/
#include "priv.h"
#include "common.h"
static void
safe_free (void *ptr)
{
if (ptr)
free (ptr);
}
fsdp_description_t *
fsdp_description_new (void)
{
fsdp_description_t *result = malloc (sizeof (fsdp_description_t));
result->version = 0;
result->o_username = result->o_session_id =
result->o_announcement_version = NULL;
result->o_network_type = FSDP_NETWORK_TYPE_UNDEFINED;
result->o_address_type = FSDP_ADDRESS_TYPE_UNDEFINED;
result->o_address = NULL;
result->s_name = NULL;
result->i_information = NULL;
result->u_uri = NULL;
result->emails = NULL;
result->emails_count = 0;
result->phones = NULL;
result->phones_count = 0;
/* At first, there is no session-level definition for these
parameters */
result->c_network_type = FSDP_NETWORK_TYPE_UNDEFINED;
result->c_address_type = FSDP_ADDRESS_TYPE_UNDEFINED;
result->c_address.address = NULL;
/* there is no session-level definition for these parameters */
result->bw_modifiers = NULL;
result->bw_modifiers_count = 0;
result->time_periods = NULL;
result->time_periods_count = 0;
result->timezone_adj = NULL;
result->k_encryption_method = FSDP_ENCRYPTION_METHOD_UNDEFINED;
result->k_encryption_content = NULL;
/* Default/undefined values for attributes */
result->a_category = result->a_keywords = result->a_tool = NULL;
result->a_type = FSDP_SESSION_TYPE_UNDEFINED;
result->a_sendrecv_mode = FSDP_SENDRECV_UNDEFINED;
result->a_charset = NULL;
result->a_sdplangs = result->a_langs = NULL;
result->a_controls = NULL;
result->a_range = NULL;
result->a_rtpmaps = NULL;
result->a_rtpmaps_count = 0;
result->a_sdplangs_count = 0;
result->a_langs_count = 0;
result->a_controls_count = 0;
result->unidentified_attributes = NULL;
result->unidentified_attributes_count = 0;
result->media_announcements = NULL;
result->media_announcements_count = 0;
return result;
}
void
fsdp_description_delete (fsdp_description_t * dsc)
{
fsdp_description_recycle (dsc);
safe_free (dsc);
}
void
fsdp_description_recycle (fsdp_description_t * dsc)
{
/* Recursively free all strings and arrays */
unsigned int i, j;
if (!dsc)
return;
safe_free (dsc->o_username);
safe_free (dsc->o_session_id);
safe_free (dsc->o_announcement_version);
safe_free (dsc->o_address);
safe_free (dsc->s_name);
safe_free (dsc->i_information);
safe_free (dsc->u_uri);
for (i = 0; i < dsc->emails_count; i++)
safe_free ((char *) dsc->emails[i]);
safe_free (dsc->emails);
for (i = 0; i < dsc->phones_count; i++)
safe_free ((char *) dsc->phones[i]);
safe_free (dsc->phones);
safe_free (dsc->c_address.address);
for (i = 0; i < dsc->bw_modifiers_count; i++)
safe_free (dsc->bw_modifiers[i].b_unknown_bw_modt);
safe_free (dsc->bw_modifiers);
for (i = 0; i < dsc->time_periods_count; i++)
{
for (j = 0; j < dsc->time_periods[i]->repeats_count; j++)
{
safe_free (dsc->time_periods[i]->repeats[j]->offsets);
safe_free (dsc->time_periods[i]->repeats[j]);
}
safe_free (dsc->time_periods[i]->repeats);
safe_free (dsc->time_periods[i]);
}
safe_free (dsc->time_periods);
safe_free (dsc->timezone_adj);
safe_free (dsc->a_category);
safe_free (dsc->a_keywords);
safe_free (dsc->a_tool);
for (i = 0; i < dsc->a_rtpmaps_count; i++)
safe_free (dsc->a_rtpmaps[i]);
safe_free (dsc->a_rtpmaps);
safe_free (dsc->a_charset);
for (i = 0; i < dsc->a_sdplangs_count; i++)
safe_free (dsc->a_sdplangs[i]);
safe_free (dsc->a_sdplangs);
for (i = 0; i < dsc->a_langs_count; i++)
safe_free (dsc->a_langs[i]);
safe_free (dsc->a_langs);
for (i = 0; i < dsc->a_controls_count; i++)
safe_free (dsc->a_controls[i]);
safe_free (dsc->a_controls);
safe_free (dsc->a_range);
for (i = 0; i < dsc->media_announcements_count; i++)
{
for (j = 0; j < dsc->media_announcements[i]->formats_count; j++)
safe_free (dsc->media_announcements[i]->formats[j]);
safe_free (dsc->media_announcements[i]->formats);
safe_free (dsc->media_announcements[i]->i_title);
for (j = 0; j < dsc->media_announcements[i]->bw_modifiers_count; j++)
{
if (FSDP_BW_MOD_TYPE_UNKNOWN ==
dsc->media_announcements[i]->bw_modifiers[j].b_mod_type)
safe_free (dsc->media_announcements[i]->bw_modifiers[j].
b_unknown_bw_modt);
}
safe_free (dsc->media_announcements[i]->bw_modifiers);
safe_free (dsc->media_announcements[i]->k_encryption_content);
for (j = 0; j < dsc->media_announcements[i]->a_rtpmaps_count; j++)
{
safe_free (dsc->media_announcements[i]->a_rtpmaps[j]->pt);
safe_free (dsc->media_announcements[i]->a_rtpmaps[j]->
encoding_name);
safe_free (dsc->media_announcements[i]->a_rtpmaps[j]->parameters);
safe_free (dsc->media_announcements[i]->a_rtpmaps[j]);
}
safe_free (dsc->media_announcements[i]->a_rtpmaps);
for (j = 0; j < dsc->media_announcements[i]->a_sdplangs_count; j++)
safe_free (dsc->media_announcements[i]->a_sdplangs[j]);
safe_free (dsc->media_announcements[i]->a_sdplangs);
for (j = 0; j < dsc->media_announcements[i]->a_langs_count; j++)
safe_free (dsc->media_announcements[i]->a_langs[j]);
safe_free (dsc->media_announcements[i]->a_langs);
for (j = 0; j < dsc->media_announcements[i]->a_controls_count; j++)
safe_free (dsc->media_announcements[i]->a_controls[j]);
safe_free (dsc->media_announcements[i]->a_controls);
for (j = 0; j < dsc->media_announcements[i]->a_fmtps_count; j++)
safe_free (dsc->media_announcements[i]->a_fmtps[j]);
safe_free (dsc->media_announcements[i]->a_fmtps);
for (j = 0;
j < dsc->media_announcements[i]->unidentified_attributes_count; j++)
safe_free (dsc->media_announcements[i]->unidentified_attributes[j]);
safe_free (dsc->media_announcements[i]->unidentified_attributes);
safe_free (dsc->media_announcements[i]);
}
safe_free (dsc->media_announcements);
/* This prevents the user to make the library crash when incorrectly
using recycled but not rebuilt descriptions */
dsc->emails_count = 0;
dsc->phones_count = 0;
dsc->bw_modifiers_count = 0;
dsc->time_periods_count = 0;
dsc->media_announcements_count = 0;
}

352
libmpdemux/freesdp/common.h Normal file
View File

@ -0,0 +1,352 @@
/*
This file is part of FreeSDP.
Copyright (C) 2001,2002,2003 Federico Montesino Pouzols <fedemp@altern.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* @file common.h
* @ingroup common
* @short Public header common for both parsing and formatting modules.
**/
#ifndef FSDP_COMMON_H
#define FSDP_COMMON_H
/* Macros to avoid name mangling when compiling with a C++ compiler */
#ifdef __cplusplus
# define BEGIN_C_DECLS extern "C" {
# define END_C_DECLS }
#else /* !__cplusplus */
# define BEGIN_C_DECLS
# define END_C_DECLS
#endif /* __cplusplus */
#include <sys/time.h>
#include <time.h>
BEGIN_C_DECLS
/**
* @defgroup common FreeSDP Common Facilities
*
* Data types and routines common for both parsing and formatting
* modules.
**/
/** @addtogroup common */
/*@{*/
/**
* @enum fsdp_error_t freesdp/common.h
* @short Error codes in the FreeSDP library.
*
* There is a FSDPE_MISSING_XXXX for each mandatory line, as
* FSDPE_MISSING_OWNER. This kind of error is reported when a
* mandatory description line, such as the owner line, is not found
* where it should be in the SDP description. There are also several
* error codes like FSDPE_INVALID_XXXX. These are returned when there
* is a recognized line in the parsed description that violates the
* SDP syntax or gives wrong parameters, for instance "c=foo bar",
* which would cause a FSDPE_INVALID_CONNECTION error code to be
* returned.
**/
typedef enum
{
FSDPE_OK = 0,
FSDPE_ILLEGAL_CHARACTER, /**< Misplaced '\r', '\n' or '\0' */
FSDPE_MISSING_VERSION, /**< The first line is not like
v=... */
FSDPE_INVALID_VERSION, /**< Parse error in version line,
perhaps, the version specified in
v=... is not valid for FreeSDP */
FSDPE_MISSING_OWNER, /**< No owner line found in its
place */
FSDPE_INVALID_OWNER, /**< Parse error in owner line */
FSDPE_MISSING_NAME, /**< No session name found in its
place */
FSDPE_EMPTY_NAME, /**< Empty session name line */
FSDPE_INVALID_CONNECTION, /**< Syntax error in connection
line */
FSDPE_INVALID_CONNECTION_ADDRTYPE, /**< Unrecognized address type in
connection line */
FSDPE_INVALID_CONNECTION_NETTYPE, /**< Unrecognized network type in
connection line */
FSDPE_INVALID_BANDWIDTH, /**< Parse error in bandwidth
line */
FSDPE_MISSING_TIME, /**< No time period has been given
for the session */
FSDPE_INVALID_TIME, /**< Parse error in time line */
FSDPE_INVALID_REPEAT, /**< Parse error in repeat time
line */
FSDPE_INVALID_TIMEZONE, /**< Parse error in timezone line */
FSDPE_INVALID_ENCRYPTION_METHOD, /**< Unknown encryption method */
FSDPE_INVALID_ATTRIBUTE, /**< Syntax error in an attribute
line */
FSDPE_INVALID_ATTRIBUTE_RTPMAP,/**< Parse error in a=rtpmap:... line */
FSDPE_INVALID_SESSION_TYPE, /**< An unknown session type has been
specified in a `type:'
session-level attribute */
FSDPE_INVALID_MEDIA, /**< Parse error in media line */
FSDPE_UNKNOWN_MEDIA_TYPE, /**< Unknown media type in media
line */
FSDPE_UNKNOWN_MEDIA_TRANSPORT, /**< A media transport has been
specified that is unknown */
FSDPE_OVERFILLED, /**< extra unknown lines are at the
end of the description */
FSDPE_INVALID_LINE, /**< a line unknown to FreeSDP has been
found */
FSDPE_MISSING_CONNECTION_INFO, /**< No connection information has
been provided for the whole
session nor one or more media */
FSDPE_INVALID_INDEX,
/* FSDPE_MAXSIZE, description does not fit requested maximun size */
FSDPE_INTERNAL_ERROR,
FSDPE_INVALID_PARAMETER, /**< Some parameter of the called
FreeSDP routine has been given an
invalid value. This includes
cases such as NULL pointers. */
FSDPE_BUFFER_OVERFLOW
} fsdp_error_t;
/**
* @short Type of network
*
* Initially, SDP defines "Internet". New network types may be
* registered with IANA. However, the number of types is expected to
* be small and rarely extended. In addition, every new network type
* requires at least one new address type.
**/
typedef enum
{
FSDP_NETWORK_TYPE_UNDEFINED, /**< Not provided */
FSDP_NETWORK_TYPE_INET /**< Internet */
} fsdp_network_type_t;
/**
* @short Type of address
*
* Initially, IPv4 and IPv6 are defined for the network type
* Internet. New address types may be registered with IANA.
**/
typedef enum
{
FSDP_ADDRESS_TYPE_UNDEFINED, /**< Not provided */
FSDP_ADDRESS_TYPE_IPV4, /**< IP version 4 */
FSDP_ADDRESS_TYPE_IPV6 /**< IP version 6 */
} fsdp_address_type_t;
/**
* @short Type of bandwith modifiers
*
* Bandwidth modifiers specify the meaning of the bandwidth
* value. Initially "Conference Total" and "Application Specific" are
* defined. Both use kilobits as bandwidth unit. "Conference Total"
* specifies that the bandwidth value is a proposed upper limit to the
* session bandwidth. "Application Specific" specifies thath the
* bandwidth value is the application concept of maximum bandwidth.
**/
typedef enum
{
FSDP_BW_MOD_TYPE_UNDEFINED, /**< Not provided */
FSDP_BW_MOD_TYPE_UNKNOWN, /**< Unknown bandwidth
modifier (FreeSDP
ignores it) */
FSDP_BW_MOD_TYPE_CONFERENCE_TOTAL, /**< "CT - Conference Total" */
FSDP_BW_MOD_TYPE_APPLICATION_SPECIFIC, /**< "AS - Application specific" */
FSDP_BW_MOD_TYPE_RTCP_SENDERS, /**< "RS - RTCP bandwidth for
senders */
FSDP_BW_MOD_TYPE_RTCP_RECEIVERS, /**< "RR - RTCP bandwidth for
receivers */
} fsdp_bw_modifier_type_t;
/**
* @short encryption method
*
* The encryption method specifies the way to get the encryption key.
**/
typedef enum
{
FSDP_ENCRYPTION_METHOD_UNDEFINED, /**< Not provided */
FSDP_ENCRYPTION_METHOD_CLEAR, /**< The key field is the
untransformed key */
FSDP_ENCRYPTION_METHOD_BASE64, /**< The key is base64
encoded */
FSDP_ENCRYPTION_METHOD_URI, /**< The key value provided is
a URI pointing to the actual
key */
FSDP_ENCRYPTION_METHOD_PROMPT /**< The key is not provided
but should be got prompting
the user */
} fsdp_encryption_method_t;
/**
* @short Advised reception/transmission mode
*
* Depending on wheter sendrecv, recvonly, sendonly or inactive
* attribute is given, the tools used to participate in the session
* should be started in the corresponding transmission
* mode. FSDP_SENDRECV_SENDRECV is the default for sessions which are
* not of the conference type broadcast or H332.
**/
typedef enum
{
FSDP_SENDRECV_UNDEFINED, /**< Not specified */
FSDP_SENDRECV_SENDRECV, /**< Send and receive */
FSDP_SENDRECV_RECVONLY, /**< Receive only */
FSDP_SENDRECV_SENDONLY, /**< Send only */
FSDP_SENDRECV_INACTIVE /**< Do not send nor receive */
} fsdp_sendrecv_mode_t;
/**
* @short Values for `orient' media attribute.
*
* Normally used with whiteboard media, this attribute specifies the
* orientation of the whiteboard.
**/
typedef enum
{
FSDP_ORIENT_UNDEFINED, /**< Not specified */
FSDP_ORIENT_PORTRAIT, /**< Portrait */
FSDP_ORIENT_LANDSCAPE, /**< Landscape */
FSDP_ORIENT_SEASCAPE /**< Upside down landscape */
} fsdp_orient_t;
/**
* @short Type of the conference
*
* The following types are initially defined: broadcast, meeting,
* moderated, test and H332.
**/
typedef enum
{
FSDP_SESSION_TYPE_UNDEFINED, /**< Not specified */
FSDP_SESSION_TYPE_BROADCAST, /**< Broadcast session */
FSDP_SESSION_TYPE_MEETING, /**< Meeting session */
FSDP_SESSION_TYPE_MODERATED, /**< Moderated session */
FSDP_SESSION_TYPE_TEST, /**< Test (do not display) */
FSDP_SESSION_TYPE_H332 /**< H332 session */
} fsdp_session_type_t;
/**
* @short Media type
*
* The following types are defined initially: audio, video,
* application, data and control.
**/
typedef enum
{
FSDP_MEDIA_UNDEFINED, /**< Not specified */
FSDP_MEDIA_VIDEO, /**< Video */
FSDP_MEDIA_AUDIO, /**< Audio */
FSDP_MEDIA_APPLICATION, /**< Application, such as whiteboard */
FSDP_MEDIA_DATA, /**< bulk data */
FSDP_MEDIA_CONTROL /**< Control channel */
} fsdp_media_t;
/**
* @short Transport protocol
*
* The transport protocol used depends on the address type. Initially,
* RTP over UDP Audio/Video Profile, and UDP are defined.
*
**/
typedef enum
{
FSDP_TP_UNDEFINED, /**< Not specified */
FSDP_TP_RTP_AVP, /**< RTP Audio/Video Profile */
FSDP_TP_UDP, /**< UDP */
FSDP_TP_TCP, /**< TCP */
FSDP_TP_UDPTL, /**< ITU-T T.38*/
FSDP_TP_VAT, /**< old vat protocol (historic)*/
FSDP_TP_OLD_RTP, /**< old rtp protocols (historic)*/
FSDP_TP_H320 /**< TODO: add to the parser */
} fsdp_transport_protocol_t;
/**
* Session-level attributes whose value is specified as a character
* string in FreeSDP. These values are usually given to
* fsdp_get_strn_att() in order to get the corresponding value.
*
**/
typedef enum
{
FSDP_SESSION_STR_ATT_CATEGORY,
FSDP_SESSION_STR_ATT_KEYWORDS,
FSDP_SESSION_STR_ATT_TOOL,
FSDP_SESSION_STR_ATT_CHARSET,
} fsdp_session_str_att_t;
/**
* @short FreeSDP SDP description media object.
*
* Object for media specific information in SDP descriptions. Each SDP
* description may include any number of media section. A
* fsdp_media_description_t object encapsulates the information in a
* media section, such as video, audio or whiteboard.
**/
typedef struct fsdp_media_description_t_s fsdp_media_description_t;
/**
* @short FreeSDP SDP session description object.
*
* Contains all the information extracted from a textual SDP
* description, including all the media announcements.
**/
typedef struct fsdp_description_t_s fsdp_description_t;
/**
* Allocates memory and initializes values for a new
* fsdp_description_t object. If you call this routine, do not forget
* about <code>fsdp_description_delete()</code>
*
* @return new fsdp_description_t object
**/
fsdp_description_t *fsdp_description_new (void);
/**
* Destroys a fsdp_description_t object.
*
* @param dsc pointer to the fsdp_description_t object to delete.
**/
void fsdp_description_delete (fsdp_description_t * dsc);
/**
* Calling this function over a description is equivalent to calling
* fsdp_description_delete and then fsdp_description_delete. This
* function is however more suitable and efficient for description
* processing loops.
*
* @param dsc pointer to the fsdp_description_t object to
* renew/recycle.
**/
void fsdp_description_recycle (fsdp_description_t * dsc);
/**
* * Returns a string correspondent to the error number.
* *
* * @param err_no error number.
* **/
const char *fsdp_strerror (fsdp_error_t err_no);
/*@}*//* closes addtogroup common */
END_C_DECLS
#endif /* FSDP_COMMON_H */

View File

@ -0,0 +1,72 @@
/*
This file is part of FreeSDP
Copyright (C) 2001, 2002 Federico Montesino Pouzols <fedemp@suidzer0.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* @file errorlist.c
*
* @short Translation table for error numbers
*
*/
#ifndef FSDP_ERRORLIST_C
#define FSDP_ERRORLIST_C
#include "common.h"
const char *fsdp_error_t_s[] = {
"No error",/** FSDPE_OK **/
"Illegal character detected",/** FSDPE_ILLEGAL_CHARACTER **/
"Missing version item", /** FSDPE_MISSING_VERSION **/
"Invalid version item", /** FSDPE_INVALID_VERSION **/
"Owner item not present", /** FSDPE_MISSING_OWNER **/
"Parse error in owner item", /** FSDPE_INVALID_OWNER **/
"Session name not present", /** FSDPE_MISSING_NAME **/
"Empty session name item", /** FSDPE_EMPTY_NAME **/
"Syntax error in connection item", /** FSDPE_INVALID_CONNECTION **/
"Unrecognized address type in connection item", /** FSDPE_INVALID_CONNECTION_ADDRTYPE **/
"Unrecognized network type in connection item", /** FSDPE_INVALID_CONNECTION_NETTYPE **/
"Parse error in bandwith item", /** FSDPE_INVALID_BANDWIDTH **/
"No time period for the session", /** FSDPE_MISSING_TIME **/
"Parse error in time item", /** FSDPE_INVALID_TIME **/
"Parse error in repeat time item", /** FSDPE_INVALID_REPEAT **/
"Parse error in timezone item", /** FSDPE_INVALID_TIMEZONE **/
"Unknown encryption method", /** FSDPE_INVALID_ENCRYPTION_METHOD **/
"Syntax error in an attribute item", /** FSDPE_INVALID_ATTRIBUTE **/
"Syntax error in an rtpmap attribute item", /** FSDPE_INVALID_ATTRIBUTE_RTPMAP **/
"Unknown session type in a session-level attribute", /** FSDPE_INVALID_SESSION_TYPE **/
"Parse error in media item", /** FSDPE_INVALID_MEDIA **/
"Unknown media type in media item", /** FSDPE_UNKNOWN_MEDIA_TYPE **/
"Unknown media transport", /** FSDPE_UNKNOWN_MEDIA_TRANSPORT **/
"Unknown extra lines in description item", /** FSDPE_OVERFILLED **/
"Unknown line found", /** FSDPE_INVALID_LINE **/
"No connection information provided", /** FSDPE_MISSING_CONNECTION_INFO **/
"Description item does not fit in MAXSIZE", /** FSDPE_INVALID_INDEX **/
"Internal error", /** FSDPE_INTERNAL_ERROR **/
"Invalid function parameters", /** FSDPE_INVALID_PARAMETER **/
"Buffer overflow" /** FSDPE_BUFFER_OVERFLOW **/
};
const char *
fsdp_strerror (fsdp_error_t err_no)
{
return (fsdp_error_t_s[err_no]);
}
#endif

1958
libmpdemux/freesdp/parser.c Normal file

File diff suppressed because it is too large Load Diff

728
libmpdemux/freesdp/parser.h Normal file
View File

@ -0,0 +1,728 @@
/*
This file is part of FreeSDP
Copyright (C) 2001,2002,2003 Federico Montesino Pouzols <fedemp@altern.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Benjamin Zores, (C) 2006
added support in parser for the a=control: lines.
added support in parser for the a=range: lines.
*/
/**
* @file parser.h
* @ingroup parser
* @short Specific public header for parsing module.
**/
#ifndef FSDP_PARSER_H
#define FSDP_PARSER_H
#include "common.h"
BEGIN_C_DECLS
/**
* @defgroup parser FreeSDP Parsing Module
*
* SDP descriptions parsing routines.
* @{
**/
/**
* Parse a SDP description in <code>description</code>, extracting the
* session properties into <code>dsc</code>. These properties can be
* obtained individually later using the <code>fsdp_get_xxxx<code>
* functions.
*
* @param description a multimedia session description formatted in
* SDP.
* @param dsc pointer that is updated to point to a fsdp_description_t
* object. This fsdp_description_t object should have been previously
* allocated using <code>fsdp_description_new()</code>; to free it,
* <code>fsdp_description_delete()</code> should be used.
*
* @return FSDPE_OK when parsing completes successfully. Otherwise,
* another error code is returned.
**/
fsdp_error_t fsdp_parse (const char *description, fsdp_description_t * dsc);
/**
* Get the SDP protocol version of the description.
*
* @return SDP protocol version number.
**/
unsigned int fsdp_get_version (const fsdp_description_t * dsc);
/**
* Get the username provided by the originator of the session.
*
* @param dsc SDP description object.
* @return username of the session owner
**/
const char *fsdp_get_owner_username (const fsdp_description_t * dsc);
/**
* Get the id for the session described in <code>dsc</code>.
*
* @param dsc SDP description object.
* @return id string for this session.
**/
const char *fsdp_get_session_id (const fsdp_description_t * dsc);
/**
* Get the announcement version for the session description in
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return announcement version string for this description.
**/
const char *fsdp_get_announcement_version (const fsdp_description_t * dsc);
/**
* Get the the type of network the owner of the session described in
* <code>dsc</code> is based on.
*
* @param dsc SDP description object.
* @return network type for the owner of this session.
**/
fsdp_network_type_t
fsdp_get_owner_network_type (const fsdp_description_t * dsc);
/**
* Get the the type of address the owner of the session described in
* <code>dsc</code> is based on.
*
* @param dsc SDP description object.
* @return network address type for the owner of this session.
**/
fsdp_address_type_t
fsdp_get_owner_address_type (const fsdp_description_t * dsc);
/**
* Get the network address of the owner of the session described in
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return network address for the owner this session.
**/
const char *fsdp_get_owner_address (const fsdp_description_t * dsc);
/**
* Get the name of the session described in <code>dsc</code>.
*
* @param dsc SDP description object.
* @return name of this session.
**/
const char *fsdp_get_name (const fsdp_description_t * dsc);
/**
* Get the information about the session provided in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return information of this session.
**/
const char *fsdp_get_information (const fsdp_description_t * dsc);
/**
* Get an URI about the session provided in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return string containing an URI about the session. NULL if the
* session uri is missing.
**/
const char *fsdp_get_uri (const fsdp_description_t * dsc);
/**
* Get the number of emails specified for the session in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return number of emails.
**/
unsigned int fsdp_get_emails_count (const fsdp_description_t * dsc);
/**
* Get the n-th email specified for the session in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @param index number of URI. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_emails_count() - 1.
* @return string containing an email about the session. NULL if there
* is no such index.
**/
const char *fsdp_get_email (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the number of phones specified for the session in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @return number of emails.
**/
unsigned int fsdp_get_phones_count (const fsdp_description_t * dsc);
/**
* Get the n-th phone specified for the session in the description
* <code>dsc</code>.
*
* @param dsc SDP description object.
* @param index number of URI. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_phones_count() - 1.
* @return string containing a phone about the session. NULL if there
* is no such index.
**/
const char *fsdp_get_phone (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the the global type of network of the multimedia session
* connection.
*
* @param dsc SDP description object.
* @return global network type for this
* connection. FSDP_NETWORK_TYPE_UNDEFINED if no global network
* address type is included in the description.
**/
fsdp_network_type_t
fsdp_get_global_conn_network_type (const fsdp_description_t * dsc);
/**
* Get the the global type of network address of the multimedia
* session connection.
*
* @param dsc SDP description object.
* @return global network address type for this connection.
* FSDP_ADDRESS_TYPE_UNDEFINED if no global network address type is
* included in the description.
**/
fsdp_address_type_t
fsdp_get_global_conn_address_type (const fsdp_description_t * dsc);
/**
* Get the the global address of the multimedia session connection.
*
* @param dsc SDP description object.
* @return global address for this connection.
**/
const char *fsdp_get_global_conn_address (const fsdp_description_t * dsc);
unsigned int
fsdp_get_global_conn_address_ttl (const fsdp_description_t * dsc);
unsigned int
fsdp_get_global_conn_address_count (const fsdp_description_t * dsc);
/**
* Get the number of bandwidth modifiers specified for this session.
*
* @param dsc SDP description object.
* @return number of bandwidth modifiers.
**/
unsigned int fsdp_get_bw_modifier_count (const fsdp_description_t * dsc);
/**
* Get the bandwidth modifier type for the session.
*
* @param dsc SDP description object.
* @param index number of bandwidth modifier.
*
* @return global bandwidth modifier type.
* @retval FSDP_BW_MOD_TYPE_UNDEFINED if no global bandwith modifier
* type is defined or invalid index.
* @retval FSDP_BW_MOD_TYPE_UNKNOWN if an unknown bandwith modifier is
* specified or an invalid index is provided. In this case
* fsdp_get_bw_modifer_type_unknown() can be called to get the
* modifier as a character string.
**/
fsdp_bw_modifier_type_t
fsdp_get_bw_modifier_type (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the textual bandwidth modifier type when it is unknown.
*
* @param dsc SDP description object.
* @param index number of bandwidth modifier.
*
* @return global bandwidth modifier type.
* @retval empty string if the provided bandwidth type is not unknown,
* the provided index is invalid or or there was a parse error.
**/
const char *fsdp_get_bw_modifier_type_unknown (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the value for the bandwidth modifier.
*
* @param dsc SDP description object.
* @param index number of bandwidth modifier.
* @return global bandwidth value.
* @retval 0 if no bandwidth is specified for this session or an
* invalid index has been provided.
**/
unsigned long int
fsdp_get_bw_value (const fsdp_description_t * dsc, unsigned int index);
/**
* Get the number of time periods specified for this session
*
* @param dsc SDP description object.
* @return number of time periods
**/
unsigned long int fsdp_get_period_count (const fsdp_description_t * dsc);
/**
* Get the start time for the period selected by index.
*
* @param dsc SDP description object.
* @param index number of time period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @return start time
* @retval 0 if an invalid index is provided.
**/
time_t
fsdp_get_period_start (const fsdp_description_t * dsc, unsigned int index);
/**
* Get the stop time for the period selected by index.
*
* @param dsc SDP description object.
* @param index number of time period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @return stop time
* @retval 0 if an invalid index is provided.
**/
time_t
fsdp_get_period_stop (const fsdp_description_t * dsc, unsigned int index);
/**
* Get the number of repeats for the period selected by index.
*
* @param dsc SDP description object.
* @param index number of the period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @return number of repeats
* @retval 0 if an invalid index is provided.
**/
unsigned int
fsdp_get_period_repeats_count (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the interval time of the repeat selected by rindex for the
* period selected by index.
*
* @param dsc SDP description object.
* @param index number of time period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @param rindex number of repeat
* @return interval time
* @retval 0 if an invalid index is provided.
**/
unsigned long int
fsdp_get_period_repeat_interval (const fsdp_description_t * dsc,
unsigned int index, unsigned int rindex);
/**
* Get the duration of the repeat selected by rindex for the period
* selected by index.
*
* @param dsc SDP description object.
* @param index number of time period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @param rindex number of repeat
* @return duration
* @retval 0 if an invalid index is provided.
**/
unsigned long int
fsdp_get_period_repeat_duration (const fsdp_description_t * dsc,
unsigned int index, unsigned int rindex);
/**
* Get the offsets of the repeat selected by rindex for the period
* selected by index.
*
* @param dsc SDP description object.
* @param index number of time period. Note that this index follows the
* traditional C convention: from 0 to fsdp_get_period_count() - 1.
* @param rindex number of repeat
* @return array of offsets
* @retval NULL if an invalid index is provided.
**/
const unsigned long int *fsdp_get_period_repeat_offsets (const
fsdp_description_t *
dsc,
unsigned int index,
unsigned int rindex);
/**
* Get the encryption method defined for this session.
*
* @param dsc SDP description object.
* @return encryption method. FSDP_ENCRYPTION_METHOD_UNDEFINED if no
* encryption method is specified.
**/
fsdp_encryption_method_t
fsdp_get_encryption_method (const fsdp_description_t * dsc);
/**
* Get the encryption key or a URI pointing to the encryption key for
* this session.
*
* @param dsc SDP description object.
* @return encryption key unless FSDP_ENCRYPTION_METHOD_URI is
* specified, in which case a URI pointing to the key is returned. If
* the global encryption method is undefined, NULL is returned.
**/
const char *fsdp_get_encryption_content (const fsdp_description_t * dsc);
/**
* Get timezone adjustments.
*
* @param dsc SDP description object.
* @return string with list of timezone adjustments
* @retval NULL if no timezone adjustment list was specified or there
* was a parse error.
**/
const char *fsdp_get_timezone_adj (const fsdp_description_t * dsc);
/**
*
**/
unsigned int
fsdp_get_unidentified_attribute_count (const fsdp_description_t * dsc);
/**
*
**/
const char *fsdp_get_unidentified_attribute (const fsdp_description_t * dsc,
unsigned int index);
/**
*
**/
unsigned int
fsdp_get_media_rtpmap_count (const fsdp_media_description_t * mdsc);
/**
*
**/
const char *fsdp_get_media_rtpmap_payload_type (const fsdp_media_description_t
* mdsc, unsigned int index);
/**
*
**/
const char *fsdp_get_media_rtpmap_encoding_name (const
fsdp_media_description_t *
mdsc, unsigned int index);
/**
*
**/
unsigned int
fsdp_get_media_rtpmap_clock_rate (const fsdp_media_description_t * mdsc,
unsigned int index);
/**
*
**/
const char *fsdp_get_media_rtpmap_encoding_parameters (const
fsdp_description_t *
mdsc,
unsigned int index);
/**
* Get the value of the session attribute specified in
* <code>att</code>. This function works for all the session
* attributes whose value is a character string. These attributes are
* defined in the session_string_attribute_t enumerated type.
*
* @param dsc SDP description object.
* @param att attribute to get.
*
* @return value of the attribute <code>att</code>.
* @retval NULL if the attribute was not specified or there was a
* parse error or an invalid att is given.
**/
const char *fsdp_get_str_att (const fsdp_description_t * dsc,
fsdp_session_str_att_t att);
/**
*
**/
unsigned int fsdp_get_sdplang_count (const fsdp_description_t * dsc);
/**
*
**/
const char *fsdp_get_sdplang (const fsdp_description_t * dsc,
unsigned int index);
/**
* Get the mode of the conference, specified with attributes sendrecv,
* sendonly, recvonly and inactive.
*
* @param dsc SDP description object.
* @return send/rec conference mode.
* @retval FSDP_SENDRECV_UNDEFINED if conference mode not provided.
**/
fsdp_sendrecv_mode_t fsdp_get_sendrecv_mode (const fsdp_description_t * dsc);
/**
* Get the type of conference, such as broadcast, meeting, moderated,
* test or H332.
*
* @param dsc SDP description object.
* @return conference type.
* @retval FSDP_SESSION_TYPE_UNDEFINED if conference type not provided.
**/
fsdp_session_type_t fsdp_get_session_type (const fsdp_description_t * dsc);
/**
*
**/
unsigned int fsdp_get_media_count (const fsdp_description_t * dsc);
/**
*
**/
const fsdp_media_description_t *fsdp_get_media (const fsdp_description_t *
dsc, unsigned int index);
/**
*
**/
fsdp_media_t fsdp_get_media_type (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int fsdp_get_media_port (const fsdp_media_description_t * dsc);
unsigned int fsdp_get_media_port_count (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_transport_protocol_t
fsdp_get_media_transport_protocol (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_formats (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int
fsdp_get_media_formats_count (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_format (const fsdp_media_description_t * dsc,
unsigned int index);
/**
*
**/
const char *fsdp_get_media_title (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_network_type_t
fsdp_get_media_network_type (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_address_type_t
fsdp_get_media_address_type (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_address (const fsdp_media_description_t * dsc);
unsigned int
fsdp_get_media_address_ttl (const fsdp_media_description_t * mdsc);
unsigned int
fsdp_get_media_address_count (const fsdp_media_description_t * mdsc);
/**
*
**/
fsdp_bw_modifier_type_t
fsdp_get_media_bw_modifier_type (const fsdp_media_description_t * dsc,
unsigned int index);
/**
*
**/
const char *fsdp_get_media_bw_modifier_type_unknown (const
fsdp_media_description_t
* dsc,
unsigned int index);
/**
*
**/
unsigned long int
fsdp_get_media_bw_value (const fsdp_media_description_t * dsc,
unsigned int index);
/**
*
**/
fsdp_encryption_method_t
fsdp_get_media_encryption_method (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_encryption_content (const fsdp_media_description_t
* dsc);
/**
*
**/
unsigned int fsdp_get_media_ptime (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int fsdp_get_media_maxptime (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int
fsdp_get_media_fmtp_count (const fsdp_media_description_t * mdsc);
/**
*
**/
const char *fsdp_get_media_fmtp (const fsdp_media_description_t * mdsc,
unsigned int index);
/**
*
**/
unsigned int
fsdp_get_media_sdplang_count (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_sdplang (const fsdp_media_description_t * dsc,
unsigned int index);
/**
*
**/
unsigned int fsdp_get_media_lang_count (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_lang (const fsdp_media_description_t * dsc,
unsigned int index);
unsigned int fsdp_get_control_count (const fsdp_description_t * dsc);
const char *fsdp_get_control (const fsdp_description_t * dsc,
unsigned int index);
const char *fsdp_get_range (const fsdp_description_t * dsc);
unsigned int
fsdp_get_media_control_count (const fsdp_media_description_t * mdsc);
char *fsdp_get_media_control (const fsdp_media_description_t * mdsc,
unsigned int index);
char *fsdp_get_media_range (const fsdp_media_description_t * mdsc);
/**
*
**/
fsdp_orient_t fsdp_get_media_orient (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_sendrecv_mode_t
fsdp_get_media_sendrecv (const fsdp_media_description_t * dsc);
/**
*
**/
float fsdp_get_media_framerate (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int fsdp_get_media_quality (const fsdp_media_description_t * dsc);
/**
*
**/
unsigned int fsdp_get_media_rtcp_port (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_network_type_t
fsdp_get_media_rtcp_network_type (const fsdp_media_description_t * dsc);
/**
*
**/
fsdp_address_type_t
fsdp_get_media_rtcp_address_type (const fsdp_media_description_t * dsc);
/**
*
**/
const char *fsdp_get_media_rtcp_address (const fsdp_media_description_t *
dsc);
/**
*
**/
unsigned int
fsdp_get_media_unidentified_attribute_count (const fsdp_media_description_t
* mdsc);
/**
*
**/
const char *fsdp_get_media_unidentified_attribute (const
fsdp_media_description_t *
mdsc, unsigned int index);
/** @} *//* closes parser group */
END_C_DECLS
#endif /* FSDP_PARSER_H */

View File

@ -0,0 +1,118 @@
/*
This file is part of FreeSDP
Copyright (C) 2001,2002,2003 Federico Montesino Pouzols <fedemp@suidzer0.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* @file parserpriv.h
*
* @short Private header for parser module.
**/
#ifndef FSDP_PARSERPRIV_H
#define FSDP_PARSERPRIV_H
#include "priv.h"
#include "parser.h"
/**
* Parse a connection (c=<network type> <address type> <connection
* address>) line. If the textual description in <code>p</code> begins
* with a connection line, it is parsed. If not, nothing is done.
*
* @param p fraction of textual SDP description.
* @param ntype where to store the network type.
* @param atype where to store the address type.
* @param address where to store the connection address as a string.
*
* @return parse error code.
**/
static fsdp_error_t
fsdp_parse_c (const char **p, fsdp_network_type_t * ntype,
fsdp_address_type_t * atype,
fsdp_connection_address_t * address);
/**
* Parse b (b=<modifier>:<bandwidth-value>) consecutive lines. If the
* textual description in <code>p</code> begins with a bandwidth line,
* it is parsed as well as all b lines inmediately after it. If not,
* nothing is done.
*
* @param p fraction of textual SDP description.
* @param bw_modifiers pointer to empty array of bandwidth modifiers to fill.
* @param bw_modifiers_count where to set the number of bandwidth
* modifiers successfully parsed.
*
* @return parse error code.
**/
static fsdp_error_t
fsdp_parse_b (const char **p, fsdp_bw_modifier_t ** bw_modifiers,
unsigned int *bw_modifiers_count);
/**
* Parse a k (k=<method>) or (k=<method>:<encryption key>) line. If
* the textual description in <code>p</code> begins with an encryption
* line, it is parsed. If not, nothing is done.
*
* @param p fraction of textual SDP description.
* @param method where to store the encryption method.
* @param content where to store the encryption key if provided.
*
* @return parse error code.
**/
static fsdp_error_t
fsdp_parse_k (const char **p, fsdp_encryption_method_t * method,
char **content);
/**
* Parses a string whose first token (first characters before the
* first space or end of string) is supposed to be a time in SDP
* syntax. Some examples of SDP times are: 2d, 5h, 3444, 7778s,
*
* @param time time in SDP syntax as a string.
* @param seconds where to store the value in seconds as an integer.
*
* @return parse error code.
**/
static fsdp_error_t
fsdp_repeat_time_to_uint (const char *time, unsigned long int *seconds);
static fsdp_error_t
fsdp_parse_rtpmap (fsdp_rtpmap_t *** rtpmap, unsigned int *counter,
const char *value);
/**
* Maximun default field len for "expected to be short" fields, like
* username, session_id or inet addresses.
*
* MDFLENS value must be MAXSHORTFIELDLEN - 1
**/
#define MAXSHORTFIELDLEN 96
#define MSFLENS "95"
/**
* Maximun default field len for "maybe very long" fields, like
* information, attribute values. This can also be used for lines
* where there is only a string field, like phone and email.
*
* MLFLENS value must be MAXLONGFIELDLEN - 1
**/
#define MAXLONGFIELDLEN 1024
#define MLFLENS "1023"
#endif /* FSDP_PARSERPRIV_H */

274
libmpdemux/freesdp/priv.h Normal file
View File

@ -0,0 +1,274 @@
/*
This file is part of FreeSDP
Copyright (C) 2001,2002,2003 Federico Montesino Pouzols <fedemp@altern.org>
FreeSDP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Benjamin Zores, (C) 2006
added support in parser for the a=control: lines.
added support in parser for the a=range: lines.
*/
/**
* @file priv.h
*
* @short Common private header for both formatting and parsing modules.
**/
#ifndef FSDP_PRIV_H
#define FSDP_PRIV_H
#define _GNU_SOURCE
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "common.h"
#define NTP_EPOCH_OFFSET 2208988800UL
#define FSDP_MAX_LENGTH 2000
/* Tags for doxygen documentation */
/**
* @mainpage FreeSDP Library Reference Manual
* @section overview Overview (README)
* @verbinclude ../../README
*
**/
/**
* @example formatdemo.c
*
* A basic SDP descriptions formatter based on FreeSDP.
**/
/**
* @example parsedemo.c
*
* A basic SDP descriptions parser based on FreeSDP.
**/
/* Private routines declarations */
BEGIN_C_DECLS
/**
* @short bandwidth modifier
*
* Holds type of modifier and value. Also holds the literal bandwidth
* modifier if unknown.
**/
typedef struct
{
fsdp_bw_modifier_type_t b_mod_type;
unsigned long int b_value;
char *b_unknown_bw_modt;
} fsdp_bw_modifier_t;
/**
* @short a=rtpmap: attribute
*
* Holds payload type, enconding name, RTP clock rate, and encofing
* parameters.
**/
typedef struct
{
char *pt;
char *encoding_name;
unsigned int clock_rate;
char *parameters;
} fsdp_rtpmap_t;
/**
* @short Connection address specification
*
* Holds address (unicast or multicast) as well as TTL and number of
* ports, when it is an IP4 multicast address.
**/
typedef struct fsdp_connection_address_t_s
{
char *address;
unsigned int address_ttl;
unsigned int address_count;
} fsdp_connection_address_t;
/**
* @short Struct for each media in a session description.
**/
struct fsdp_media_description_t_s
{
/* from `m=<media> <port> <transport> <fmt list>' line */
fsdp_media_t media_type;
unsigned int port;
unsigned int port_count;
fsdp_transport_protocol_t transport;
char **formats;
unsigned int formats_count;
/* from i=<media title> */
char *i_title;
/* from `c=<network type> <address type> <connection address>' line
(optional) */
fsdp_network_type_t c_network_type;
fsdp_address_type_t c_address_type;
fsdp_connection_address_t c_address;
/* from `b=<modifier>:<bandwidth-value>' lines (optional) */
fsdp_bw_modifier_t *bw_modifiers;
unsigned int bw_modifiers_count;
/* from `k=<method>' or `k=<method>:<encryption key>' line
(optional) */
fsdp_encryption_method_t k_encryption_method;
char *k_encryption_content;
/* from `a=<attribute>' or `a=<attribute>:<value>' lines (opt) */
unsigned long int a_ptime;
unsigned long int a_maxptime;
/* rtpmap */
fsdp_rtpmap_t **a_rtpmaps;
unsigned int a_rtpmaps_count;
fsdp_orient_t a_orient;
fsdp_sendrecv_mode_t a_sendrecv_mode;
char **a_sdplangs;
unsigned int a_sdplangs_count;
char **a_langs;
unsigned int a_langs_count;
char **a_controls;
unsigned int a_controls_count;
char *a_range;
float a_framerate;
unsigned int a_quality;
char **a_fmtps;
unsigned int a_fmtps_count;
/* rtcp attribute */
unsigned int a_rtcp_port;
fsdp_network_type_t a_rtcp_network_type;
fsdp_address_type_t a_rtcp_address_type;
char *a_rtcp_address;
/* media attributes that are not directly supported */
char **unidentified_attributes;
unsigned int unidentified_attributes_count;
};
typedef struct fsdp_media_description_t_s fsdp_media_announcement_t;
/**
* @short Information for a repeat (struct for r= lines)
**/
typedef struct
{
/* times in seconds */
unsigned long int interval;
unsigned long int duration;
unsigned long int *offsets;
unsigned int offsets_count;
} fsdp_repeat_t;
/**
* @short Information about a time period
*
* The start and stop times as well as the information from the r=
* lines for a t= line are stored in this structures.
**/
typedef struct
{
time_t start;
time_t stop;
fsdp_repeat_t **repeats;
unsigned int repeats_count;
} fsdp_time_period_t;
/**
* @short Struct for session descriptions.
**/
struct fsdp_description_t_s
{
/* from v=... line */
unsigned int version;
/* from o=... line */
char *o_username;
char *o_session_id;
char *o_announcement_version;
fsdp_network_type_t o_network_type;
fsdp_address_type_t o_address_type;
char *o_address;
/* from s=... line */
char *s_name;
/* from i=... line (opt) */
char *i_information;
/* from u=... line (opt) */
char *u_uri;
/* from e=... lines (0 or more) */
const char **emails;
unsigned int emails_count;
/* from p=... lines (0 or more) */
const char **phones;
unsigned int phones_count;
/* from `c=<network type> <address type> <connection address>' line */
fsdp_network_type_t c_network_type;
fsdp_address_type_t c_address_type;
fsdp_connection_address_t c_address;
/* from `b=<modifier>:<bandwidth-value>' lines (optional) */
fsdp_bw_modifier_t *bw_modifiers;
unsigned int bw_modifiers_count;
/* from `t=<start time> <stop time>' lines (1 or more) */
/* from `r=<repeat interval> <active duration> <list of offsets from
start-time>' */
fsdp_time_period_t **time_periods;
unsigned int time_periods_count;
/* from `z=<adjustment time> <offset> <adjustment time> <offset>
....' lines */
char *timezone_adj;
/* from `k=<method>' or `k=<method>:<encryption key>' line (opt) */
fsdp_encryption_method_t k_encryption_method;
char *k_encryption_content;
/* from `a=<attribute>' or `a=<attribute>:<value>' lines (opt) */
char *a_category;
char *a_keywords;
char *a_tool;
char *a_range;
/* rtpmap */
fsdp_rtpmap_t **a_rtpmaps;
unsigned int a_rtpmaps_count;
fsdp_sendrecv_mode_t a_sendrecv_mode;
fsdp_session_type_t a_type;
char *a_charset;
char **a_sdplangs;
unsigned int a_sdplangs_count;
char **a_langs;
unsigned int a_langs_count;
char **a_controls;
unsigned int a_controls_count;
/* from `m=<media> <port>/<number of ports> <transport> <fmt list>'
lines [one or more] */
fsdp_media_announcement_t **media_announcements;
unsigned int media_announcements_count;
/* session attributes that are not directly supported */
char **unidentified_attributes;
unsigned int unidentified_attributes_count;
};
#define MEDIA_RTPMAPS_MAX_COUNT 5
#define SDPLANGS_MAX_COUNT 5
#define SDPCONTROLS_MAX_COUNT 10
#define UNIDENTIFIED_ATTRIBUTES_MAX_COUNT 5
END_C_DECLS
#endif /* FSDP_PRIV_H */