conncheck.h 4.71 KB
Newer Older
1 2 3
/*
 * This file is part of the Nice GLib ICE library.
 *
4 5 6
 * (C) 2006-2009 Collabora Ltd.
 *  Contact: Youness Alaoui
 * (C) 2006-2009 Nokia Corporation. All rights reserved.
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
 *  Contact: Kai Vehmanen
 *
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is the Nice GLib ICE library.
 *
 * The Initial Developers of the Original Code are Collabora Ltd and Nokia
 * Corporation. All Rights Reserved.
 *
 * Contributors:
 *   Dafydd Harries, Collabora Ltd.
26
 *   Youness Alaoui, Collabora Ltd.
27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
 *   Kai Vehmanen, Nokia
 *
 * Alternatively, the contents of this file may be used under the terms of the
 * the GNU Lesser General Public License Version 2.1 (the "LGPL"), in which
 * case the provisions of LGPL are applicable instead of those above. If you
 * wish to allow use of your version of this file only under the terms of the
 * LGPL and not to allow others to use your version of this file under the
 * MPL, indicate your decision by deleting the provisions above and replace
 * them with the notice and other provisions required by the LGPL. If you do
 * not delete the provisions above, a recipient may use your version of this
 * file under either the MPL or the LGPL.
 */

#ifndef _NICE_CONNCHECK_H
#define _NICE_CONNCHECK_H

/* note: this is a private header to libnice */

#include "agent.h"
#include "stream.h"
47 48
#include "stun/stunagent.h"
#include "stun/usages/timer.h"
49 50

#define NICE_CANDIDATE_PAIR_MAX_FOUNDATION        NICE_CANDIDATE_MAX_FOUNDATION*2
51

52 53 54 55 56 57 58 59 60 61 62
/**
 * NiceCheckState:
 * @NICE_CHECK_WAITING: Waiting to be scheduled.
 * @NICE_CHECK_IN_PROGRESS: Connection checks started.
 * @NICE_CHECK_SUCCEEDED: Connection successfully checked.
 * @NICE_CHECK_FAILED: No connectivity; retransmissions ceased.
 * @NICE_CHECK_FROZEN: Waiting to be scheduled to %NICE_CHECK_WAITING.
 * @NICE_CHECK_DISCOVERED: A valid candidate pair not on the check list.
 *
 * States for checking a candidate pair.
 */
63 64
typedef enum
{
65 66 67 68 69 70
  NICE_CHECK_WAITING = 1,
  NICE_CHECK_IN_PROGRESS,
  NICE_CHECK_SUCCEEDED,
  NICE_CHECK_FAILED,
  NICE_CHECK_FROZEN,
  NICE_CHECK_DISCOVERED,
71 72 73
} NiceCheckState;

typedef struct _CandidateCheckPair CandidateCheckPair;
74 75 76 77 78 79 80 81 82
typedef struct _StunTransaction StunTransaction;

struct _StunTransaction
{
  GTimeVal next_tick;       /* next tick timestamp */
  StunTimer timer;
  uint8_t buffer[STUN_MAX_MESSAGE_SIZE_IPV6];
  StunMessage message;
};
83 84 85 86 87 88 89 90

struct _CandidateCheckPair
{
  NiceAgent *agent;         /* back pointer to owner */
  guint stream_id;
  guint component_id;
  NiceCandidate *local;
  NiceCandidate *remote;
91
  NiceSocket *sockptr;
92
  gchar foundation[NICE_CANDIDATE_PAIR_MAX_FOUNDATION];
93 94
  NiceCheckState state;
  gboolean nominated;
95
  gboolean valid;
96 97
  gboolean use_candidate_on_next_check;
  gboolean mark_nominated_on_response_arrival;
98 99 100
  gboolean retransmit;  /* if the first stun request must be retransmitted */
  CandidateCheckPair *discovered_pair;
  CandidateCheckPair *succeeded_pair;
101
  guint64 priority;
102
  guint32 prflx_priority;
103
  GSList *stun_transactions; /* a list of ongoing stun requests */
104 105
};

106 107 108
int conn_check_add_for_candidate (NiceAgent *agent, guint stream_id, NiceComponent *component, NiceCandidate *remote);
int conn_check_add_for_local_candidate (NiceAgent *agent, guint stream_id, NiceComponent *component, NiceCandidate *local);
gboolean conn_check_add_for_candidate_pair (NiceAgent *agent, guint stream_id, NiceComponent *component, NiceCandidate *local, NiceCandidate *remote);
109
void conn_check_free (NiceAgent *agent);
110
void conn_check_schedule_next (NiceAgent *agent);
111
int conn_check_send (NiceAgent *agent, CandidateCheckPair *pair);
112
void conn_check_prune_stream (NiceAgent *agent, NiceStream *stream);
113
gboolean conn_check_handle_inbound_stun (NiceAgent *agent, NiceStream *stream, NiceComponent *component, NiceSocket *udp_socket, const NiceAddress *from, gchar *buf, guint len);
114
gint conn_check_compare (const CandidateCheckPair *a, const CandidateCheckPair *b);
115
void conn_check_remote_credentials_set(NiceAgent *agent, NiceStream *stream);
116
NiceCandidateTransport conn_check_match_transport (NiceCandidateTransport transport);
117
void
118
conn_check_prune_socket (NiceAgent *agent, NiceStream *stream, NiceComponent *component,
119
    NiceSocket *sock);
120

121
guint32 ensure_unique_priority (NiceComponent *component, guint32 priority);
122
void recalculate_pair_priorities (NiceAgent *agent);
123

124
#endif /*_NICE_CONNCHECK_H */