upgrade obexd to 0.47
[profile/ivi/obexd.git] / doc / agent-api.txt
1 obexd Agent API description
2 **********************************
3
4 Copyright (C) 2007-2010  Nokia Corporation
5 Copyright (C) 2007-2010  Marcel Holtmann <marcel@holtmann.org>
6
7
8 Agent hierarchy
9 ===============
10
11 Service         unique name
12 Interface       org.bluez.obex.Agent
13 Object path     freely definable
14
15 Methods
16                 string Authorize(object transfer, string bt_address, string name,
17                                         string type, int32 length, int32 time)
18
19                         This method gets called when the service daemon
20                         needs to accept/reject a Bluetooth object push request.
21                         Returns the full path (including the filename) where
22                         the object shall be stored.
23
24                         Possible errors: org.bluez.obex.Error.Rejected
25                                          org.bluez.obex.Error.Canceled
26
27                 void Cancel()
28
29                         This method gets called to indicate that the agent
30                         request failed before a reply was returned. It cancels
31                         the previous request.