msynctool1

Usage

Overview

Command line interface for OpenSync
You can use this tool to synchronize your devices and applications using the OpenSync framework from the command line.

- First you have to create a SYNC_GROUP:

msynctool --addgroup evo2-sync

- Now you have to add the members to this group. (2 at least)

Note: The first argument to the --addmember command is the group to which you want to add a member, the second argument is the name of the plugin to add.

msynctool --addmember evo2-sync evo2-sync

msynctool --addmember evo2-sync file-sync

- The next thing you have to do is to configure the plugins.

msynctool --configure evo2-sync 1
(configures the first group member)

msynctool --configure evo2-sync 2
(configures the second group member)

- Now your group is ready for usage!

msynctool --sync evo2-sync

Options

--listgroups

Lists all groups

--listplugins

Lists all plugins

--listobjects

Lists all objtypes that the engine understands

objtypes: contact, data, event, note, todo

--showformats objtype

Lists all formats that a objtype can have

--showgroup groupname

Lists all members of the group

--sync groupname

Sync all members in a group

--filter-objtype objtype

Filter out objtype

For example, the following syncs only contacts:

msynctool --sync evo2-sync --filter-objtype event --filter-objtype note --filter-objtype todo

Note: if you use "--filter-objtype data" it syncs nothing !?

--slow-sync objtype

Perform a slow-sync of all members in the group

--addgroup groupname

Add a new group

--delgroup groupname

Delete the given group

Environment

OSYNC_TRACE

When you want to provide trace files please turn on tracing like this:

export OSYNC_TRACE=/path/to/log/dir

When you run some opensync commands now, opensync will generate a couple of Thread*.log files in this directory.

You can exclude sensitive data in the trace files with:

export OSYNC_PRIVACY=1