/**
* g_mime_shutdown:
*
* Frees internally allocated tables created in g_mime_init(). Also
* calls g_mime_charset_map_shutdown() and g_mime_iconv_shutdown().
**/
void
g_mime_shutdown (void)
{
if (--initialized)
return;
g_mime_object_type_registry_shutdown ();
g_mime_charset_map_shutdown ();
g_mime_iconv_utils_shutdown ();
g_mime_iconv_shutdown ();
#ifdef G_THREADS_ENABLED
if (glib_check_version (2, 37, 4) == NULL) {
/* The implementation of g_mutex_clear() prior
* to glib 2.37.4 did not properly reset the
* internal mutex pointer to NULL, so re-initializing
* GMime would not properly re-initialize the mutexes.
**/
g_mutex_clear (&G_LOCK_NAME (iconv_cache));
g_mutex_clear (&G_LOCK_NAME (iconv_utils));
g_mutex_clear (&G_LOCK_NAME (charset));
g_mutex_clear (&G_LOCK_NAME (msgid));
}
#endif
}
/**
* g_cancellable_reset:
* @cancellable: a #GCancellable object.
*
* Resets @cancellable to its uncancelled state.
**/
void
g_cancellable_reset (GCancellable *cancellable)
{
GCancellablePrivate *priv;
g_return_if_fail (G_IS_CANCELLABLE (cancellable));
G_LOCK(cancellable);
priv = cancellable->priv;
while (priv->cancelled_running)
{
priv->cancelled_running_waiting = TRUE;
g_cond_wait (cancellable_cond,
g_static_mutex_get_mutex (& G_LOCK_NAME (cancellable)));
}
if (priv->cancelled)
{
/* Make sure we're not leaving old cancel state around */
#ifdef G_OS_WIN32
if (priv->event)
ResetEvent (priv->event);
#endif
if (priv->cancel_pipe[0] != -1)
{
gssize c;
char ch;
do
c = read (priv->cancel_pipe[0], &ch, 1);
while (c == -1 && errno == EINTR);
}
priv->cancelled = FALSE;
}
G_UNLOCK(cancellable);
}
/**
* g_cancellable_disconnect:
* @cancellable: A #GCancellable or %NULL.
* @handler_id: Handler id of the handler to be disconnected, or %0.
*
* Disconnects a handler from a cancellable instance similar to
* g_signal_handler_disconnect(). Additionally, in the event that a
* signal handler is currently running, this call will block until the
* handler has finished. Calling this function from a
* #GCancellable::cancelled signal handler will therefore result in a
* deadlock.
*
* This avoids a race condition where a thread cancels at the
* same time as the cancellable operation is finished and the
* signal handler is removed. See #GCancellable::cancelled for
* details on how to use this.
*
* If @cancellable is %NULL or @handler_id is %0 this function does
* nothing.
*
* Since: 2.22
*/
void
g_cancellable_disconnect (GCancellable *cancellable,
gulong handler_id)
{
GCancellablePrivate *priv;
if (handler_id == 0 || cancellable == NULL)
return;
G_LOCK (cancellable);
priv = cancellable->priv;
while (priv->cancelled_running)
{
priv->cancelled_running_waiting = TRUE;
g_cond_wait (cancellable_cond,
g_static_mutex_get_mutex (& G_LOCK_NAME (cancellable)));
}
g_signal_handler_disconnect (cancellable, handler_id);
G_UNLOCK (cancellable);
}
/**
* g_mime_init:
* @flags: initialization flags
*
* Initializes GMime.
*
* Note: Calls g_mime_charset_map_init() and g_mime_iconv_init() as
* well.
**/
void
g_mime_init (guint32 flags)
{
if (initialized++)
return;
#if defined (HAVE_TIMEZONE) || defined (HAVE__TIMEZONE)
/* initialize timezone */
tzset ();
#endif
enable = flags;
#if !GLIB_CHECK_VERSION(2, 35, 1)
g_type_init ();
#endif
g_mime_charset_map_init ();
g_mime_iconv_utils_init ();
g_mime_iconv_init ();
#ifdef ENABLE_SMIME
/* gpgme_check_version() initializes GpgMe */
gpgme_check_version (NULL);
#endif /* ENABLE_SMIME */
gmime_gpgme_error_quark = g_quark_from_static_string ("gmime-gpgme");
gmime_error_quark = g_quark_from_static_string ("gmime");
#ifdef G_THREADS_ENABLED
g_mutex_init (&G_LOCK_NAME (iconv_cache));
g_mutex_init (&G_LOCK_NAME (iconv_utils));
g_mutex_init (&G_LOCK_NAME (charset));
g_mutex_init (&G_LOCK_NAME (msgid));
#endif
/* register our GObject types with the GType system */
g_mime_crypto_context_get_type ();
g_mime_decrypt_result_get_type ();
g_mime_certificate_list_get_type ();
g_mime_signature_list_get_type ();
g_mime_certificate_get_type ();
g_mime_signature_get_type ();
#ifdef ENABLE_CRYPTOGRAPHY
g_mime_gpg_context_get_type ();
g_mime_pkcs7_context_get_type ();
#endif
g_mime_filter_get_type ();
g_mime_filter_basic_get_type ();
g_mime_filter_best_get_type ();
g_mime_filter_charset_get_type ();
g_mime_filter_crlf_get_type ();
g_mime_filter_enriched_get_type ();
g_mime_filter_from_get_type ();
g_mime_filter_gzip_get_type ();
g_mime_filter_html_get_type ();
g_mime_filter_md5_get_type ();
g_mime_filter_strip_get_type ();
g_mime_filter_windows_get_type ();
g_mime_filter_yenc_get_type ();
g_mime_stream_get_type ();
g_mime_stream_buffer_get_type ();
g_mime_stream_cat_get_type ();
g_mime_stream_file_get_type ();
g_mime_stream_filter_get_type ();
g_mime_stream_fs_get_type ();
g_mime_stream_gio_get_type ();
g_mime_stream_mem_get_type ();
g_mime_stream_mmap_get_type ();
g_mime_stream_null_get_type ();
g_mime_stream_pipe_get_type ();
g_mime_parser_get_type ();
g_mime_message_get_type ();
g_mime_data_wrapper_get_type ();
g_mime_content_type_get_type ();
g_mime_content_disposition_get_type ();
internet_address_get_type ();
internet_address_list_get_type ();
internet_address_group_get_type ();
internet_address_mailbox_get_type ();
/* register our default mime object types */
g_mime_object_type_registry_init ();
g_mime_object_register_type ("*", "*", g_mime_part_get_type ());
g_mime_object_register_type ("multipart", "*", g_mime_multipart_get_type ());
g_mime_object_register_type ("multipart", "encrypted", g_mime_multipart_encrypted_get_type ());
g_mime_object_register_type ("multipart", "signed", g_mime_multipart_signed_get_type ());
g_mime_object_register_type ("message", "rfc822", g_mime_message_part_get_type ());
g_mime_object_register_type ("message", "rfc2822", g_mime_message_part_get_type ());
g_mime_object_register_type ("message", "news", g_mime_message_part_get_type ());
g_mime_object_register_type ("message", "partial", g_mime_message_partial_get_type ());
}