mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-11-22 02:48:08 +01:00
909f52bd8c
The recent support for renames in the database is our first time (since notmuch has had more than a single user) that we have a database format change. To support smooth upgrades we now encode a database format version number in the Xapian metadata. Going forward notmuch will emit a warning if used to read from a database with a newer version than it natively supports, and will refuse to write to a database with a newer version. The library also provides functions to query the database format version: notmuch_database_get_version to ask if notmuch wants a newer version than that: notmuch_database_needs_upgrade and a function to actually perform that upgrade: notmuch_database_upgrade
53 lines
1.7 KiB
C
53 lines
1.7 KiB
C
/* database-private.h - For peeking into the internals of notmuch_database_t
|
|
*
|
|
* Copyright © 2009 Carl Worth
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see http://www.gnu.org/licenses/ .
|
|
*
|
|
* Author: Carl Worth <cworth@cworth.org>
|
|
*/
|
|
|
|
#ifndef NOTMUCH_DATABASE_PRIVATE_H
|
|
#define NOTMUCH_DATABASE_PRIVATE_H
|
|
|
|
#include "notmuch-private.h"
|
|
|
|
#include <xapian.h>
|
|
|
|
struct _notmuch_database {
|
|
notmuch_bool_t exception_reported;
|
|
char *path;
|
|
notmuch_database_mode_t mode;
|
|
Xapian::Database *xapian_db;
|
|
Xapian::QueryParser *query_parser;
|
|
Xapian::TermGenerator *term_gen;
|
|
Xapian::ValueRangeProcessor *value_range_processor;
|
|
|
|
notmuch_bool_t needs_upgrade;
|
|
};
|
|
|
|
/* Convert tags from Xapian internal format to notmuch format.
|
|
*
|
|
* The function gets a TermIterator as argument and uses that iterator to find
|
|
* all tag terms in the object. The tags are then converted to a
|
|
* notmuch_tags_t list and returned. The function needs to allocate memory for
|
|
* the resulting list and it uses the argument ctx as talloc context.
|
|
*
|
|
* The function returns NULL on failure.
|
|
*/
|
|
notmuch_tags_t *
|
|
_notmuch_convert_tags (void *ctx, Xapian::TermIterator &i,
|
|
Xapian::TermIterator &end);
|
|
|
|
#endif
|