Crate notmuch_sys [−] [src]

Not much of an email library, just index and search.

Enums

notmuch_config_list_t
notmuch_database_mode_t

Database open mode for notmuch_database_open.

notmuch_database_t
notmuch_directory_t
notmuch_exclude_t

Exclude values for notmuch_query_set_omit_excluded

notmuch_filenames_t
notmuch_message_flag_t

Message flags.

notmuch_message_properties_t
notmuch_message_t
notmuch_messages_t
notmuch_query_t
notmuch_sort_t

Sort values for notmuch_query_set_sort.

notmuch_status_t

Status codes used for the return values of most functions.

notmuch_tags_t
notmuch_thread_t
notmuch_threads_t

Constants

FALSE
TAG_MAX

The longest possible tag value.

TRUE

Functions

notmuch_built_with⚠

interrogate the library for compile time features

notmuch_config_list_destroy⚠

free any resources held by 'config_list'

notmuch_config_list_key⚠

return key for current config pair

notmuch_config_list_move_to_next⚠

move 'config_list' iterator to the next pair

notmuch_config_list_valid⚠

Is 'config_list' iterator valid (i.e. _key, _value, _move_to_next can be called).

notmuch_config_list_value⚠

return 'value' for current config pair

notmuch_database_add_message⚠

Add a new message to the given notmuch database or associate an additional filename with an existing message.

notmuch_database_begin_atomic⚠

Begin an atomic database operation.

notmuch_database_close⚠

Commit changes and close the given notmuch database.

notmuch_database_compact⚠

Compact a notmuch database, backing up the original database to the given path.

notmuch_database_create⚠

Create a new, empty notmuch database located at 'path'.

notmuch_database_create_verbose⚠

Like notmuch_database_create, except optionally return an error message. This message is allocated by malloc and should be freed by the caller.

notmuch_database_destroy⚠

Destroy the notmuch database, closing it if necessary and freeing all associated resources.

notmuch_database_end_atomic⚠

Indicate the end of an atomic database operation.

notmuch_database_find_message⚠

Find a message with the given message_id.

notmuch_database_find_message_by_filename⚠

Find a message with the given filename.

notmuch_database_get_all_tags⚠

Return a list of all tags found in the database.

notmuch_database_get_config⚠

retrieve config item 'key', assign to 'value'

notmuch_database_get_config_list⚠

Create an iterator for all config items with keys matching a given prefix

notmuch_database_get_directory⚠

Retrieve a directory object from the database for 'path'.

notmuch_database_get_path⚠

Return the database path of the given database.

notmuch_database_get_revision⚠

Return the committed database revision and UUID.

notmuch_database_get_version⚠

Return the database format version of the given database.

notmuch_database_needs_upgrade⚠

Can the database be upgraded to a newer database version?

notmuch_database_open⚠

Open an existing notmuch database located at 'path'.

notmuch_database_open_verbose⚠

Like notmuch_database_open, except optionally return an error message. This message is allocated by malloc and should be freed by the caller.

notmuch_database_remove_message⚠

Remove a message filename from the given notmuch database. If the message has no more filenames, remove the message.

notmuch_database_set_config⚠

set config 'key' to 'value'

notmuch_database_status_string⚠

Retrieve last status string for given database.

notmuch_database_upgrade⚠

Upgrade the current database to the latest supported version.

notmuch_directory_delete⚠

Delete directory document from the database, and destroy the notmuch_directory_t object. Assumes any child directories and files have been deleted by the caller.

notmuch_directory_destroy⚠

Destroy a notmuch_directory_t object.

notmuch_directory_get_child_directories⚠

Get a notmuch_filenames_t iterator listing all the filenames of sub-directories in the database within the given directory.

notmuch_directory_get_child_files⚠

Get a notmuch_filenames_t iterator listing all the filenames of messages in the database within the given directory.

notmuch_directory_get_mtime⚠

Get the mtime of a directory, (as previously stored with notmuch_directory_set_mtime).

notmuch_directory_set_mtime⚠

Store an mtime within the database for 'directory'.

notmuch_filenames_destroy⚠

Destroy a notmuch_filenames_t object.

notmuch_filenames_get⚠

Get the current filename from 'filenames' as a string.

notmuch_filenames_move_to_next⚠

Move the 'filenames' iterator to the next filename.

notmuch_filenames_valid⚠

Is the given 'filenames' iterator pointing at a valid filename.

notmuch_message_add_property⚠

Add a (key,value) pair to a message

notmuch_message_add_tag⚠

Add a tag to the given message.

notmuch_message_destroy⚠

Destroy a notmuch_message_t object.

notmuch_message_freeze⚠

Freeze the current state of 'message' within the database.

notmuch_message_get_date⚠

Get the date of 'message' as a time_t value.

notmuch_message_get_filename⚠

Get a filename for the email corresponding to 'message'.

notmuch_message_get_filenames⚠

Get all filenames for the email corresponding to 'message'.

notmuch_message_get_flag⚠

Get a value of a flag for the email corresponding to 'message'.

notmuch_message_get_header⚠

Get the value of the specified header from 'message' as a UTF-8 string.

notmuch_message_get_message_id⚠

Get the message ID of 'message'.

notmuch_message_get_properties⚠

Get the properties for message, returning a notmuch_message_properties_t object which can be used to iterate over all properties.

notmuch_message_get_property⚠

Retrieve the value for a single property key

notmuch_message_get_replies⚠

Get a notmuch_messages_t iterator for all of the replies to 'message'.

notmuch_message_get_tags⚠

Get the tags for 'message', returning a notmuch_tags_t object which can be used to iterate over all tags.

notmuch_message_get_thread_id⚠

Get the thread ID of 'message'.

notmuch_message_maildir_flags_to_tags⚠

Add/remove tags according to maildir flags in the message filename(s).

notmuch_message_properties_destroy⚠

Destroy a notmuch_message_properties_t object.

notmuch_message_properties_key⚠

Return the key from the current (key,value) pair.

notmuch_message_properties_move_to_next⚠

Move the properties iterator to the next (key,value) pair

notmuch_message_properties_valid⚠

Is the given properties iterator pointing at a valid (key,value) pair.

notmuch_message_properties_value⚠

Return the value from the current (key,value) pair.

notmuch_message_remove_all_properties⚠

Remove all (key,value) pairs from the given message.

notmuch_message_remove_all_tags⚠

Remove all tags from the given message.

notmuch_message_remove_property⚠

Remove a (key,value) pair from a message.

notmuch_message_remove_tag⚠

Remove a tag from the given message.

notmuch_message_set_flag⚠

Set a value of a flag for the email corresponding to 'message'.

notmuch_message_tags_to_maildir_flags⚠

Rename message filename(s) to encode tags as maildir flags.

notmuch_message_thaw⚠

Thaw the current 'message', synchronizing any changes that may have occurred while 'message' was frozen into the notmuch database.

notmuch_messages_collect_tags⚠

Return a list of tags from all messages.

notmuch_messages_destroy⚠

Destroy a notmuch_messages_t object.

notmuch_messages_get⚠

Get the current message from 'messages' as a notmuch_message_t.

notmuch_messages_move_to_next⚠

Move the 'messages' iterator to the next message.

notmuch_messages_valid⚠

Is the given 'messages' iterator pointing at a valid message.

notmuch_query_add_tag_exclude⚠

Add a tag that will be excluded from the query results by default. This exclusion will be overridden if this tag appears explicitly in the query.

notmuch_query_count_messages_st⚠

Return the number of messages matching a search.

notmuch_query_count_threads_st⚠

Return the number of threads matching a search.

notmuch_query_create⚠

Create a new query for 'database'.

notmuch_query_destroy⚠

Destroy a notmuch_query_t along with any associated resources.

notmuch_query_get_database⚠

Return the notmuch database of this query. See notmuch_query_create.

notmuch_query_get_query_string⚠

Return the query_string of this query. See notmuch_query_create.

notmuch_query_get_sort⚠

Return the sort specified for this query. See notmuch_query_set_sort.

notmuch_query_search_messages_st⚠

Execute a query for messages, returning a notmuch_messages_t object which can be used to iterate over the results. The returned messages object is owned by the query and as such, will only be valid until notmuch_query_destroy.

notmuch_query_search_threads_st⚠

Execute a query for threads, returning a notmuch_threads_t object which can be used to iterate over the results. The returned threads object is owned by the query and as such, will only be valid until notmuch_query_destroy.

notmuch_query_set_omit_excluded⚠

Specify whether to omit excluded results or simply flag them. By default, this is set to TRUE.

notmuch_query_set_sort⚠

Specify the sorting desired for this query.

notmuch_status_to_string⚠

Get a string representation of a notmuch_status_t value.

notmuch_tags_destroy⚠

Destroy a notmuch_tags_t object.

notmuch_tags_get⚠

Get the current tag from 'tags' as a string.

notmuch_tags_move_to_next⚠

Move the 'tags' iterator to the next tag.

notmuch_tags_valid⚠

Is the given 'tags' iterator pointing at a valid tag.

notmuch_thread_destroy⚠

Destroy a notmuch_thread_t object.

notmuch_thread_get_authors⚠

Get the authors of 'thread' as a UTF-8 string.

notmuch_thread_get_matched_messages⚠

Get the number of messages in 'thread' that matched the search.

notmuch_thread_get_messages⚠

Get a notmuch_thread_t iterator for all messages in 'thread' in oldest-first order.

notmuch_thread_get_newest_date⚠

Get the date of the newest message in 'thread' as a time_t value.

notmuch_thread_get_oldest_date⚠

Get the date of the oldest message in 'thread' as a time_t value.

notmuch_thread_get_subject⚠

Get the subject of 'thread' as a UTF-8 string.

notmuch_thread_get_tags⚠

Get the tags for 'thread', returning a notmuch_tags_t object which can be used to iterate over all tags.

notmuch_thread_get_thread_id⚠

Get the thread ID of 'thread'.

notmuch_thread_get_toplevel_messages⚠

Get a notmuch_messages_t iterator for the top-level messages in 'thread' in oldest-first order.

notmuch_thread_get_total_messages⚠

Get the total number of messages in 'thread'.

notmuch_threads_destroy⚠

Destroy a notmuch_threads_t object.

notmuch_threads_get⚠

Get the current thread from 'threads' as a notmuch_thread_t.

notmuch_threads_move_to_next⚠

Move the 'threads' iterator to the next thread.

notmuch_threads_valid⚠

Is the given 'threads' iterator pointing at a valid thread.

Type Definitions

notmuch_bool_t