pidgin/pidgin

Really disable some plugins
default tip
38 hours ago, Gary Kramlich
44125b8e3b27
Really disable some plugins

Previous we disabled some plugins that we want to keep around but can't port
yet by setting `build_by_default` to `false`. However, this isn't working on
many machines. I haven't figured out why, so instead lets just make their
meson.build files exit early.

Testing Done:
Ran the turtles on a machine that was still building these plugins.

Reviewed at https://reviews.imfreedom.org/r/3142/
/*
* Purple - Internet Messaging Library
* Copyright (C) Pidgin Developers <devel@pidgin.im>
*
* 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 library 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 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 General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this library; if not, see <https://www.gnu.org/licenses/>.
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_MEDIA_H
#define PURPLE_MEDIA_H
#include <glib.h>
#include <glib-object.h>
typedef struct _PurpleMedia PurpleMedia;
#include "media/candidate.h"
#include "media/codec.h"
#include "media/enum-types.h"
#define PURPLE_TYPE_MEDIA (purple_media_get_type())
#define PURPLE_MEDIA(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), PURPLE_TYPE_MEDIA, PurpleMedia))
#define PURPLE_MEDIA_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), PURPLE_TYPE_MEDIA, PurpleMediaClass))
#define PURPLE_IS_MEDIA(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), PURPLE_TYPE_MEDIA))
#define PURPLE_IS_MEDIA_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), PURPLE_TYPE_MEDIA))
#define PURPLE_MEDIA_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), PURPLE_TYPE_MEDIA, PurpleMediaClass))
#include "purpleaccount.h"
#include "purpleversion.h"
#include "signals.h"
#include "util.h"
typedef struct _PurpleMediaClass PurpleMediaClass;
typedef struct _PurpleMediaPrivate PurpleMediaPrivate;
/**
* PurpleMedia:
*
* The media instance
*/
struct _PurpleMedia
{
GObject parent;
/*< private >*/
PurpleMediaPrivate *priv;
};
/**
* PurpleMediaClass:
*
* The media class
*/
struct _PurpleMediaClass
{
GObjectClass parent_class;
/*< private >*/
void (*purple_reserved1)(void);
void (*purple_reserved2)(void);
void (*purple_reserved3)(void);
void (*purple_reserved4)(void);
};
G_BEGIN_DECLS
/**
* purple_media_get_type:
*
* Gets the media class's GType
*
* Returns: The media class's GType.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GType purple_media_get_type(void);
/**
* purple_media_get_session_ids:
* @media: The media session from which to retrieve session IDs.
*
* Gets a list of session IDs.
*
* Returns: (element-type utf8) (transfer container): List of session IDs.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GList *purple_media_get_session_ids(PurpleMedia *media);
/**
* purple_media_get_account:
* @media: The media session to retrieve the account from.
*
* Gets the PurpleAccount this media session is on.
*
* Returns: (transfer full): The account retrieved.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
PurpleAccount *purple_media_get_account(PurpleMedia *media);
/**
* purple_media_get_protocol_data:
* @media: The media session to retrieve the protocol data from.
*
* Gets the protocol data from the media session.
*
* Returns: The protocol data retrieved.
*
* Since: 3.0
*/
PURPLE_AVAILABLE_IN_3_0
gpointer purple_media_get_protocol_data(PurpleMedia *media);
/**
* purple_media_set_protocol_data:
* @media: The media session to set the protocol data on.
* @protocol_data: The data to set on the media session.
*
* Sets the protocol data on the media session.
*
* Since: 3.0
*/
PURPLE_AVAILABLE_IN_3_0
void purple_media_set_protocol_data(PurpleMedia *media, gpointer protocol_data);
/**
* purple_media_error:
* @media: The media object to set the state on.
* @error: The format of the error message to send in the signal.
* @...: The arguments to plug into the format.
*
* Signals an error in the media session.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_error(PurpleMedia *media, const gchar *error, ...) G_GNUC_PRINTF(2, 3);
/**
* purple_media_end:
* @media: The media object with which to end streams.
* @session_id: The session to end streams on.
* @participant: The participant to end streams with.
*
* Ends all streams that match the given parameters
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_end(PurpleMedia *media, const gchar *session_id,
const gchar *participant);
/**
* purple_media_stream_info:
* @media: The media instance to containing the stream to signal.
* @type: The type of info being signaled.
* @session_id: The id of the session of the stream being signaled.
* @participant: The participant of the stream being signaled.
* @local: TRUE if the info originated locally, FALSE if on the remote end.
*
* Signals different information about the given stream.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_stream_info(PurpleMedia *media, PurpleMediaInfoType type,
const gchar *session_id, const gchar *participant,
gboolean local);
/**
* purple_media_set_params:
* @media: The media object to set the parameters on.
* @params: (element-type utf8 GObject.Value) (transfer none): Hash table of
* parameters to pass.
*
* Sets various optional parameters of the media call.
*
* Currently supported are:
* - "sdes-cname" : The CNAME for the RTP sessions
* - "sdes-name" : Real name used to describe the source in SDES messages
* - "sdes-tool" : The TOOL to put in SDES messages
* - "sdes-email" : Email address to put in SDES messages
* - "sdes-location" : The LOCATION to put in SDES messages
* - "sdes-note" : The NOTE to put in SDES messages
* - "sdes-phone" : The PHONE to put in SDES messages
*
* Since: 2.8
*/
PURPLE_AVAILABLE_IN_2_8
void purple_media_set_params(PurpleMedia *media, GHashTable *params);
/**
* purple_media_get_available_params:
* @media: The media object
*
* Gets the list of optional parameters supported by the media backend.
*
* The list is owned by the #PurpleMedia internals and should NOT be freed.
*
* Returns: (array zero-terminated=1) (transfer none): Names of supported
* parameters.
*
* Since: 2.8
*/
PURPLE_AVAILABLE_IN_2_8
const gchar **purple_media_get_available_params(PurpleMedia *media);
/**
* purple_media_param_is_supported:
* @media: The media object
* @param: name of parameter
*
* Checks if given optional parameter is supported by the media backend.
*
* Returns: %TRUE if backend recognizes the parameter, %FALSE otherwise.
*
* Since: 2.8
*/
PURPLE_AVAILABLE_IN_2_8
gboolean purple_media_param_is_supported(PurpleMedia *media, const gchar *param);
/**
* purple_media_add_stream:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to add the stream to.
* @who: The name of the remote user to add the stream for.
* @type: The type of stream to create.
* @initiator: Whether or not the local user initiated the stream.
* @transmitter: The transmitter to use for the stream.
* @params: (element-type utf8 GObject.Value) (transfer none): The stream
* parameters to pass to Farstream.
*
* Adds a stream to a session.
*
* It only adds a stream to one audio session or video session as
* the @sess_id must be unique between sessions.
*
* Returns: %TRUE The stream was added successfully, %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_add_stream(PurpleMedia *media, const gchar *sess_id,
const gchar *who, PurpleMediaSessionType type, gboolean initiator,
const gchar *transmitter, GHashTable *params);
/**
* purple_media_get_session_type:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to get the type from.
*
* Gets the session type from a session
*
* Returns: The retrieved session type.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
PurpleMediaSessionType purple_media_get_session_type(PurpleMedia *media, const gchar *sess_id);
/**
* purple_media_get_manager:
* @media: The media object to get the manager instance from.
*
* Gets the PurpleMediaManager this media session is a part of.
*
* Returns: The PurpleMediaManager instance retrieved.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
struct _PurpleMediaManager *purple_media_get_manager(PurpleMedia *media);
/**
* purple_media_get_codecs:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to get the codecs from.
*
* Gets the codecs from a session.
*
* Returns: (element-type PurpleMediaCodec) (transfer full): The retrieved
* codecs.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GList *purple_media_get_codecs(PurpleMedia *media, const gchar *sess_id);
/**
* purple_media_add_remote_candidates:
* @media: The media object to find the session in.
* @sess_id: The session id of the session find the stream in.
* @participant: The name of the remote user to add the candidates for.
* @remote_candidates: (element-type PurpleMediaCandidate) (transfer none): The
* remote candidates to add.
*
* Adds remote candidates to the stream.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_add_remote_candidates(PurpleMedia *media,
const gchar *sess_id,
const gchar *participant,
GList *remote_candidates);
/**
* purple_media_get_local_candidates:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to find the stream in.
* @participant: The name of the remote user to get the candidates from.
*
* Gets the local candidates from a stream.
*
* Returns: (element-type PurpleMediaCandidate) (transfer full): The local
* candidates.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GList *purple_media_get_local_candidates(PurpleMedia *media,
const gchar *sess_id,
const gchar *participant);
/**
* purple_media_get_active_local_candidates:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to find the stream in.
* @participant: The name of the remote user to get the active candidate
* from.
*
* Gets the active local candidates for the stream.
*
* Returns: (element-type PurpleMediaCandidate) (transfer full): The active
* candidates retrieved.
*
* Since: 2.8
*/
PURPLE_AVAILABLE_IN_2_8
GList *purple_media_get_active_local_candidates(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
/**
* purple_media_get_active_remote_candidates:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to find the stream in.
* @participant: The name of the remote user to get the remote candidate
* from.
*
* Gets the active remote candidates for the stream.
*
* Returns: (element-type PurpleMediaCandidate) (transfer full): The remote
* candidates retrieved.
*
* Since: 2.8
*/
PURPLE_AVAILABLE_IN_2_8
GList *purple_media_get_active_remote_candidates(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
/**
* purple_media_set_remote_codecs:
* @media: The media object to find the session in.
* @sess_id: The session id of the session find the stream in.
* @participant: The name of the remote user to set the codecs for.
* @codecs: (element-type PurpleMediaCodec) (transfer none): The list of remote
* codecs to set.
*
* Sets remote codecs from the stream.
*
* Returns: %TRUE The codecs were set successfully, or %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_set_remote_codecs(PurpleMedia *media, const gchar *sess_id,
const gchar *participant, GList *codecs);
/**
* purple_media_candidates_prepared:
* @media: The media object to find the remote user in.
* @session_id: The session id of the session to check.
* @participant: The remote user to check for.
*
* Returns whether or not the candidates for set of streams are prepared
*
* Returns: %TRUE All streams for the given session_id/participant combination have candidates prepared, %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_candidates_prepared(PurpleMedia *media,
const gchar *session_id, const gchar *participant);
/**
* purple_media_set_send_codec:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to set the codec for.
* @codec: The codec to set the session to stream.
*
* Sets the send codec for the a session.
*
* Returns: %TRUE The codec was successfully changed, or %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_set_send_codec(PurpleMedia *media, const gchar *sess_id, PurpleMediaCodec *codec);
/**
* purple_media_set_encryption_parameters:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to set parameters of.
* @cipher: The cipher to use to encrypt our media in the session.
* @auth: The algorithm to use to compute authentication codes for our media
* frames.
* @key: The encryption key.
* @key_len: Byte length of the encryption key.
*
* Sets the encryption parameters of our media in the session.
*
* Returns: %TRUE if the encryption parameters were set successfully.
*
* Since: 2.11
*/
PURPLE_AVAILABLE_IN_2_11
gboolean purple_media_set_encryption_parameters(PurpleMedia *media,
const gchar *sess_id, const gchar *cipher,
const gchar *auth, const gchar *key, gsize key_len);
/**
* purple_media_set_decryption_parameters:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to set parameters of.
* @participant: The participant of the session to set parameters of.
* @cipher: The cipher to use to decrypt media coming from this session's
* participant.
* @auth: The algorithm to use for authentication of the media coming from
* the session's participant.
* @key: The decryption key.
* @key_len: Byte length of the decryption key.
*
* Sets the decryption parameters for a session participant's media.
*
* Returns: %TRUE if the decryption parameters were set successfully.
*
* Since: 2.11
*/
PURPLE_AVAILABLE_IN_2_11
gboolean purple_media_set_decryption_parameters(PurpleMedia *media,
const gchar *sess_id, const gchar *participant,
const gchar *cipher, const gchar *auth,
const gchar *key, gsize key_len);
/**
* purple_media_set_require_encryption:
* @media: The media object to find the session in.
* @sess_id: The id of the session to set parameters of.
* @participant: The participant of the session to set parameters of.
* @require_encryption: TRUE if the media requires encryption.
*
* Sets whether a session participant's media requires encryption.
*
* Returns: %TRUE if the encryption requirement was set successfully.
*
* Since: 2.14
*/
PURPLE_AVAILABLE_IN_2_14
gboolean purple_media_set_require_encryption(PurpleMedia *media,
const gchar *sess_id, const gchar *participant,
gboolean require_encryption);
/**
* purple_media_codecs_ready:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to check.
*
* Gets whether a session's codecs are ready to be used.
*
* Returns: %TRUE The codecs are ready, or %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_codecs_ready(PurpleMedia *media, const gchar *sess_id);
/**
* purple_media_set_send_rtcp_mux:
* @media: The media object to find the session in.
* @sess_id: The session id of the session find the stream in.
* @participant: The name of the remote user to set the rtcp-mux for.
* @send_rtcp_mux: Whether to enable the rtcp-mux option
*
* Sets the rtcp-mux option for the stream.
*
* Returns: %TRUE RTCP-Mux was set successfully, or %FALSE otherwise.
*
* Since: 2.11
*/
PURPLE_AVAILABLE_IN_2_11
gboolean purple_media_set_send_rtcp_mux(PurpleMedia *media,
const gchar *sess_id, const gchar *participant, gboolean send_rtcp_mux);
/**
* purple_media_is_initiator:
* @media: The media instance to find the session in.
* @sess_id: The session id of the session to check.
* @participant: The participant of the stream to check.
*
* Gets whether the local user is the conference/session/stream's initiator.
*
* Returns: TRUE if the local user is the stream's initiator, else FALSE.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_is_initiator(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
/**
* purple_media_accepted:
* @media: The media object to find the session in.
* @sess_id: The session id of the session to check.
* @participant: The participant to check.
*
* Gets whether a streams selected have been accepted.
*
* Returns: %TRUE The selected streams have been accepted, or %FALSE otherwise.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gboolean purple_media_accepted(PurpleMedia *media, const gchar *sess_id,
const gchar *participant);
/**
* purple_media_set_input_volume:
* @media: The media object the sessions are in.
* @session_id: The session to select (if any).
* @level: The level to set the volume to.
*
* Sets the input volume of all the selected sessions.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_set_input_volume(PurpleMedia *media, const gchar *session_id, double level);
/**
* purple_media_set_output_volume:
* @media: The media object the streams are in.
* @session_id: The session to limit the streams to (if any).
* @participant: The participant to limit the streams to (if any).
* @level: The level to set the volume to.
*
* Sets the output volume of all the selected streams.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_set_output_volume(PurpleMedia *media, const gchar *session_id,
const gchar *participant, double level);
/**
* purple_media_set_output_window:
* @media: The media instance to set the output window on.
* @session_id: The session to set the output window on.
* @participant: Optionally, the participant to set the output window on.
*
* Sets a video output window for the given session/stream.
*
* Returns: An id to reference the output window.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gulong purple_media_set_output_window(PurpleMedia *media,
const gchar *session_id, const gchar *participant);
/**
* purple_media_remove_output_windows:
* @media: The instance to remove all output windows from.
*
* Removes all output windows from a given media session.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_remove_output_windows(PurpleMedia *media);
/**
* purple_media_send_dtmf:
* @media: The media instance to send a DTMF signal to.
* @session_id: The session id of the session to send the DTMF signal on.
* @dtmf: The character representing the DTMF in the range [0-9#*A-D].
* @volume: The power level expressed in dBm0 after dropping the sign in the
* range of 0 to 63. A larger value represents a lower volume.
* @duration: The duration of the tone in milliseconds.
*
* Sends a DTMF signal out-of-band.
*
* Returns: %TRUE DTMF sent successfully, or %FALSE otherwise.
*
* Since: 2.11
*/
PURPLE_AVAILABLE_IN_2_11
gboolean purple_media_send_dtmf(PurpleMedia *media, const gchar *session_id,
gchar dtmf, guint8 volume, guint16 duration);
G_END_DECLS
#endif /* PURPLE_MEDIA_H */