diff options
| author | Claudio Takahasi <claudio.takahasi@openbossa.org> | 2007-04-20 18:48:24 +0000 |
|---|---|---|
| committer | Claudio Takahasi <claudio.takahasi@openbossa.org> | 2007-04-20 18:48:24 +0000 |
| commit | c21f025d74b88463759c4e383fe93000f351913e (patch) | |
| tree | deade430631e424a58960b8a71166402ab45dfee | |
| parent | f6e734a152c82885d39a2a3563dd581a6d41deb2 (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.txt | 23 |
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 |