mirror of
https://git.kernel.org/pub/scm/bluetooth/bluez.git
synced 2025-01-11 22:13:22 +08:00
62 lines
1.7 KiB
Plaintext
62 lines
1.7 KiB
Plaintext
OBEX D-Bus Agent API description
|
|
********************************
|
|
|
|
|
|
Agent Manager hierarchy
|
|
=======================
|
|
|
|
Service org.bluez.obex
|
|
Interface org.bluez.obex.AgentManager1
|
|
Object path /org/bluez/obex
|
|
|
|
Methods void RegisterAgent(object agent)
|
|
|
|
Register an agent to request authorization of
|
|
the user to accept/reject objects. Object push
|
|
service needs to authorize each received object.
|
|
|
|
Possible errors: org.bluez.obex.Error.AlreadyExists
|
|
|
|
void UnregisterAgent(object agent)
|
|
|
|
This unregisters the agent that has been previously
|
|
registered. The object path parameter must match the
|
|
same value that has been used on registration.
|
|
|
|
Possible errors: org.bluez.obex.Error.DoesNotExist
|
|
|
|
|
|
Agent hierarchy
|
|
===============
|
|
|
|
Service unique name
|
|
Interface org.bluez.obex.Agent1
|
|
Object path freely definable
|
|
|
|
Methods void Release()
|
|
|
|
This method gets called when the service daemon
|
|
unregisters the agent. An agent can use it to do
|
|
cleanup tasks. There is no need to unregister the
|
|
agent, because when this method gets called it has
|
|
already been unregistered.
|
|
|
|
string AuthorizePush(object transfer)
|
|
|
|
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. The tranfer object will
|
|
contain a Filename property that contains the default
|
|
location and name that can be returned.
|
|
|
|
Possible errors: org.bluez.obex.Error.Rejected
|
|
org.bluez.obex.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.
|