pidgin/pidgin
Clone
Summary
Browse
Changes
Graph
Make sure all of the license headers for IRCv3 are GPLv2
5 months ago, Gary Kramlich
31e8c7c92e2f
Make sure all of the license headers for IRCv3 are GPLv2
Testing Done:
Ran `licensecheck` from debian in the following way.
```
$ licensecheck *.[ch] | cut -d: -f 2 | sort | uniq -c
27 GNU General Public License v2.0 or later
```
Reviewed at https://reviews.imfreedom.org/r/2913/
/* purple
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program 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., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_MEDIA_CANDIDATE_H
#define PURPLE_MEDIA_CANDIDATE_H
#include
"enum-types.h"
#include
<glib-object.h>
#include
"purpleversion.h"
G_BEGIN_DECLS
/**
* PURPLE_MEDIA_TYPE_CANDIDATE:
*
* The standard _get_type macro for #PurpleMediaCandidate.
*
* Since: 3.0.0
*/
#define PURPLE_MEDIA_TYPE_CANDIDATE purple_media_candidate_get_type()
/**
* purple_media_candidate_get_type:
*
* Gets the type of the media candidate structure.
*
* Returns: The media canditate's GType
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
G_DECLARE_FINAL_TYPE
(
PurpleMediaCandidate
,
purple_media_candidate
,
PURPLE_MEDIA
,
CANDIDATE
,
GObject
)
/**
* purple_media_candidate_new:
* @foundation: The foundation of the candidate.
* @component_id: The component this candidate is for.
* @type: The type of candidate.
* @proto: The protocol this component is for.
* @ip: The IP address of this component.
* @port: The network port.
*
* Creates a PurpleMediaCandidate instance.
*
* Returns: The newly created PurpleMediaCandidate instance.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
PurpleMediaCandidate
*
purple_media_candidate_new
(
const
gchar
*
foundation
,
guint
component_id
,
PurpleMediaCandidateType
type
,
PurpleMediaNetworkProtocol
proto
,
const
gchar
*
ip
,
guint
port
);
/**
* purple_media_candidate_copy:
* @candidate: The candidate to copy.
*
* Copies a PurpleMediaCandidate.
*
* Returns: (transfer full): The copy of the PurpleMediaCandidate.
*
* Since: 2.7.0
*/
PURPLE_AVAILABLE_IN_2_7
PurpleMediaCandidate
*
purple_media_candidate_copy
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_list_copy:
* @candidates: (element-type PurpleMediaCandidate) (transfer none): The list
* of candidates to be copied.
*
* Copies a GList of PurpleMediaCandidate and its contents.
*
* Returns: (element-type PurpleMediaCandidate) (transfer full): The copy of
* the candidate list.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
GList
*
purple_media_candidate_list_copy
(
GList
*
candidates
);
/**
* purple_media_candidate_list_free:
* @candidates: (element-type PurpleMediaCandidate) (transfer full): The list
* of candidates to be freed.
*
* Frees a GList of PurpleMediaCandidate and its contents.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
void
purple_media_candidate_list_free
(
GList
*
candidates
);
/**
* purple_media_candidate_get_foundation:
* @candidate: The candidate to get the foundation from.
*
* Gets the foundation (identifier) from the candidate.
*
* Returns: The foundation.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
gchar
*
purple_media_candidate_get_foundation
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_component_id:
* @candidate: The candidate to get the component id from.
*
* Gets the component id (rtp or rtcp)
*
* Returns: The component id.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
guint
purple_media_candidate_get_component_id
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_ip:
* @candidate: The candidate to get the IP address from.
*
* Gets the IP address.
*
* Returns: The IP address.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
gchar
*
purple_media_candidate_get_ip
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_port:
* @candidate: The candidate to get the port from.
*
* Gets the port.
*
* Returns: The port.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
guint16
purple_media_candidate_get_port
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_base_ip:
* @candidate: The candidate to get the base IP address from.
*
* Gets the base (internal) IP address.
* This can be NULL.
*
* Returns: The base IP address.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
gchar
*
purple_media_candidate_get_base_ip
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_base_port:
* @candidate: The candidate to get the base port.
*
* Gets the base (internal) port.
* Invalid if the base IP is NULL.
*
* Returns: The base port.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
guint16
purple_media_candidate_get_base_port
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_protocol:
* @candidate: The candidate to get the protocol from.
*
* Gets the protocol (TCP or UDP).
*
* Returns: The protocol.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
PurpleMediaNetworkProtocol
purple_media_candidate_get_protocol
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_priority:
* @candidate: The candidate to get the priority from.
*
* Gets the priority.
*
* Returns: The priority.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
guint32
purple_media_candidate_get_priority
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_candidate_type:
* @candidate: The candidate to get the candidate type from.
*
* Gets the candidate type.
*
* Returns: The candidate type.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
PurpleMediaCandidateType
purple_media_candidate_get_candidate_type
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_username:
* @candidate: The candidate to get the username from.
*
* Gets the username.
* This can be NULL. It depends on the transmission type.
*
* Returns: The username.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
gchar
*
purple_media_candidate_get_username
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_password:
* @candidate: The candidate to get the password from.
*
* Gets the password.
*
* This can be NULL. It depends on the transmission type.
*
* Returns: The password.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
gchar
*
purple_media_candidate_get_password
(
PurpleMediaCandidate
*
candidate
);
/**
* purple_media_candidate_get_ttl:
* @candidate: The candidate to get the TTL from.
*
* Gets the TTL.
*
* Returns: The TTL.
*
* Since: 2.6.0
*/
PURPLE_AVAILABLE_IN_2_6
guint
purple_media_candidate_get_ttl
(
PurpleMediaCandidate
*
candidate
);
G_END_DECLS
#endif
/* PURPLE_MEDIA_CANDIDATE_H */