Docs: Changes to source.android.com

  - 175558266 Add left nav to advisory by Danielle Roberts <daroberts@google.com>
  - 175554955 Fix malformed reference to AOSP by Clay Murphy <claym@google.com>
  - 175550240 Devsite localized content from translation request 7a0693... by Android Partner Docs <noreply@android.com>
  - 175549114 Typo fix (ASOP -> AOSP) by Christina Nguyen <cqn@google.com>
  - 175293154 Devsite localized content from translation request 372f6d... by Android Partner Docs <noreply@android.com>
  - 175248838 Devsite localized content from translation request 29d8af... by Android Partner Docs <noreply@android.com>
  - 175218477 Clarify information about update_verifier and care_map.txt. by Christina Nguyen <cqn@google.com>
  - 175207560 Adding android common kernel details by Heidi von Markham <hvm@google.com>
  - 175185286 Add November Security bulletins to home page by Danielle Roberts <daroberts@google.com>
  - 175055180 Add AOSP links to Android and Pixel security bulletins by Danielle Roberts <daroberts@google.com>
  - 175042468 updated researcher acknowledgments by Android Partner Docs <noreply@android.com>
  - 175015511 Devsite localized content from translation request 9104ad... by Android Partner Docs <noreply@android.com>
  - 175015506 Devsite localized content from translation request bd87ac... by Android Partner Docs <noreply@android.com>
  - 174885954 Update build numbers for Nov 2017 EMR releases by Android Partner Docs <noreply@android.com>
  - 174874043 Devsite localized content from translation request 76c64c... by Android Partner Docs <noreply@android.com>
  - 174773244 Update build numbers for Nov 2017 releases by Android Partner Docs <noreply@android.com>
  - 174726959 Add FunctionFS support to Architecture section of Site Up... by Clay Murphy <claym@google.com>
  - 174724840 November Pixel/ Nexus & Android security bulletins by Danielle Roberts <daroberts@google.com>
  - 174719013 Updating link for reporting security vulns on Android by Android Partner Docs <noreply@android.com>
  - 174704161 Devsite localized content from translation request 937e48... by Android Partner Docs <noreply@android.com>
  - 174704153 Devsite localized content from translation request 9112c5... by Android Partner Docs <noreply@android.com>
  - 174528053 Devsite localized content from translation request 6e449c... by Android Partner Docs <noreply@android.com>
  - 174487952 Add outstanding updates to home page and Site Updates by Clay Murphy <claym@google.com>
  - 174475927 Add description how to build userspace HAL for neonkey by Android Partner Docs <noreply@android.com>
  - 174380489 Devsite localized content from translation request 841fb1... by Android Partner Docs <noreply@android.com>
  - 174380480 Devsite localized content from translation request 9eb492... by Android Partner Docs <noreply@android.com>
  - 174380476 Devsite localized content from translation request 04daa4... by Android Partner Docs <noreply@android.com>
  - 174248031 Update documentation to talk about retry vs. no-retry APIs. by Android Partner Docs <noreply@android.com>
  - 174202686 Update CTS/CTS-Verifier download links for CTS-Nov-2017 R... by Android Partner Docs <noreply@android.com>
  - 174116481 Devsite localized content from translation request 9299f0... by Android Partner Docs <noreply@android.com>
  - 174116372 Devsite localized content from translation request 6491d8... by Android Partner Docs <noreply@android.com>
  - 174099937 Include Nougat MR1 and Oreo branch information in release... by Android Partner Docs <noreply@android.com>
  - 174083954 Fixed some formatting and grammatical issues. by Christina Nguyen <cqn@google.com>
  - 174079046 Add devsite-click-to-copy and devsite-terminal classes by Christina Nguyen <cqn@google.com>
  - 174066120 Fix some terminal and click-to-copy classes by Christina Nguyen <cqn@google.com>
  - 173967954 Remove optional "function" keyword as discussed in b/6788... by Christina Nguyen <cqn@google.com>
  - 173952142 Escape a character so that Gerrit reads HTML properly. by Christina Nguyen <cqn@google.com>
  - 173951380 Update overview page and separated out non-a/b device upd... by Christina Nguyen <cqn@google.com>

PiperOrigin-RevId: 175558266
Change-Id: I413bc55681f23979b36d84ded9b012486988421b

1 files changed, 14 insertions, 0 deletions

diff --git a/en/devices/architecture/hidl/services.html b/en/devices/architecture/hidl/services.html
index 647555b7..75933ec9 100644
--- a/en/devices/architecture/hidl/services.html
+++ b/en/devices/architecture/hidl/services.html
@@ -51,8 +51,12 @@ into the server.</p>
 version, calling <code>getService</code> on the desired HAL class:</p>
 
 <pre class="prettyprint">
+// C++
 sp&lt;V1_1::IFooService&gt; service = V1_1::IFooService::getService();
 sp&lt;V1_1::IFooService&gt; alternateService = 1_1::IFooService::getService("another_foo_service");
+// Java
+V1_1.IFooService; service = V1_1.IFooService.getService(true /* retry */);
+V1_1.IFooService; alternateService = 1_1.IFooService.getService("another", true /* retry */);
 </pre>
 
 <p>Each version of a HIDL interface is treated as a separate interface. Thus,
@@ -69,6 +73,16 @@ returned interface. For an interface <code>IFoo</code> in package
 <code>android.hardware.foo</code> in the device manifest if the entry exists;
 and if the transport method is not available, nullptr is returned.</p>
 
+<p> In some cases, it may be necessary to continue immediately even without
+getting the service. This can happen (for instance) when a client wants to
+manage service notifications itself or in a diagnostic program (such as
+<code>atrace</code>) which needs to get all hwservices and retrieve them. In
+this case, additional APIs are provided such as <code>tryGetService</code> in C++ or
+<code>getService("instance-name", false)</code> in Java. The legacy API
+<code>getService</code> provided in Java also must be used with service
+notifications. Using this API does not avoid the race condition where a server
+registers itself after the client requests it with one of these no-retry APIs.</p>
+
 <h2 id=death>Service death notifications</h2>
 <p>Clients who want to be notified when a service dies can receive death
 notifications delivered by the framework. To receive notifications, the client