osip_negotiation.h

/*
  The oSIP library implements the Session Initiation Protocol (SIP -rfc3261-)
  Copyright (C) 2001,2002,2003,2004  Aymeric MOIZARD jack@atosc.org
  
  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.
  
  This library 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
  Lesser General Public License for more details.
  
  You should have received a copy of the GNU Lesser General Public
  License along with this library; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/


#ifndef _SDP_NEGOC_H_
#define _SDP_NEGOC_H_

#include <osipparser2/sdp_message.h>


#ifdef __cplusplus
extern "C"
{
#endif

  typedef struct osip_negotiation_ctx osip_negotiation_ctx_t;

  struct osip_negotiation_ctx
  {
    void *mycontext;            
    sdp_message_t *remote;      
    sdp_message_t *local;       
  };

  int osip_negotiation_ctx_init (osip_negotiation_ctx_t ** ctx);
  void osip_negotiation_ctx_free (osip_negotiation_ctx_t * ctx);

  int osip_negotiation_ctx_set_mycontext (osip_negotiation_ctx_t * ctx,
                                          void *value);
  void *osip_negotiation_ctx_get_mycontext (osip_negotiation_ctx_t * ctx);

  int osip_negotiation_ctx_set_local_sdp (osip_negotiation_ctx_t * ctx,
                                          sdp_message_t * sdp);
  sdp_message_t *osip_negotiation_ctx_get_local_sdp (osip_negotiation_ctx_t *
                                                     ctx);
  int osip_negotiation_ctx_set_remote_sdp (osip_negotiation_ctx_t * ctx,
                                           sdp_message_t * sdp);
  sdp_message_t *osip_negotiation_ctx_get_remote_sdp (osip_negotiation_ctx_t *
                                                      ctx);


  typedef struct osip_negotiation osip_negotiation_t;

  struct osip_negotiation
  {

    char *o_username;               
    char *o_session_id;             
    char *o_session_version;        
    char *o_nettype;                
    char *o_addrtype;               
    char *o_addr;                   
    char *c_nettype;                
    char *c_addrtype;               
    char *c_addr;                   
    char *c_addr_multicast_ttl;     
    char *c_addr_multicast_int;     
    osip_list_t *audio_codec;       
    osip_list_t *video_codec;       
    osip_list_t *other_codec;       
    int (*fcn_set_info) (void *, sdp_message_t *);   
    int (*fcn_set_uri) (void *, sdp_message_t *);    
    int (*fcn_set_emails) (void *, sdp_message_t *); 
    int (*fcn_set_phones) (void *, sdp_message_t *); 
    int (*fcn_set_attributes) (void *, sdp_message_t *, int); 
    int (*fcn_accept_audio_codec) (void *, char *, char *, int, char *); 
    int (*fcn_accept_video_codec) (void *, char *, char *, int, char *); 
    int (*fcn_accept_other_codec) (void *, char *, char *, char *, char *); 
    char *(*fcn_get_audio_port) (void *, int);   
    char *(*fcn_get_video_port) (void *, int);   
    char *(*fcn_get_other_port) (void *, int);   
  };


  int osip_negotiation_init (osip_negotiation_t ** conf_out);
  void osip_negotiation_free (osip_negotiation_t * conf);

  int osip_negotiation_set_o_username (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_o_session_id (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_o_session_version (osip_negotiation_t *,
                                              char *tmp);
  int osip_negotiation_set_o_nettype (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_o_addrtype (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_o_addr (osip_negotiation_t *, char *tmp);

  int osip_negotiation_set_c_nettype (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_c_addrtype (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_c_addr (osip_negotiation_t *, char *tmp);
  int osip_negotiation_set_c_addr_multicast_ttl (osip_negotiation_t *,
                                                 char *tmp);
  int osip_negotiation_set_c_addr_multicast_int (osip_negotiation_t *,
                                                 char *tmp);

  int osip_negotiation_add_support_for_audio_codec (osip_negotiation_t *,
                                                    char *payload,
                                                    char *number_of_port,
                                                    char *proto,
                                                    char *c_nettype,
                                                    char *c_addrtype,
                                                    char *c_addr,
                                                    char
                                                    *c_addr_multicast_ttl,
                                                    char
                                                    *c_addr_multicast_int,
                                                    char *a_rtpmap);
  int osip_negotiation_add_support_for_video_codec (osip_negotiation_t *,
                                                    char *payload,
                                                    char *number_of_port,
                                                    char *proto,
                                                    char *c_nettype,
                                                    char *c_addrtype,
                                                    char *c_addr,
                                                    char
                                                    *c_addr_multicast_ttl,
                                                    char
                                                    *c_addr_multicast_int,
                                                    char *a_rtpmap);
  int osip_negotiation_add_support_for_other_codec (osip_negotiation_t *,
                                                    char *payload,
                                                    char *number_of_port,
                                                    char *proto,
                                                    char *c_nettype,
                                                    char *c_addrtype,
                                                    char *c_addr,
                                                    char
                                                    *c_addr_multicast_ttl,
                                                    char
                                                    *c_addr_multicast_int,
                                                    char *a_rtpmap);

#ifndef DOXYGEN

  int osip_negotiation_remove_audio_payloads (osip_negotiation_t * config);
  int osip_negotiation_remove_video_payloads (osip_negotiation_t * config);
  int osip_negotiation_remove_other_payloads (osip_negotiation_t * config);
#endif

  int osip_negotiation_set_fcn_set_info (osip_negotiation_t *,
                                         int (*fcn) (osip_negotiation_ctx_t *,
                                                     sdp_message_t *));
  int osip_negotiation_set_fcn_set_uri (osip_negotiation_t *,
                                        int (*fcn) (osip_negotiation_ctx_t *,
                                                    sdp_message_t *));
  int osip_negotiation_set_fcn_set_emails (osip_negotiation_t *,
                                           int (*fcn) (osip_negotiation_ctx_t
                                                       *, sdp_message_t *));
  int osip_negotiation_set_fcn_set_phones (osip_negotiation_t *,
                                           int (*fcn) (osip_negotiation_ctx_t
                                                       *, sdp_message_t *));
  int
    osip_negotiation_set_fcn_set_attributes (osip_negotiation_t *,
                                             int (*fcn)
                                             (osip_negotiation_ctx_t *,
                                              sdp_message_t *, int));
  int
    osip_negotiation_set_fcn_accept_audio_codec (osip_negotiation_t *,
                                                 int (*fcn)
                                                 (osip_negotiation_ctx_t *,
                                                  char *, char *, int,
                                                  char *));
  int
    osip_negotiation_set_fcn_accept_video_codec (osip_negotiation_t *,
                                                 int (*fcn)
                                                 (osip_negotiation_ctx_t *,
                                                  char *, char *, int,
                                                  char *));
  int
    osip_negotiation_set_fcn_accept_other_codec (osip_negotiation_t *,
                                                 int (*fcn)
                                                 (osip_negotiation_ctx_t *,
                                                  char *, char *, char *,
                                                  char *));
  int osip_negotiation_set_fcn_get_audio_port (osip_negotiation_t *,
                                               char
                                               *(*fcn) (osip_negotiation_ctx_t
                                                        *, int));
  int osip_negotiation_set_fcn_get_video_port (osip_negotiation_t *,
                                               char
                                               *(*fcn) (osip_negotiation_ctx_t
                                                        *, int));
  int osip_negotiation_set_fcn_get_other_port (osip_negotiation_t *,
                                               char
                                               *(*fcn) (osip_negotiation_ctx_t
                                                        *, int));

  int osip_negotiation_ctx_execute_negotiation (osip_negotiation_t *,
                                                osip_negotiation_ctx_t * ctx);

  int osip_negotiation_sdp_build_offer (osip_negotiation_t *,
                                        osip_negotiation_ctx_t * ctx,
                                        sdp_message_t ** sdp,
                                        char *audio_port, char *video_port);
  int __osip_negotiation_sdp_build_offer (osip_negotiation_t *,
                                          osip_negotiation_ctx_t * ctx,
                                          sdp_message_t ** sdp,
                                          char *audio_port, char *video_port,
                                          char *audio_codec,
                                          char *video_codec);

  int osip_negotiation_sdp_message_put_on_hold (sdp_message_t * sdp);

  int osip_negotiation_sdp_message_put_off_hold (sdp_message_t * sdp);

#ifdef __cplusplus
}
#endif

#endif /*_SDP_NEGOC_H_ */

---