syncml-ds-tool(1) A SyncML Data Synchronization tool for Unix. The syncml-ds-tool supports OMA DS server and client mode. Additionally OBEX and HTTP transports are supported in client and server mode.


syncml-ds-tool 'OPTIONS' ...


Datastore configuration

&ndash;sync '<type>' '<path>' '<directory>' normal two-way sync
&ndash;slow-sync '<type>' '<path>' '<directory>' slow two-way sync

  • type is the content-type of a datastore text/x-vcard for contacts text/x-vcalendar for calendar text/plain for notes text/x-vMessage for SMS

  • path is the used (virtual) source URL/path It is the local name of the database. You can choose something there.

  • directory is the local path to the synchronized directory The directory is optional and an absolute path. This directory is a persistent storage.

HTTP client configuration

&ndash;http-client '<url>'

HTTP server configuration

&ndash;http-server '<port>'

  • port must be a port for the http server.

OBEX client configuration

-s '<device>' Connect to the serial device.
-u List all available USB interfaces.
-u '<id>' Connect to the given usb interface number. You may discover them with -u.
-b '<addr>' '<channel>' Connect to the given bluetooth device.
&ndash;ip '<addr>' '<port>' Connect to this TCP/IP address.
&ndash;irda Connect using IrDA.
&ndash;irda-service '<service>' Use the given IrDA service (default: OBEX).

OBEX server configuration

&ndash;port '<port>' Listen to this TCP/IP port.

General SyncML options

&ndash;identifier '<ident>' set the local identity of SyncML (source).
&ndash;target '<ident>' set the remote identity of SyncML (target).
&ndash;username '<username>' set the username for authentication.
&ndash;password '<password>' set the password for authentication.
&ndash;maxMsgSize '<limit>' set the maximum message size (default: 0)
&ndash;maxObjSize* '<limit>' set the maximum object size (default: 0)
&ndash;useStringTable Use wbxml string tables (default: NEVER EVER)
&ndash;disableNumberOfChanges the most new phones support it (default: enabled)
&ndash;useNumberAnchor Use numbers as anchors.
&ndash;wbxml Use wbxml (WAP Binary XML) instead of plain xml.
&ndash;read-only No write actions will be performed.
&ndash;remoteWinsConflicts If there is a conflict then the remote change wins. The default is local wins always. This option is only usable in OMA DS server mode.
&ndash;dumpinfo Print info about the phone.
&ndash;version prints the version of the tool.
&ndash;version '<version>' sets the SyncML version.

  • ident Some devices require a special identity string. Nokias for example often requires 'PC Suite'. Please use --identifier 'PC Suite' in this case.
  • version can be '1.0', '1.1' or '1.2'. The default version is '1.1'.

Device faking options

Some SyncML servers try to enforce access policies via device filtering. These options can be used to work around such filters.


&ndash;fake-manufacturer '<Man>' set the manufacturer of the faked device.
&ndash;fake-model '<Mod>' set the model of the faked device.
&ndash;fake-software-version '<SwV>' set the software version of the faked device.


Get the contacts from your phone via Bluetooth

$ syncml-ds-tool -b <mac> <channel> --slow-sync text/x-vcard contacts --wbxml --identifier "PC Suite"


Get the notes from a USB connected phone

$ syncml-ds-tool -u <interface> --slow-sync text/plain notes --wbxml --identifier "PC Suite"


There is a bugtracker running at If you have a problem please look there to see if it is already reported and add your information to the relavant ticket if possible.

When opening a new ticket please provide as many information as possible. For faster processing of your bug it helps to attach the trace files. You may find a description how to create them at For crashes the output of gdb could help.


Written by Felix Moeller, [email protected]




Copyright (C) 2008 OpenSync Team. Free use of this software is granted under the terms of the GNU Lesser General Public License (LGPL).