msynctool (1) - Linux Man Pages
msynctool: Command line interface for OpenSync
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
- Lists all groups
- Lists all plugins
- 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
- Don't immediately start to sync, but wait for a client to initialize the sync
- Repeat to wait for sync alerts
- --addgroup groupname
- Add a new group
- --delgroup groupname
- Delete the given group
- --addmember groupname plugintype
- Add a member to the group
- --configure groupname memberid
- Configure a member. memberid as returned by --showgroup
- Make manual engine iterations. Only for debugging
- Set a different configdir than ~/.opensync
- [--conflict 1-9/d/i/n]
- Resolve all conflicts as side 1-9 wins, duplicate, ignore, or keep newer
- 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
This manual page was written for the Debian GNU/Linux project by Matthias Jahn <jahn.matthias [at] freenet.de>. But it may be used by other distributions.
msynctool was written by Armin Bauer and the OpenSync project