syncml-http-server(1)

NAME

syncml-http-server - simple HTTP server built on libsyncml

SYNTAX

syncml-http-server [option]
syncml-http-server --sync <type> <path>

DESCRIPTION

syncml-http-server is not a real synchronization tool. It

is rather used for testing. The tool will list all entries that

the device wants to sync and is also capable of adding items to

the device.

USAGE

If you want to display the contacts for example you could

type:

syncml-http-server --sync text/x-vcard Contacts

The --sync options states that you want to sync vcards and

that your local database is named "Contacts". This example would

send syncml as plain xml. The tool would then go into listening

mode and wait for incoming connections. You then have to enter

your ip address, port etc on the device and start the sync.

OPTIONS

--sync <type> <path> Emulate a database of the given type

on the url.

--slow-sync <type> <path> Emulate a database of the given

type on the url and use slow-sync

type should be a IANA registered mimetype or your

own type.
Common types are:

- "text/x-vcard" for contacts,
- "text/x-vcalendar" for events,
- "text/plain" for notes and
- "text/x-vMessage" for SMS

path is the local name of the database. You can

choose anything there.

--add <type> <path> Add the file given in path to the de

vice as the given type

type should be a IANA registered mimetype or your

own type.
Common types are:

- "text/x-vcard" for contacts,
- "text/x-vcalendar" for events,
- "text/plain" for notes and
- "text/x-vMessage" for SMS

path to the file to add. The file has to be a

VCard, VCalendar, etc.

[--port <port number>] Listen on this port for incoming

connections

[--multi] Normally the tool exits after the first session

ends.

By using this option you can use more than one ses

sion.

[--recvLimit <limit>] Limit the size of the receiving

buffer to this size (Needed for some phones)

[--maxObjSize <limit>] The maximum size of a object that

we can receive (Needed for some phones)

[--useStringTable] Use wbxml string tables (Improves

transmission size, but not supported by some phones)

[--dumpinfo] Print info about the phone at the end which

can be sent to the developers

EXAMPLES

To run this program the standard way type:
syncml-http-server --port 9999 --sync text/x-vcalendar

events --sync text/x-vcard addressbook --multi --san

Another example:
syncml-http-server --sync text/x-vcard Contacts --sync

text/x-vcalendar Calendar --port 9999

This would get the contacts and the calendar entries (This

example works for a Nokia 6680). It would also listen on the

port 9999 for incoming connections. Note that you dont have to

set wbxml explicitly. libsyncml detects the incoming packets and

sets wbxml automatically if needed.

TROUBLESHOOTING

If it does not work try the following:

- Change the name of the database ("Contacts" and "Calen

dar" in the example)
- Check with netstat -npa when the tool is running to see

if the port is opened
- Use a network sniffer like ethereal to take a look at

the data being transmitted

ENVIRONMENT VARIABLES

When you want to provide trace files please turn on trac

ing like this:

export SYNCML_TRACE = /path/to/log/dir
export SYNCML_LOG = /path/to/log/dir

Run the tool again with tracing enabled to get a trace (2

files in the log directory).

SEE ALSO

syncml-obex-client(1)

AUTHORS

This manual page was written for the Debian GNU/Linux

project by Matthias Jahn <jahn.matthias@freenet.de>. But it may

be used by other distributions.

syncml-http-server was written by Armin Bauer and the

OpenSync project

Armin Bauer <armin.bauer@desscon.com>0.4.1 syncml

http-server(1)