syncml-http-server(1)

1syncml-http-server(1)                libs                syncml-http-server(1)
2
3
4

NAME

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

SYNTAX

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

DESCRIPTION

13       syncml-http-server  is  not  a real synchronization tool.  It is rather
14       used for testing.  The tool will list all entries that the device wants
15       to sync and is also capable of adding items to the device.
16

USAGE

18       If you want to display the contacts for example you could type:
19           syncml-http-server --sync text/x-vcard Contacts
20
21       The  --sync  options  states that you want to sync vcards and that your
22       local database is named "Contacts".  This example would send syncml  as
23       plain  xml.   The  tool  would then go into listening mode and wait for
24       incoming connections.  You then have to enter your ip address, port etc
25       on the device and start the sync.
26

OPTIONS

28       --sync <type> <path> Emulate a database of the given type on the url.
29
30       --slow-sync  <type>  <path> Emulate a database of the given type on the
31       url and use slow-sync
32
33              type should be a IANA registered mimetype or your own type.
34              Common types are:
35
36              - "text/x-vcard" for contacts,
37              - "text/x-vcalendar" for events,
38              - "text/plain" for notes and
39              - "text/x-vMessage" for SMS
40
41              path is the local name of the database. You can choose  anything
42              there.
43
44       --add  <type>  <path>   Add the file given in path to the device as the
45       given type
46
47              type should be a IANA registered mimetype or your own type.
48              Common types are:
49
50              - "text/x-vcard" for contacts,
51              - "text/x-vcalendar" for events,
52              - "text/plain" for notes and
53              - "text/x-vMessage" for SMS
54
55              path to the file to add. The file has to be a VCard,  VCalendar,
56              etc.
57
58       [--port <port number>]  Listen on this port for incoming connections
59
60       [--multi] Normally the tool exits after the first session ends.
61              By using this option you can use more than one session.
62
63       [--recvLimit  <limit>]  Limit  the size of the receiving buffer to this
64       size (Needed for some phones)
65
66       [--maxObjSize <limit>] The maximum size of a object that we can receive
67       (Needed for some phones)
68
69       [--useStringTable] Use wbxml string tables (Improves transmission size,
70       but not supported by some phones)
71
72       [--dumpinfo] Print info about the phone at the end which can be sent to
73       the developers
74

EXAMPLES

76       To run this program the standard way type:
77       syncml-http-server  --port  9999  --sync text/x-vcalendar events --sync
78       text/x-vcard addressbook --multi --san
79
80       Another example:
81       syncml-http-server --sync text/x-vcard Contacts --sync text/x-vcalendar
82       Calendar --port 9999
83
84       This  would  get  the  contacts  and the calendar entries (This example
85       works for a Nokia 6680).  It would also listen on  the  port  9999  for
86       incoming connections.  Note that you dont have to set wbxml explicitly.
87       libsyncml detects the incoming packets and sets wbxml automatically  if
88       needed.
89

TROUBLESHOOTING

91       If it does not work try the following:
92        -  Change  the  name of the database ("Contacts" and "Calendar" in the
93       example)
94        - Check with netstat -npa when the tool is running to see if the  port
95       is opened
96        - Use a network sniffer like ethereal to take a look at the data being
97       transmitted
98

ENVIRONMENT VARIABLES

100       When you want to provide trace files please turn on tracing like this:
101
102       export SYNCML_TRACE = /path/to/log/dir
103       export SYNCML_LOG = /path/to/log/dir
104
105       Run the tool again with tracing enabled to get a trace (2 files in  the
106       log directory).
107

AUTHORS

112       This  manual  page  was  written  for  the  Debian GNU/Linux project by
113       Matthias Jahn <jahn.matthias@freenet.de>.  But it may be used by  other
114       distributions.
115
116       syncml-http-server was written by Armin Bauer and the OpenSync project
117
118
119
120Armin Bauer <armin.bauer@desscon.com>0.4.1               syncml-http-server(1)