lib: provide config API

[notmuch.git] / lib / notmuch.h

diff --git a/lib/notmuch.h b/lib/notmuch.h
index cb46fc057d3e3ee91b7b9fcb5ae02667a2ab2c5f..c827e02d14778e82cf23cadc6b897820a08d2b73 100644 (file)
--- a/lib/notmuch.h
+++ b/lib/notmuch.h
@@ -1838,6 +1838,31 @@ notmuch_filenames_move_to_next (notmuch_filenames_t *filenames);
 void
 notmuch_filenames_destroy (notmuch_filenames_t *filenames);
 
+
+/**
+ * set config 'key' to 'value'
+ *
+ */
+notmuch_status_t
+notmuch_database_set_config (notmuch_database_t *db, const char *key, const char *value);
+
+/**
+ * retrieve config item 'key', assign to  'value'
+ *
+ * keys which have not been previously set with n_d_set_config will
+ * return an empty string.
+ *
+ * return value is allocated by malloc and should be freed by the
+ * caller.
+ */
+notmuch_status_t
+notmuch_database_get_config (notmuch_database_t *db, const char *key, char **value);
+
+/**
+ * interrogate the library for compile time features
+ */
+notmuch_bool_t
+notmuch_built_with (const char *name);
 /* @} */
 
 NOTMUCH_END_DECLS