da_notmuch_database_create

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

The path should be a top-level directory to a collection of plain-text email messages (one message per file). This call will create a new ".notmuch" directory within 'path' where notmuch will store its data.

After a successful call to notmuch_database_create, the returned database will be open so the caller should call notmuch_database_destroy when finished with it.

The database will not yet have any data in it (notmuch_database_create itself is a very cheap function). Messages contained within 'path' can be added to the database by calling notmuch_database_add_message.

In case of any failure, this function returns an error status and sets *database to NULL (after printing an error message on stderr).

Return value:

alias da_notmuch_database_create = notmuch_status_t function()

Detailed Description

NOTMUCH STATUS SUCCESS

Successfully created the database.

NOTMUCH STATUS NULL POINTER

The given 'path' argument is NULL.

NOTMUCH STATUS OUT OF MEMORY

Out of memory.

NOTMUCH STATUS FILE ERROR

An error occurred trying to create the * database file (such as permission denied, or file not found, * etc.), or the database already exists.

NOTMUCH STATUS XAPIAN EXCEPTION

A Xapian exception occurred.

Meta