.TH "syncml-ds-tool" 1 "Sat Feb 6 2016" "Version 0.5.4" "libsyncml" \" -*- nroff -*- .ad l .nh .SH NAME syncml-ds-tool \- 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\&. .SH "SYNOPSIS" .PP syncml-ds-tool 'OPTIONS' \&.\&.\&. .SH "OPTIONS" .PP .SS "Datastore configuration" \fBParameters:\fP .RS 4 \fI–sync\fP '' '' '' normal two-way sync .br \fI–slow-sync\fP '' '' '' slow two-way sync .RE .PP .PD 0 .IP "\(bu" 2 \fBtype\fP 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 .PP .PD 0 .IP "\(bu" 2 \fBpath\fP is the used (virtual) source URL/path It is the local name of the database\&. You can choose something there\&. .PP .PD 0 .IP "\(bu" 2 \fBdirectory\fP is the local path to the synchronized directory The directory is optional and an absolute path\&. This directory is a persistent storage\&. .PP .SS "HTTP client configuration" \fBParameters:\fP .RS 4 \fI–http-client\fP '' .RE .PP .PD 0 .IP "\(bu" 2 \fBurl\fP must be an http URL like http://localhost:8080 .PP .SS "HTTP server configuration" \fBParameters:\fP .RS 4 \fI–http-server\fP '' .RE .PP .PD 0 .IP "\(bu" 2 \fBport\fP must be a port for the http server\&. .PP .SS "OBEX client configuration" \fBParameters:\fP .RS 4 \fI-s\fP '' Connect to the serial device\&. .br \fI-u\fP List all available USB interfaces\&. .br \fI-u\fP '' Connect to the given usb interface number\&. You may discover them with -u\&. .br \fI-b\fP '' '' Connect to the given bluetooth device\&. .br \fI–ip\fP '' '' Connect to this TCP/IP address\&. .br \fI–irda\fP Connect using IrDA\&. .br \fI–irda-service\fP '' Use the given IrDA service (default: OBEX)\&. .RE .PP .SS "OBEX server configuration" \fBParameters:\fP .RS 4 \fI–port\fP '' Listen to this TCP/IP port\&. .RE .PP .SS "General SyncML options" \fBParameters:\fP .RS 4 \fI–identifier\fP '' set the local identity of SyncML (source)\&. .br \fI–target\fP '' set the remote identity of SyncML (target)\&. .br \fI–username\fP '' set the username for authentication\&. .br \fI–password\fP '' set the password for authentication\&. .br \fI–maxMsgSize\fP '' set the maximum message size (default: 0) .br \fI–maxObjSize*\fP '' set the maximum object size (default: 0) .br \fI–useStringTable\fP Use wbxml string tables (default: NEVER EVER) .br \fI–disableNumberOfChanges\fP the most new phones support it (default: enabled) .br \fI–useNumberAnchor\fP Use numbers as anchors\&. .br \fI–wbxml\fP Use wbxml (WAP Binary XML) instead of plain xml\&. .br \fI–read-only\fP No write actions will be performed\&. .br \fI–remoteWinsConflicts\fP 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\&. .br \fI–dumpinfo\fP Print info about the phone\&. .br \fI–version\fP prints the version of the tool\&. .br \fI–version\fP '' sets the SyncML version\&. .RE .PP .PD 0 .IP "\(bu" 2 \fBident\fP Some devices require a special identity string\&. Nokias for example often requires 'PC Suite'\&. Please use --identifier 'PC Suite' in this case\&. .IP "\(bu" 2 \fBversion\fP can be '1\&.0', '1\&.1' or '1\&.2'\&. The default version is '1\&.1'\&. .PP .SS "Device faking options" Some SyncML servers try to enforce access policies via device filtering\&. These options can be used to work around such filters\&. .PP \fBParameters:\fP .RS 4 \fI–fake-manufacturer\fP '' set the manufacturer of the faked device\&. .br \fI–fake-model\fP '' set the model of the faked device\&. .br \fI–fake-software-version\fP '' set the software version of the faked device\&. .RE .PP .SH "EXAMPLES" .PP .SS "Get the contacts from your phone via Bluetooth" .PP .nf $ syncml-ds-tool -b --slow-sync text/x-vcard contacts --wbxml --identifier "PC Suite" .fi .PP .SS "Get the notes from a USB connected phone" .PP .nf $ syncml-ds-tool -u --slow-sync text/plain notes --wbxml --identifier "PC Suite" .fi .PP .SH "BUGS" .PP \fB\fP .RS 4 There is a bugtracker running at http://libsyncml.opensync.org/\&. 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\&. .RE .PP \fB\fP .RS 4 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 http://opensync.org/wiki/tracing\&. For crashes the output of gdb could help\&. .RE .PP .SH "AUTHOR" .PP Written by Felix Moeller, felix@derklecks.de .SH "RESOURCES" .PP Website: http://libsyncml.opensync.org .SH "COPYING" .PP Copyright (C) 2008 OpenSync Team\&. Free use of this software is granted under the terms of the GNU Lesser General Public License (LGPL)\&.