Camel – 1.2

since: 2.24

Contains only private data that should be read and manipulated using the functions below.

since: 3.4

since: 2.24

Contains only private data that should be read and manipulated using the functions below.

since: 3.2

Contains only private data that should be read and manipulated using the functions below.

since: 3.2

since: 3.4

Contains only private data that should be read and manipulated using the functions below.

since: 3.2

Contains only private data that should be read and manipulated using the functions below.

since: 3.6

Contains only private data that should be read and manipulated using the functions below.

since: 3.6

Contains only private data that should be read and manipulated using the functions below.

since: 3.6

since: 3.2

since: 3.2

since: 3.2

since: 3.2

Contains only private data that should be read and manipulated using the functions below.

since: 3.12

Values to store/load for single folder’s CamelFolderSummary structure.

since: 2.24

since: 2.24

An opaque structure holding information about a user key.

since: 3.50

since: 3.4

since: 2.32

The extensive DB format, supporting basic searching and sorting.

since: 2.24

since: 2.24

since: 2.24

since: 3.24

since: 3.24

since: 3.2

since: 3.4

Describes a function or a variable symbol.

since: 3.4

since: 3.4

A trie data structure.

since: 2.24

Authentication result codes used by CamelService.

since: 3.4

since: 3.50

Declares the compare type to use.

since: 3.24

since: 3.44

An enum of all the known columns, which can be used for a quick column lookups.

since: 3.4

Describes what headers to fetch when downloading message summaries.

since: 3.2

since: 3.4

GPG key trust levels.

since: 3.50

These are result codes used when passing messages through a junk filter.

since: 2.32

Methods for establishing an encrypted (or unencrypted) network connection.

since: 3.2

Connection status returned by camel_service_get_connection_status().

since: 3.6

Defines type of a CamelSExpResult.

since: 3.4

Defines type of a CamelSExpTerm and partly also CamelSExpSymbol.

since: 3.4

Determines the direction of a sort.

since: 3.2

Describes a three-state value, which can be either Off, On or Inconsistent.

since: 3.22

Declares time unit, which serves to interpret the time value, like in CamelOfflineSettings.

since: 3.24

These flags are abstractions. It’s up to the CamelProvider to give them suitable interpretations. Use #CAMEL_FOLDER_TYPE_MASK to isolate the folder’s type.

Flags for converting text/plain content into text/html.

These flags extend GParamFlags. Most of the time you will use them in conjunction with g_object_class_install_property().

since: 2.32

Flags used to camel_session_get_recipient_certificates_sync() call.

since: 3.30

Open mode for folder.

since: 2.32

since: 2.32

since: 2.32

since: 2.32

A callback called for each found file in the cache, used by camel_data_cache_foreach_remove(). The filename corresponds to the result of camel_data_cache_get_filename().

since: 3.26

A collation callback function.

since: 2.24

A callback called for the SELECT statements. The items at the same index of colvalues and colnames correspond to each other.

since: 2.24

A callback prototype for camel_vee_data_cache_foreach_message_info_data()

Callback used to traverse parts of the message using camel_mime_message_foreach_part().

since: 3.34

A custom function to generate preview text for the content of the part. The part can be either a CamelMimePart or a CamelMultipart, depending in which context it is called.

since: 3.52

This is the callback signature for camel_message_content_info_traverse().

since: 3.36

Function used in camel_provider_auto_detect().

This is the callback signature for jobs submitted to the CamelSession via camel_session_submit_job(). The error pointer is always non-NULL, so it’s safe to dereference to check if a GError has been set.

since: 3.2

Callback type for function symbols used with camel_sexp_add_function().

since: 3.4

Callback type for function symbols used with camel_sexp_add_ifunction().

since: 3.4

Thread safe variant of g_object_bind_property(). See its documentation for more information on arguments and return value.

since: 3.16

Thread safe variant of g_object_bind_property_full(). See its documentation for more information on arguments and return value.

since: 3.16

Thread safe variant of g_object_bind_property_with_closures(). See its documentation for more information on arguments and return value.

since: 3.16

since: 3.22

Writes a part to a stream in a canonicalised format, suitable for signing/encrypting.

Gets a named property name value for the given cert_info.

since: 3.22

Sets a named property name value value for the given cert_info. If the value is NULL, then the property is removed. With a non-NULL value also value_free and value_clone functions cannot be NULL.

since: 3.22

Check to see if a debug mode is activated. mode takes one of two forms, a fully qualified ‘module:target’, or a wildcard ‘module’ name. It returns a boolean to indicate if the module or module and target is currently activated for debug output.

Demangles bt, possibly got from camel_debug_get_raw_backtrace(), by replacing addresses with actual function calls and eventually line numbers, if available. It modifies lines of bt, but skips those it cannot parse.

since: 3.30

Call this when you’re done with your debug output. If and only if you called camel_debug_start, and if it returns TRUE.

Gets current backtrace leading to this function call and demangles it.

since: 3.12

Gets current raw backtrace leading to this function call. This is quicker than camel_debug_get_backtrace(), because it doesn’t demangle the backtrace. To demangle it (replace addresses with actual function calls and eventually line numbers, if available) call camel_debug_demangle_backtrace().

since: 3.30

Init camel debug.

Prints current backtraces stored with camel_debug_ref_unref_push_backtrace() or with camel_debug_ref_unref_push_backtrace_for_object().

since: 3.20

Adds this backtrace into the set of backtraces related to some object reference counting issues debugging. This is usually called inside g_object_ref() and g_object_unref(). If the backtrace corresponds to a g_object_unref() call, and a corresponding g_object_ref() backtrace is found in the current list, then the previous backtrace is removed and this one is skipped.

since: 3.20

Gets current backtrace of this call and adds it to the list of backtraces with camel_debug_ref_unref_push_backtrace().

since: 3.20

Start debug output for a given mode, used to make sure debug output is output atomically and not interspersed with unrelated stuff.

Convert in from text/plain into text/enriched or text/richtext based on flags.

Retrieve a gint32.

Decode a normal string from the input file.

Decode a gint64 type.

since: 3.50

Decode an gsize type.

Decode an off_t type.

Decode a normal string from the input file.

Decode a time_t value.

Retrieve an encoded uint32 from a file.

Encode a gint32, performing no compression, but converting to network order.

Encode a normal string and save it in the output file. Unlike camel_file_util_encode_string, it pads the str with “NULL” bytes, if len is > strlen(str)

Encode a gint64 type.

since: 3.50

Encode an gsize type.

Encode an off_t type.

Encode a normal string and save it in the output file.

Encode a time_t value to the file.

Utility function to save an uint32 to a file.

‘Flattens’ name into a safe filename string by hex encoding any chars that may cause problems on the filesystem.

Builds a pathname where the basename is of the form “.#” + the basename of filename, for instance used in a two-stage commit file write.

Frees a structure returned with camel_getaddrinfo(). It does nothing when the host is NULL.

since: 2.22

Resolves a host name and returns an information about its address.

since: 2.22

Extract a content-id from in.

Decodes the rfc822 date string and saves the GMT offset into tz_offset if non-NULL.

Extracts an integer token from in and updates the pointer to point to after the end of the integer token (sort of like strtol).

Decodes rfc2047 encoded-word tokens.

Encodes a ‘phrase’ header according to the rules in rfc2047.

Encodes a ‘text’ header according to the rules of rfc2047.

Decodes a header which contains rfc2047 encoded-word tokens that may or may not be within a comment.

Allocates a string buffer containing the rfc822 formatted date string represented by time and tz_offset.

Extract a message-id token from in.

Either the domain is used, or the user’s local hostname, in case it’s NULL or empty.

Searches params for a param named name and gets the value.

Generate a list of references, from most recent up.

Set a parameter in the list.

Gets the first token in the string according to the rules of rfc0822.

Searches for a mailing list information among known headers and returns a newly allocated string with its value.

Converts IDN (Internationalized Domain Name) into ASCII representation. If there’s a failure or the host has only ASCII letters, then a copy of host is returned.

since: 3.16

Check whether the hostname host is equal to or a subdomain of domain. Both host and domain are UTF-8 strings and can be IDNs (which will be punycode-encoded for comparison).

since: 3.54

Check whether the hostname requires conversion to ASCII. That can be when a character in it can look like an ASCII character, even it being a Unicode letter. This can be used to display host names in a way of invulnerable to IDN homograph attacks.

since: 3.44

Converts the calendar time representation tt to a broken-down time representation, stored in tm, and provides the offset in seconds from UTC time, stored in offset.

Create an exclusive lock using .lock semantics. All locks are equivalent to write locks (exclusive).

Create a lock using fcntl(2).

Create a lock using flock(2).

Attempt to lock a folder, multiple attempts will be made using all locking strategies available.

Allocate a new atom size block of memory from a CamelMemChunk. Free the returned atom with camel_memchunk_free().

since: 3.4

Allocate a new atom size block of memory from a CamelMemChunk, and fill the memory with zeros. Free the returned atom with camel_memchunk_free().

since: 3.4

Scan all empty blocks and check for blocks which can be free’d back to the system.

since: 3.4

Free the memchunk header, and all associated memory.

since: 3.4

Clean out the memchunk buffers. Marks all allocated memory as free blocks, but does not give it back to the system. Can be used if the memchunk is to be used repeatedly.

since: 3.4

Free a single atom back to the free pool of atoms in the given memchunk.

since: 3.4

Create a new CamelMemChunk header. Memchunks are an efficient way to allocate and deallocate identical sized blocks of memory quickly, and space efficiently.

since: 3.4

Allocate a new data block in the mempool. Size will be rounded up to the mempool’s alignment restrictions before being used.

since: 2.32

Free all memory associated with a mempool.

since: 2.32

Flush used memory and mark allocated blocks as free.

since: 2.32

Create a new mempool header. Mempools can be used to efficiently allocate data which can then be freed as a whole.

since: 2.32

since: 2.32

Like mktime(3), but assumes UTC instead of local timezone.

since: 3.4

This copies an mbox file from a shared directory with multiple readers and writers into a private (presumably Camel-controlled) directory. Dot locking is used on the source file (but not the destination).

since: 2.24

since: 2.24

since: 2.24

since: 2.24

since: 2.24

since: 2.24

since: 2.24

since: 3.8

since: 2.24

Prints information about currently stored pointers in the pointer tracker. This is called automatically on application exit if camel_pointer_tracker_track() or camel_pointer_tracker_track_with_info() was called.

since: 3.6

Adds pointer to the pointer tracker, with associated information, which is printed in summary of pointer tracker printed by camel_pointer_tracker_dump(). For convenience can be used camel_pointer_tracker_track(), which adds place of the caller as info. Added pointer should be removed with pair function camel_pointer_tracker_untrack().

since: 3.6

Removes pointer from the pointer tracker. It’s an error to try to remove pointer which was not added to the tracker by camel_pointer_tracker_track() or camel_pointer_tracker_track_with_info(), or a pointer which was already removed.

since: 3.6

Add string to the pool.

Returns whether the string exists in the string pool.

since: 3.22

Dumps to stdout memory statistic about the string pool.

since: 3.6

Unreferences a pooled string. If the string’s reference count drops to zero it will be deallocated. NULL and the empty string are special cased.

Returns the canonicalized copy of string without increasing its reference count in the string pool. If necessary, string is first added to the string pool.

since: 2.24

Create a new pooled string entry for strings. A pooled string is a table where common strings are canonicalized. They are also reference counted and freed when no longer referenced.

Decodes a block of quoted-printable encoded data. Performs a ‘decode step’ on a chunk of QP encoded data.

Quoted-printable encodes a block of text. Call this when finished encoding data with camel_quoted_encode_step() to flush off the last little bit.

Quoted-printable encodes a block of text. Performs an ‘encode step’, saves left-over state in state and save (initialise to -1 on first invocation).

Cancellable libc read() replacement.

since: 3.22

since: 3.28

since: 3.22

Decodes header_value, if needed, either from an address header or the Subject header. Other header_name headers are returned as is.

since: 3.22

since: 3.28

since: 3.22

since: 2.24

since: 3.44

Find the state of the flag name in flags.

Convert in from plain text into HTML.

Applies the given time value in unit unit to the src_time. Use negative value to subtract it. The time part is rounded to the beginning of the day.

since: 3.24

Convert a ucs2 string into a UTF-8 one. The ucs2 string is treated as network byte ordered, and terminated with a 16-bit NULL.

Attempt to unlock a .lock lock.

Unlock an fcntl lock.

Unlock an flock lock.

Free a lock on a folder.

Convert a modified UTF-7 string to UTF-8. If the UTF-7 string contains 8 bit characters, they are treated as iso-8859-1.

Get a Unicode character from a UTF-8 stream. ptr will be advanced to the next character position. Invalid utf8 characters will be silently skipped. The ptr should point to a NUL terminated array.

Get the next UTF-8 gchar at ptr, and return it, advancing ptr to the next character. If end is reached before a full UTF-8 character can be read, then the invalid Unicode gchar 0xffff is returned as a sentinel (Unicode 3.1, section 2.7), and ptr is not advanced.

Ensures the returned text will be valid UTF-8 string, with incorrect letters changed to question marks.

since: 2.26

Ensures the returned text will be valid UTF-8 string, with incorrect letters changed to question marks.

since: 3.34

Output a 32 bit unicode character as UTF-8 octets. At most 4 octets will be written to ptr. The ptr will be advanced to the next character position.

Convert a UTF-8 string into a ucs2 one. The ucs string will be in network byte order, and terminated with a 16-bit NULL.

Convert a UTF-8 string to a modified UTF-7 format.

Reads a numeric data from the bdata_ptr and moves the bdata_ptr after that number. If the number cannot be read, then the default_value is returned instead and the bdata_ptr is left unchanged. The number might be previously stored with the camel_util_bdata_put_number().

since: 3.24

Reads a string data from the bdata_ptr and moves the bdata_ptr after that string. If the string cannot be read, then the default_value is returned instead and the bdata_ptr is left unchanged. The string might be previously stored with the camel_util_bdata_put_string().

since: 3.24

Puts the number value at the end of the bdata_str. In case the bdata_str is not empty a space is added before the numeric value. The stored value can be read back with the camel_util_bdata_get_number().

since: 3.24

Puts the string value at the end of the bdata_str. In case the bdata_str is not empty a space is added before the string value. The stored value can be read back with the camel_util_bdata_get_string().

since: 3.24

Decode the values previously encoded by camel_util_encode_user_header_setting(). The out_header_name points to the setting_value, thus it’s valid as long as the setting_value is valid and unchanged.

since: 3.42

Encode the optional display_name and the header_name to a value suitable for GSettings schema org.gnome.evolution-data-server and key camel-message-info-user-headers.

since: 3.42

Fill info ‘s user-headers with the user-defined headers from the headers array.

since: 3.42

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.

since: 3.40

Checks whether the domain in the email_address requires conversion to ASCII and if it does it also converts it. When the do_format is TRUE, the output string is formatted for display, otherwise it’s encoded for use in the message headers. A NULL is returned when no conversion was needed.

since: 3.44

Checks whether the host name of the url requires conversion to ASCII and converts it, if needed.

since: 3.44

Checks whether the host name of the url_str requires conversion to ASCII and converts it if needed. Returns NULL, when no conversion was required.

since: 3.44

Frees a GWeakRef created by camel_utils_weak_ref_new().

since: 3.40

Allocates a new GWeakRef and calls g_weak_ref_set() with object.

since: 3.40

Uudecodes a chunk of data. Performs a ‘decode step’ on a chunk of uuencoded data. Assumes the “begin mode filename” line has been stripped off.

Uuencodes a chunk of data. Call this when finished encoding data with camel_uuencode_step() to flush off the last little bit.

Uuencodes a chunk of data. Performs an ‘encode step’, only encodes blocks of 45 characters to the output at a time, saves left-over state in uubuf, state and save (initialize to 0 on first invocation).

Cancellable libc write() replacement.

Performs a ‘decode step’ on a chunk of yEncoded data of length inlen pointed to by in and writes to out. Assumes the =ybegin and =ypart lines have already been stripped off.

Call this function when finished encoding data with camel_yencode_step() to flush off the remaining state.

Performs an yEncode ‘encode step’ on a chunk of raw data of length inlen pointed to by in and writes to out.

This sanity checks return values and GError. If returning failure, make sure the GError is set. If returning success, make sure the GError is NOT set.

since: 2.32

Same as CAMEL_CHECK_GERROR, but for direct GError pointers.

since: 3.12

Adds pointer ‘ptr’ to pointer tracker. Usual use case is to add object to the tracker in GObject::init and remove it from tracker within GObject::finalize. Since the tracker’s functions are called, the application prints summary of the pointers on console on exit. If everything gone right then it prints message about all tracked pointers were removed. Otherwise it prints summary of left pointers in the tracker. Added pointer should be removed with pair function camel_pointer_tracker_untrack().

since: 3.6

Name of the photo-filename property which can be stored on a CamelCipherCertInfo.

A string containing a list of email addresses of all signers including their alternative emails. Use camel_address_unformat() to break them back into separate addresses. This can be set only on the first signer of the first validity, even the addresses can belong to a different signer.

This environment variable configures where the camel provider modules are loaded from.

The folder type bitshift value.

The folder type mask value.

Maximum length, in characters, of a mime part preview.

Can be used with camel_session_addressbook_contains_sync() as the book UID, meaning to check in all configured address books.

Can be used with camel_session_addressbook_contains_sync() as the book UID, meaning to check in all address books enabled for auto-completion.

The folder store info type bitshift value.

The folder store info type mask value.