1msynctool(1)                         Sync                         msynctool(1)
2
3
4

NAME

6       msynctool - Command line interface for OpenSync
7

SYNTAX

9       msynctool option [arguments] [option]
10       msynctool --sync SYNC_GROUP
11

DESCRIPTION

13       Command line interface for OpenSync
14       You  can  use  this  tool  to synchronize your devices and applications
15       using the OpenSync framework from the command line.
16
17       - First you have to create a SYNC_GROUP:
18
19              msynctool --addgroup evo2-sync
20
21       - Now you have to add the members to this group. (2 at least)
22
23       Note: The first argument to the --addmember command  is  the  group  to
24       which  you want to add a member, the second argument is the name of the
25       plugin to add.
26
27              msynctool --addmember evo2-sync evo2-sync
28
29              msynctool --addmember evo2-sync file-sync
30
31       - The next thing you have to do is to configure the plugins.
32
33              msynctool --configure evo2-sync 1
34              (configures the first group member)
35
36              msynctool --configure evo2-sync 2
37              (configures the second group member)
38
39       - Now your group is ready for usage!
40
41              msynctool --sync evo2-sync
42
43
44

OPTIONS

46       --listgroups
47              Lists all groups
48
49       --listplugins
50              Lists all plugins
51
52       --listobjects
53              Lists all objtypes that the engine understands
54
55              objtypes: contact, data, event, note, todo
56
57       --showformats objtype
58              Lists all formats that a objtype can have
59
60       --showgroup groupname
61              Lists all members of the group
62
63       --sync groupname
64              Sync all members in a group
65
66       --filter-objtype objtype
67              Filter out objtype
68
69              For example, the following syncs only contacts:
70
71              msynctool --sync evo2-sync --filter-objtype event  --filter-obj‐
72              type note --filter-objtype todo
73
74       Note: if you use "--filter-objtype data" it syncs nothing !?
75
76       --slow-sync objtype
77              Perform a slow-sync of all members in the group
78
79       [--wait]
80              Don't  immediately  start to sync, but wait for a client to ini‐
81              tialize the sync
82
83       [--multi]
84              Repeat to wait for sync alerts
85
86       --addgroup groupname
87              Add a new group
88
89       --delgroup groupname
90              Delete the given group
91
92       --addmember groupname plugintype
93              Add a member to the group
94
95       --configure groupname memberid
96              Configure a member. memberid as returned by --showgroup
97
98       [--manual]
99              Make manual engine iterations. Only for debugging
100
101       [--configdir]
102              Set a different configdir than ~/.opensync
103
104       [--conflict 1-9/d/i/n]
105              Resolve all conflicts as side 1-9 wins,  duplicate,  ignore,  or
106              keep newer
107

ENVIRONMENT VARIABLES

109       OSYNC_TRACE
110              When you want to provide trace files please turn on tracing like
111              this:
112
113              export OSYNC_TRACE=/path/to/log/dir
114
115              When you run some opensync commands now, opensync will  generate
116              a couple of Thread*.log files in this directory.
117
118              You can exclude sensitive data in the trace files with:
119
120              export OSYNC_PRIVACY=1
121

SEE ALSO

123       convcard(1),file-sync.conf(5)
124

AUTHORS

126       This  manual  page  was  written  for  the  Debian GNU/Linux project by
127       Matthias Jahn <jahn.matthias@freenet.de>.  But it may be used by  other
128       distributions.
129
130       msynctool was written by Armin Bauer and the OpenSync project
131
132
133
134Armin Bauer                          0.19                         msynctool(1)