The "capabilities" property is a comma-separated list of capabilities supported by the backend. The preferred method of retrieving and working with capabilities is e_client_get_capabilities() and e_client_check_capability().
The "online" property is "TRUE" when the client is fully opened and online, "FALSE" at all other times. See also e_client_is_online().
The "opened" property is "TRUE" when the client is fully opened, "FALSE" at all other times.
The "opening" property is "TRUE" when the client is in the process of opening, "FALSE" at all other times.
The "online" property is "TRUE" if the backend has only read access to its data, "FALSE" if the backend can modify its data. See also e_client_is_readonly().
The current overall revision string, this can be used as a quick check to see if data has changed at all since the last time the revision was observed.
The major version number of the Evolution-Data-Server library. Like eds_major_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
The micro version number of the Evolution-Data-Server library. Like eds_micro_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
The minor version number of the Evolution-Data-Server library. Like eds_minor_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
A special name, which can be used as a GIO name in the call to e_network_monitor_set_gio_name(), which is used to report the network as always reachable.
A name of the named parameter used for passwords in credentials, used to authenticate users with e_source_invoke_authenticate_sync() and e_source_invoke_authenticate(). The named parameter is optional, different authentication methods can use different names.
A name of the named parameter used for SSL/TLS trust in credentials, used to authenticate users with e_source_invoke_authenticate_sync() and e_source_invoke_authenticate(). The named parameter is optional. Its value corresponds to current ESourceWebdav::ssl-trust property, in case the ESource has that extension available. This is required to have up-to-date data on the server side, when the client side just saved the SSL trust change, which might not be propagated into the server (factory) side quickly enough. The key is added into the credentials in e_source_invoke_authenticate() automatically, if the corresponding ESource contain a WebDAV extension and the key is not part of the credentials already.
A name of the named parameter used for usernames in credentials, used to authenticate users with e_source_invoke_authenticate_sync() and e_source_invoke_authenticate(). The named parameter is optional, different authentication methods can use different names.
Pass this extension name to e_source_get_extension() to access #ESourceAddressBook. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceAlarms. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceAuthentication. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceAutocomplete. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceAutoconfig. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceCalendar. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceCollection. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceContacts. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceGoa. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceLDAP. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceLocal. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailAccount. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailComposition. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailIdentity. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailSignature. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailSubmission. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMailTransport. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMDN. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceMemoList. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceOffline. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceOpenPGP. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceProxy. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceRefresh. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceResource. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceRevisionGuards. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceSecurity. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceSMIME. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceTaskList. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceUoa. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceWeather. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceWebdav. This is also used as a group name in key files.
Pass this extension name to e_source_get_extension() to access #ESourceWebDAVNotes. This is also used as a group name in key files.
Extends #GParamFlags to indicate the #GObject property is associated with a key file value. Use this flag when installing #GObject properties in #ESourceExtension subclasses.
Thread safe variant of g_object_bind_property(). See its documentation for more information on arguments and return value.
the source #GObject
the property on source to bind
the target #GObject
the property on target to bind
flags to pass to #GBinding
Thread safe variant of g_object_bind_property_with_closures(). See its documentation for more information on arguments and return value.
the source #GObject
the property on source to bind
the target #GObject
the property on target to bind
flags to pass to #GBinding
a #GClosure wrapping the transformation function from the source to the target, or %NULL to use the default
a #GClosure wrapping the transformation function from the target to the source, or %NULL to use the default
Transforms an enumeration nickname to its corresponding value.
a #GBinding
a #GValue of type #G_TYPE_STRING
a #GValue whose type is derived from #G_TYPE_ENUM
not used
Transforms an enumeration value to its corresponding nickname.
a #GBinding
a #GValue whose type is derived from #G_TYPE_ENUM
a #GValue of type #G_TYPE_STRING
not used
Adds a new category, with its corresponding icon, to the configuration database.
This function is thread safe.
name of category to add.
DEPRECATED! associated color. DEPRECATED!
full path of the icon associated to the category.
whether the category can be used for searching in the GUI.
Gets the icon file associated with the given category and returns a copy of it.
This function is thread safe.
category to retrieve the icon file for.
Returns a sorted list of all the category names currently configured.
This function is thread safe.
Checks whether the given category is available in the configuration.
This function is thread safe.
category to be searched.
Gets the icon file associated with the given category.
This function is mostly thread safe, but as the icon file name is not copied, it may be freed by another thread after being returned by this function. Use e_categories_dup_icon_file_for() instead.
category to retrieve the icon file for.
Returns a sorted list of all the category names currently configured.
This function is mostly thread safe, but as the category names are not copied, they may be freed by another thread after being returned by this function. Use e_categories_dup_list() instead.
Gets whether the given calendar is to be used for searches in the GUI.
This function is thread safe.
Return value; %TRUE% if the category is searchable, %FALSE% if not.
category name.
Registers callback to be called on change of any category.
Pair listener and user_data is used to distinguish between listeners.
Listeners can be unregistered with e_categories_unregister_change_listener.
This function is thread safe.
Removes the given category from the configuration.
This function is thread safe.
category to be removed.
Sets the icon file associated with the given category.
This function is thread safe.
category to set the icon file for.
icon file.
Returns the value set by e_data_server_util_set_dbus_call_timeout().
Sets default timeout, in milliseconds, for calls of g_dbus_proxy_call() family functions.
-1 means the default value as set by D-Bus itself. G_MAXINT means no timeout at all.
Default value is set also by configure option --with-dbus-call-timeout=ms and -1 is used when not set.
default timeout for D-Bus calls in miliseconds
Disables all domains from the domains array.
an array of domains to disable
Saves current log information to the given filename.
a filename to save logged information to
Saves current log information to a file "e-debug-log-YYYY-MM-DD-HH-mm-ss.txt" in the user's HOME directory.
Enables all domains from the domains array.
an array of domains to enable
Loads configuration for the logging from the given filename.
a configuration file name
Limits how many lines the log can have.
number of lines
Checks that the Evolution-Data-Server library in use is compatible with the given version. Generally you would pass in the constants #EDS_MAJOR_VERSION, #EDS_MINOR_VERSION, #EDS_MICRO_VERSION as the three arguments to this function. That produces a check that the library in use is compatible with the version of Evolution-Data-Server the application or module was compiled against.
the required major version
the required minor version
the required micro version
Fetches the appropriate enumeration value for string in the given
enum type type and stores the result in enum_value
The enum type
The string containing the enum value or nick
A return location to store the result
Converts an enum value to a string using strings from the GType system.
An enum type
The enum value to convert
Asynchronously deletes file. If file is a directory, its contents
are deleted recursively before file itself is deleted. The recursive
delete operation will stop on the first error.
If cancellable is not %NULL, then the operation can be cancelled
by triggering the cancellable object before the operation finishes.
When the operation is finished, callback will be called. You can then
call e_file_recursive_delete_finish() to get the result of the operation.
a #GFile to delete
the I/O priority of the request
optional #GCancellable object, or %NULL
a #GAsyncReadyCallback to call when the request is satisfied
Finishes the operation started with e_file_recursive_delete().
If the operation was cancelled, the error #G_IO_ERROR_CANCELLED will be returned.
a #GFile to delete
a #GAsyncResult
Deletes file. If file is a directory, its contents are deleted
recursively before file itself is deleted. The recursive delete
operation will stop on the first error.
If cancellable is not %NULL, then the operation can be cancelled
by triggering the cancellable object from another thread. If the
operation was cancelled, the error #G_IO_ERROR_CANCELLED will be
returned.
a #GFile to delete
optional #GCancellable object, or %NULL
Creates a local path constructed from basepath / fileprefix + "-" + filename,
and makes sure the path basepath exists. If creation of
the path fails, then NULL is returned.
base path of a file name; this is left unchanged
prefix for the filename; this is encoded
file name to use; this is encoded; can be %NULL
used when filename is NULL, then the filename is generated as "file" + fileindex
Converts the free_form_exp to an S-Expression using the S-Expression
builders defined in the symbols. The symbols should have one symbol
with an empty string as its name, which is used for words which do not
have a symbol name prefix.
The symbols is a NULL-terminated array of known symbols. The NULL should
be set for the symbol's name.
a Free Form Expression
known symbols, which can be used in the Free From Expression
Returns a base directory in which to store user-specific, non-essential cached data for Evolution or Evolution-Data-Server.
The returned string is owned by libedataserver and must not be modified or freed.
Returns a base directory in which to store user-specific configuration information for Evolution or Evolution-Data-Server.
The returned string is owned by libedataserver and must not be modified or freed.
Returns a base directory in which to store user-specific data for Evolution or Evolution-Data-Server.
The returned string is owned by libedataserver and must not be modified or freed.
Converts the calendar time time representation tt to a broken-down
time representation, store in tm, and provides the offset in
seconds from UTC time, stored in offset.
The #time_t to convert.
The #tm to store the result in.
The #int to store the offset in.
Like mktime(3), but assumes UTC instead of local timezone.
The #tm to convert to a calendar time representation.
Sets value for name to form. The form should be
the one used in e_oauth2_service_prepare_authentication_uri_query(),
e_oauth2_service_prepare_get_token_form() or
e_oauth2_service_prepare_refresh_token_form().
If the value is %NULL, then the property named name is removed
from the form instead.
a #GHashTable
a property name
a property value
Takes ownership of value and sets it for name to form. The value
will be freed with g_free(), when no longer needed. The form should be
the one used in e_oauth2_service_prepare_authentication_uri_query(),
e_oauth2_service_prepare_get_token_form() or
e_oauth2_service_prepare_refresh_token_form().
If the value is %NULL, then the property named name is removed
from the form instead.
a #GHashTable
a property name
a property value
Deletes the secret for uid from either the default keyring or
session keyring.
Note the boolean return value indicates whether the delete operation
itself completed successfully, not whether the secret was found and
deleted. If no such secret was found, the function will still return
%TRUE. If an error occurs, the function sets error and returns %FALSE.
a unique identifier of the secret
optional #GCancellable object, or %NULL
Looks up a secret for the uid. Both the default and session keyrings
are queried.
Note the boolean return value indicates whether the lookup operation
itself completed successfully, not whether the secret was found. If
no secret was found, the function will set out_secret to %NULL,
but still return %TRUE. If an error occurs, the function sets error
and returns %FALSE.
a unique identifier of the secret
optional #GCancellable object, or %NULL
Stores the secret for the uid.
If permanently is %TRUE, the secret is stored in the default keyring.
Otherwise the secret is stored in the memory-only session keyring. If
an error occurs, the function sets error and returns %FALSE.
a unique identifier of the secret
the secret to store
human readable description of the secret
store permanently or just for the session
optional #GCancellable object, or %NULL
Remembers what had been read from the input_stream and prints it
to stdout when the message is finished. The function assumes
ownership of the input_stream.
a #SoupMessage
a #GInputStream, associated with the message
Sets up automatic SSL certificate trust handling for soup_message using the trust
data stored in source's WebDAV extension. If soup_message is about to be sent on
an SSL connection with an invalid certificate, the code checks if the WebDAV
extension already has a trust response for that certificate and verifies it
with e_source_webdav_verify_ssl_trust(). If the verification fails, then
the soup_message send also fails.
This works by connecting to the "network-event" signal on soup_message and
connecting to the "accept-certificate" signal on each #GTlsConnection for
which soup_message reports a #G_SOCKET_CLIENT_TLS_HANDSHAKING event. These
handlers are torn down automatically when soup_message is disposed. This process
is not thread-safe; it is sufficient for safety if all use of soup_message's
session and the disposal of soup_message occur in the same thread.
a #SoupMessage about to be sent to the source
an #ESource that uses WebDAV
This function is a wrapper around the strftime (3) function, which converts the %l and %k (12h and 24h) format variables if necessary.
The string array to store the result in.
The size of array s.
The formatting to use on tm.
The time value to format.
Creates a string representation of the time value date_tm and
stores it in buffer. buffer_size should be at least 64 to be
safe. If show_midnight is %FALSE, and the time is midnight, then
only the date is stored in buffer. If show_zero_seconds is
%FALSE, then if the time has zero seconds only the hour and minute
of the time are stored in buffer.
The #tm to convert to a string.
A #gboolean.
A #gboolean.
A #gboolean.
A #char buffer to store the time string in.
The length of buffer.
Creates a string representation of a time value in date_tm and
stores it in buffer. buffer_size should be at least 64.
The #tm to convert to a string.
A #gboolean.
A #gboolean.
The #char buffer to store the result in.
The length of buffer.
Retrieves a date format string with a 4-digit year (D_FMT on systems with nl_langinfo() available). In case the current locale doesn't support 4-digit year, the function returns format as specified by the locale.
Free the returned string with g_free().
Takes in a date string entered by the user and tries to convert it to a struct #tm.
A date string.
Return value for the parsed date.
Parses a string value containing a date and a time and stores the
result in result. The date in value is expected to be in a format
like "Wed 3/13/00 14:20:00", though gettext() is used to support the
appropriate local formats. There is also some leniency on the
format of the string, e.g. the weekday can be skipped or 12-hour
formats with am/pm can be used.
the string to parse a date and time from
a #tm to store the result in
Parses a string value containing a date and a time and stores the
result in result. The date in value is expected to be in a format
like "Wed 3/13/00 14:20:00", though gettext() is used to support the
appropriate local formats. There is also some leniency on the
format of the string, e.g. the weekday can be skipped or 12-hour
formats with am/pm can be used.
The string to parse a date and time from.
A #tm to store the result in.
set to TRUE, is parsing with two-digit year, else FALSE, but only when not NULL.
Takes in a date string entered by the user and tries to convert it to a struct #tm.
A date string.
Return value for the parsed date.
set to TRUE, is parsing with two-digit year, else FALSE, but only when not NULL.
Parses value, a string containing a time. value is expected to be
in a format like "14:20:00". gettext() is used to
support the appropriate local formats and slightly
different formats, such as 12-hour formats with am/pm,
are accepted as well.
The string to parse a time from.
A #tm to store the result in.
Similar to g_timeout_add_seconds_full(), but also names the #GSource as
name.
You might find e_named_timeout_add_seconds() or e_named_timeout_add_seconds_full() more convenient. Those macros name the #GSource implicitly.
the priority of the timeout source, typically in the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH
the time between calls to the function, in seconds
debug name for the source
function to call
Similar to g_timeout_add_full(), but also names the #GSource as name.
You might find e_named_timeout_add() or e_named_timeout_add_full() more convenient. Those macros name the #GSource implicitly.
the priority of the timeout source, typically in the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH
the time between calls to the function, in milliseconds (1/1000ths of a second)
debug name for the source
function to call
Calls func for all instantiable subtypes of parent_type.
This is often useful for extending functionality by way of #EModule.
A module may register a subtype of parent_type in its e_module_load()
function. Then later on the application will call e_type_traverse()
to instantiate all registered subtypes of parent_type.
the root #GType to traverse from
the function to call for each visited #GType
Generate a new unique string for use e.g. in account lists.
The UTF-8 equivalent of e_strftime ().
The string array to store the result in.
The size of array s.
The formatting to use on tm.
The time value to format.
Checks whether the collection_source can be used as a credential source
for the child_source. The relationship is not tested in the function.
When the collection_source is %NULL, then it simply returns %FALSE.
a collection #ESource, or %NULL
a children of collection_source
Copies #GSList of strings at the end of copy_to.
Where to copy; can be %NULL
#GSList of strings to be copied
If str is a valid UTF-8 string, the function returns str and does
not set gdbus_str.
If str is an invalid UTF-8 string, the function calls
e_util_utf8_make_valid() and points gdbus_str to the newly-allocated,
valid UTF-8 string, and also returns it. The caller should free the
string pointed to by gdbus_str with g_free().
If str is %NULL, the function returns an empty string and does not
set gdbus_str.
Admittedly, the function semantics are a little awkward. The example
below illustrates the easiest way to cope with the gdbus_str argument:
|[ const gchar *trusted_utf8; gchar *allocated = NULL;
trusted_utf8 = e_util_ensure_gdbus_string (untrusted_utf8, &allocated);
Do stuff with trusted_utf8, then clear it.
trusted_utf8 = NULL;
g_free (allocated);
allocated = NULL;
@param str a possibly invalid UTF-8 string, or %NULL
@param gdbusStr return location for the corrected string
Frees memory previously allocated by e_util_strv_to_slist().
a #GSList of strings (gchar *)
Generates a unique identificator, which can be used as part of the Message-ID header, or iCalendar component UID, or vCard UID. The resulting string doesn't contain any host name, it's a hexa-decimal string with no particular meaning.
Free the returned string with g_free(), when no longer needed.
The main_path is a directory, which will be always used. It
should have as its prefix the replace_prefix, otherwise
the function returns only the main_path in the paths array.
When there's exported an environment variable EDS_EXTRA_PREFIXES,
it is used as a list of alternative prefixes where to look for
the main_path (rest after the replace_prefix).
When the with_modules_dir is %TRUE, there's also added
g_get_user_data_dir() + "evolution/modules/", aka
~/.local/share/evolution/modules/, into the resulting array.
the main path to work with
path prefix to replace
whether to add also the modules directory
Constructs a full name of the source with all of its parents
of the form: "<account-name> : <parent>/<source>" where
the "<parent>/" part can be repeated zero or more times, depending
on the deep level of the source.
an #ESourceRegistry
an #ESource
Returns a 64-bit integer hopefully uniquely identifying the thread. To be used in debugging output and logging only. The returned value is just a cast of a pointer to the 64-bit integer.
There is no guarantee that calling e_util_gthread_id () on one thread first and later after that thread has dies on another won't return the same integer.
On Linux and Win32, known to really return a unique id for each thread existing at a certain time. No guarantee that ids won't be reused after a thread has terminated, though.
A #GThread pointer
Checks whether the identity_source can be used for sending, which means
whether it has configures send mail source.
an #ESourceRegistry
an #ESource with mail identity extension
Calls g_free() on string, but before it rewrites its content with zeros.
This is suitable to free strings with passwords.
a string to free
Convert list of strings into NULL-terminates array of strings.
a #GSList of strings (const gchar *)
Compares two #ESource-s in a way suitable for user interface. It can be used as a #GCompareFunc.
This is also used by e_source_registry_build_display_tree().
the first #ESource
the second #ESource
Compares str1 and str2 like g_strcmp0(), except it handles %NULL and
empty strings as equal.
a C string on %NULL
another C string or %NULL
Duplicates string and strips off any leading or trailing whitespace.
The resulting string is returned unless it is empty or %NULL, in which
case the function returns %NULL.
Free the returned string with g_free().
a string value, or %NULL
Find the first instance of needle in haystack, ignoring case for
bytes that are ASCII characters.
The string to search in.
The string to search for.
Compares v1 and v2 for equality, handling %NULL gracefully.
The arguments types are generic for compatibility with #GEqualFunc.
a %NULL-terminated string array, or %NULL
another %NULL-terminated string array, or %NULL
Convert NULL-terminated array of strings to a list of strings.
a NULL-terminated array of strings (const gchar *)
Get a UTF-8 character from the beginning of text.
The string to take the UTF-8 character from.
The location to store the UTF-8 character in.
Unrefs the given object in a dedicated thread. This is useful when unreffing
object deep in call stack when the caller might still use the object and
this being the last reference to it.
a #GObject
Returns a newly-allocated NULL-terminated string with invalid characters
replaced by Unicode replacement characters (U+FFFD).
For %NULL data returns newly allocated empty string ("").
UTF-8 binary data
length of the binary data
Converts the text into a decomposed variant and strips it, which
allows also cheap case insensitive comparision afterwards. This
produces an output as being used in e_util_utf8_strstrcasedecomp().
a UTF-8 string
Returns a newly-allocated copy of str, with invalid characters
replaced by Unicode replacement characters (U+FFFD).
For %NULL str returns newly allocated empty string ("").
a UTF-8 string
Normalizes str by making it all lower case and removing any accents from it.
a UTF-8 string
Returns a newly-allocated copy of str with accents removed.
a UTF-8 string, or %NULL
Compares two UTF-8 strings using approximate case-insensitive ordering.
a UTF-8 string
another UTF-8 string
Find the first instance of needle in haystack, ignoring case. (No
proper case folding or decomposing is done.) Both needle and
haystack are UTF-8 strings.
The string to search in.
The string to search for.
Find the first instance of needle in haystack, where both needle
and haystack are UTF-8 strings. Both strings are stripped and
decomposed for comparison, and case is ignored.
The string to search in.
The string to search for.
Frees an #EWebDAVAccessControlEntry previously created with e_webdav_access_control_entry_new()
or e_webdav_access_control_entry_copy(). The function does nothing, if ptr is %NULL.
an #EWebDAVAccessControlEntry
Frees a GSList of discovered sources returned from
e_webdav_discover_sources_finish() or e_webdav_discover_sources_sync().
A #GSList of discovered sources
Asynchronously runs discovery of the WebDAV sources (CalDAV and CardDAV), eventually
limited by the only_supports filter, which can be %E_WEBDAV_DISCOVER_SUPPORTS_NONE
to search all types. Note that the list of returned calendars can be more general,
thus check for its actual support type for further filtering of the results.
The url_use_path can be used to override actual server path, or even complete URL,
for the given source.
When the operation is finished, callback will be called. You can then
call e_webdav_discover_sources_finish() to get the result of the operation.
an #ESource from which to take connection details
optional URL override, or %NULL
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search
credentials to use for authentication to the server
optional #GCancellable object, or %NULL
a #GAsyncReadyCallback to call when the request is satisfied
Finishes the operation started with e_webdav_discover_sources(). If an
error occurred, the function will set error and return %FALSE. The function
can return success and no discovered sources, the same as it can return failure,
but still set some output arguments, like the certificate related output
arguments with SOUP_STATUS_SSL_FAILED error.
The return value of out_certificate_pem should be freed with g_free()
when no longer needed.
The return value of out_discovered_sources should be freed
with e_webdav_discover_free_discovered_sources() when no longer needed.
The return value of out_calendar_user_addresses should be freed
with g_slist_free_full (calendar_user_addresses, g_free); when
no longer needed.
an #ESource on which the operation was started
a #GAsyncResult
This is the same as e_webdav_discover_sources(), it only allows to provide a callback function (with its user_data), to reference an additional #ESource. It's good to avoid creating its own #ESourceRegistry instance to get it.
When the operation is finished, callback will be called. You can then
call e_webdav_discover_sources_finish() to get the result of the operation.
an #ESource from which to take connection details
optional URL override, or %NULL
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search
credentials to use for authentication to the server
optional callback to use to get an ESource
optional #GCancellable object, or %NULL
a #GAsyncReadyCallback to call when the request is satisfied
This is the same as e_webdav_discover_sources_sync(), it only allows to provide a callback function (with its user_data), to reference an additional #ESource. It's good to avoid creating its own #ESourceRegistry instance to get it.
an #ESource from which to take connection details
optional URL override, or %NULL
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search
credentials to use for authentication to the server
optional callback to use to get an ESource
optional #GCancellable object, or %NULL
Synchronously runs discovery of the WebDAV sources (CalDAV and CardDAV), eventually
limited by the only_supports filter, which can be %E_WEBDAV_DISCOVER_SUPPORTS_NONE
to search all types. Note that the list of returned calendars can be more general,
thus check for its actual support type for further filtering of the results.
The url_use_path can be used to override actual server path, or even complete URL,
for the given source.
If an error occurred, the function will set error and return %FALSE. The function
can return success and no discovered sources, the same as it can return failure,
but still set some output arguments, like the certificate related output
arguments with SOUP_STATUS_SSL_FAILED error.
The return value of out_certificate_pem should be freed with g_free()
when no longer needed.
The return value of out_discovered_sources should be freed
with e_webdav_discover_free_discovered_sources() when no longer needed.
The return value of out_calendar_user_addresses should be freed
with g_slist_free_full (calendar_user_addresses, g_free); when
no longer needed.
an #ESource from which to take connection details
optional URL override, or %NULL
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search
credentials to use for authentication to the server
optional #GCancellable object, or %NULL
Frees an #EWebDAVPrivilege previously created with e_webdav_privilege_new()
or e_webdav_privilege_copy(). The function does nothing, if ptr is %NULL.
an #EWebDAVPrivilege
Frees an #EWebDAVPropertyChange previously created with e_webdav_property_change_new_set(),
e_webdav_property_change_new_remove() or or e_webdav_property_change_copy().
The function does nothing, if ptr is %NULL.
an #EWebDAVPropertyChange
Frees an #EWebDAVResource previously created with e_webdav_resource_new()
or e_webdav_resource_copy(). The function does nothing, if ptr is %NULL.
an #EWebDAVResource
Frees the memory used by hash and its contents.
the #GHashTable to destroy
Creates a #GHashTable representation of the #xmlDoc doc.
If type is * E_XML_HASH_TYPE_PROPERTY, all XML nodes will be
indexed in the #GHashTable by name. If type is
%E_XML_HASH_TYPE_OBJECT_UID, then XML objects will be indexed in
the hash by their UID (other nodes will still be indexed by name).
The #xmlDoc to store in a hash table.
The value type to use as a key in the hash table.
Adds a new key/value pair to the #EXmlHash hash.
the #EXmlHash to add an entry to
the key to use for the entry
the value of the new entry
Compares the value with key equal to key in hash against
compare_data.
the #EXmlHash to compare against
the key of the hash entry to compare with
the data to compare against the hash entry
Frees the memory associated with hash.
The #EXmlHash to destroy.
Executes func against each key/value pair in hash.
an #EXmlHash
the #EXmlHashFunc to execute on the data in hash
Calls g_hash_table_foreach_remove() on hash<!-- -->'s internal hash
table. See g_hash_table_foreach_remove() for details.
an #EXmlHash
the #EXmlHashFunc to execute on the data in hash
Remove the entry in hash with key equal to key, if it exists.
the #EXmlHash to remove an entry from
the key of the entry to remove
Writes the XML represented by hash to the file originally passed
to e_xmlhash_new().
The #EXmlHash to write.
The "cache-dir" property indicates the backend's local directory for cached data.