summaryrefslogtreecommitdiff
path: root/contrib/obexd-api-0.34-fixed/agent-api.txt
blob: e3dbc781aba27a82a3771772d5b6e57abdc20d80 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
obexd Agent API description
**********************************

Copyright (C) 2007-2010  Nokia Corporation
Copyright (C) 2007-2010  Marcel Holtmann <marcel@holtmann.org>


Agent hierarchy
===============

Service		unique name
Interface	org.openobex.Agent
Object path	freely definable

Methods
		string Authorize(object transfer, string bt_address, string name, string type, int32 length, int32 time)

			This method gets called when the service daemon
			needs to accept/reject a Bluetooth object push request.
			Returns the full path (including the filename) where
			the object shall be stored.

			Possible errors: org.openobex.Error.Rejected
			                 org.openobex.Error.Canceled

		void Cancel()

			This method gets called to indicate that the agent
			request failed before a reply was returned. It cancels
			the previous request.