summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorClaudio Takahasi <claudio.takahasi@openbossa.org>2007-04-20 18:48:24 +0000
committerClaudio Takahasi <claudio.takahasi@openbossa.org>2007-04-20 18:48:24 +0000
commitc21f025d74b88463759c4e383fe93000f351913e (patch)
treedeade430631e424a58960b8a71166402ab45dfee
parentf6e734a152c82885d39a2a3563dd581a6d41deb2 (diff)
GetRemoteName must return the cached name only or not available error when it is called outside the scope of DiscoverDevices.
-rw-r--r--hcid/dbus-api.txt23
1 files changed, 13 insertions, 10 deletions
diff --git a/hcid/dbus-api.txt b/hcid/dbus-api.txt
index 5d21b53b..42aad463 100644
--- a/hcid/dbus-api.txt
+++ b/hcid/dbus-api.txt
@@ -610,16 +610,18 @@ Methods dict GetInfo()
string GetRemoteName(string address)
- Get adapter name for a remote device. This request
- returns always a cached name. The service daemon is
- responsible for updating the cache.
-
- If no remote name is available, then this function
- will return RequestDeferred. In this case the service
- daemon will try to resolve the name at the next
- possible opportunity. On success a RemoteNameUpdated
- signal will be send and if a failure happens it will
- be indicated by a RemoteNameFailed signal.
+ Get the remote device's name. This request returns always
+ a cached name. The service daemon is responsible for
+ updating the cache.
+
+ NotAvailable error is returned if the name is not in
+ the cache. But if there is a discovery running, then
+ this function will return RequestDeferred. In this
+ case the service daemon will queue the request and
+ it will try to resolve the name at the next possible
+ opportunity. On success a RemoteNameUpdated signal will
+ be send and if a failure happens it will be indicated by
+ a RemoteNameFailed signal.
If this is an empty string, the UI might want to
display the BD_ADDR instead.
@@ -627,6 +629,7 @@ Methods dict GetInfo()
Example: "00:11:22:33:44:55", "Nokia 770"
Possible errors: org.bluez.Error.InvalidArguments
+ org.bluez.Error.NotAvailable
org.bluez.Error.NotReady
org.bluez.Error.RequestDeferred