2013-12-08 19:46:40 +00:00
|
|
|
/*
|
|
|
|
* mbsync - mailbox synchronizer
|
|
|
|
* Copyright (C) 2000-2002 Michael R. Elkins <me@mutt.org>
|
|
|
|
* Copyright (C) 2002-2006,2010-2012 Oswald Buddenhagen <ossi@users.sf.net>
|
|
|
|
*
|
|
|
|
* 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 2 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/>.
|
|
|
|
*
|
|
|
|
* As a special exception, mbsync may be linked with the OpenSSL library,
|
|
|
|
* despite that library's more restrictive license.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef SYNC_H
|
|
|
|
#define SYNC_H
|
|
|
|
|
|
|
|
#include "driver.h"
|
|
|
|
|
deprecate master/slave terminology
the underlying metaphor refers to an inhumane practice, so using it
casually is rightfully offensive to many people. it isn't even a
particularly apt metaphor, as it suggests a strict hierarchy that is
counter to mbsync's highly symmetrical mode of operation.
the far/near terminology has been chosen as the replacement, as it is a
natural fit for the push/pull terminology. on the downside, due to these
not being nouns, a few uses are a bit awkward, and several others had to
be amended to include 'side'. also, it's conceptually quite close to
remote/local, which matches the typical use case, but is maybe a bit too
suggestive of actually non-existing limitations.
the new f/n suffixes of the -C/-R/-X options clash with pre-existing
options, so direct concatenation of short options is even less practical
than before (some suffixes of -D already clashed), but doing that leads
to unreadable command lines anyway.
as with previous deprecations, all pre-existing command line and config
options keep working, but yield a warning. the state files are silently
upgraded.
2020-07-22 17:44:26 +00:00
|
|
|
#define F 0 // far side
|
|
|
|
#define N 1 // near side
|
2013-12-08 19:46:40 +00:00
|
|
|
|
|
|
|
#define OP_NEW (1<<0)
|
|
|
|
#define OP_RENEW (1<<1)
|
|
|
|
#define OP_DELETE (1<<2)
|
|
|
|
#define OP_FLAGS (1<<3)
|
|
|
|
#define OP_MASK_TYPE (OP_NEW|OP_RENEW|OP_DELETE|OP_FLAGS) /* asserted in the target ops */
|
|
|
|
#define OP_EXPUNGE (1<<4)
|
|
|
|
#define OP_CREATE (1<<5)
|
2014-12-29 01:08:48 +00:00
|
|
|
#define OP_REMOVE (1<<6)
|
|
|
|
#define XOP_PUSH (1<<8)
|
|
|
|
#define XOP_PULL (1<<9)
|
2013-12-08 19:46:40 +00:00
|
|
|
#define XOP_MASK_DIR (XOP_PUSH|XOP_PULL)
|
2014-12-29 01:08:48 +00:00
|
|
|
#define XOP_HAVE_TYPE (1<<10)
|
|
|
|
#define XOP_HAVE_EXPUNGE (1<<11)
|
|
|
|
#define XOP_HAVE_CREATE (1<<12)
|
|
|
|
#define XOP_HAVE_REMOVE (1<<13)
|
2013-12-08 19:46:40 +00:00
|
|
|
|
|
|
|
typedef struct channel_conf {
|
|
|
|
struct channel_conf *next;
|
|
|
|
const char *name;
|
|
|
|
store_conf_t *stores[2];
|
|
|
|
const char *boxes[2];
|
|
|
|
char *sync_state;
|
|
|
|
string_list_t *patterns;
|
|
|
|
int ops[2];
|
deprecate master/slave terminology
the underlying metaphor refers to an inhumane practice, so using it
casually is rightfully offensive to many people. it isn't even a
particularly apt metaphor, as it suggests a strict hierarchy that is
counter to mbsync's highly symmetrical mode of operation.
the far/near terminology has been chosen as the replacement, as it is a
natural fit for the push/pull terminology. on the downside, due to these
not being nouns, a few uses are a bit awkward, and several others had to
be amended to include 'side'. also, it's conceptually quite close to
remote/local, which matches the typical use case, but is maybe a bit too
suggestive of actually non-existing limitations.
the new f/n suffixes of the -C/-R/-X options clash with pre-existing
options, so direct concatenation of short options is even less practical
than before (some suffixes of -D already clashed), but doing that leads
to unreadable command lines anyway.
as with previous deprecations, all pre-existing command line and config
options keep working, but yield a warning. the state files are silently
upgraded.
2020-07-22 17:44:26 +00:00
|
|
|
int max_messages; // For near side only.
|
2013-12-08 19:46:40 +00:00
|
|
|
signed char expire_unread;
|
|
|
|
char use_internal_date;
|
|
|
|
} channel_conf_t;
|
|
|
|
|
|
|
|
typedef struct group_conf {
|
|
|
|
struct group_conf *next;
|
|
|
|
const char *name;
|
|
|
|
string_list_t *channels;
|
|
|
|
} group_conf_t;
|
|
|
|
|
|
|
|
extern channel_conf_t global_conf;
|
|
|
|
extern channel_conf_t *channels;
|
|
|
|
extern group_conf_t *groups;
|
|
|
|
|
deprecate master/slave terminology
the underlying metaphor refers to an inhumane practice, so using it
casually is rightfully offensive to many people. it isn't even a
particularly apt metaphor, as it suggests a strict hierarchy that is
counter to mbsync's highly symmetrical mode of operation.
the far/near terminology has been chosen as the replacement, as it is a
natural fit for the push/pull terminology. on the downside, due to these
not being nouns, a few uses are a bit awkward, and several others had to
be amended to include 'side'. also, it's conceptually quite close to
remote/local, which matches the typical use case, but is maybe a bit too
suggestive of actually non-existing limitations.
the new f/n suffixes of the -C/-R/-X options clash with pre-existing
options, so direct concatenation of short options is even less practical
than before (some suffixes of -D already clashed), but doing that leads
to unreadable command lines anyway.
as with previous deprecations, all pre-existing command line and config
options keep working, but yield a warning. the state files are silently
upgraded.
2020-07-22 17:44:26 +00:00
|
|
|
extern const char *str_fn[2], *str_hl[2];
|
2013-12-08 19:46:40 +00:00
|
|
|
|
|
|
|
#define SYNC_OK 0 /* assumed to be 0 */
|
|
|
|
#define SYNC_FAIL 1
|
deprecate master/slave terminology
the underlying metaphor refers to an inhumane practice, so using it
casually is rightfully offensive to many people. it isn't even a
particularly apt metaphor, as it suggests a strict hierarchy that is
counter to mbsync's highly symmetrical mode of operation.
the far/near terminology has been chosen as the replacement, as it is a
natural fit for the push/pull terminology. on the downside, due to these
not being nouns, a few uses are a bit awkward, and several others had to
be amended to include 'side'. also, it's conceptually quite close to
remote/local, which matches the typical use case, but is maybe a bit too
suggestive of actually non-existing limitations.
the new f/n suffixes of the -C/-R/-X options clash with pre-existing
options, so direct concatenation of short options is even less practical
than before (some suffixes of -D already clashed), but doing that leads
to unreadable command lines anyway.
as with previous deprecations, all pre-existing command line and config
options keep working, but yield a warning. the state files are silently
upgraded.
2020-07-22 17:44:26 +00:00
|
|
|
#define SYNC_BAD(fn) (4<<(fn))
|
2013-12-08 19:46:40 +00:00
|
|
|
#define SYNC_NOGOOD 16 /* internal */
|
|
|
|
#define SYNC_CANCELED 32 /* internal */
|
|
|
|
|
2014-12-30 14:16:38 +00:00
|
|
|
#define BOX_POSSIBLE -1
|
|
|
|
#define BOX_ABSENT 0
|
|
|
|
#define BOX_PRESENT 1
|
|
|
|
|
2013-12-08 19:46:40 +00:00
|
|
|
/* All passed pointers must stay alive until cb is called. */
|
2019-07-28 19:13:28 +00:00
|
|
|
void sync_boxes( store_t *ctx[], const char * const names[], int present[], channel_conf_t *chan,
|
2013-12-08 19:46:40 +00:00
|
|
|
void (*cb)( int sts, void *aux ), void *aux );
|
|
|
|
|
|
|
|
#endif
|