syncml-http-server(1)						       libs						     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 device 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 session.

       [--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 automati-
       cally if needed.

TROUBLESHOOTING

       If it does not work try the following:
	- Change the name of the database ("Contacts" and "Calendar" 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 tracing 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)