From 4128c8eed3de6ffbb057145f20f420a6e92f4328 Mon Sep 17 00:00:00 2001
From: maheshkkv <maheshkkv@google.com>
Date: Wed, 26 Mar 2025 09:28:12 -0700
Subject: Update Aware pairing API documentation

Update the API documentation for isAwarePairingSupported() to include
details about supporting NAN pairing and all associated Aware R4
security features, as defined in Wi-Fi Aware Specification Version 4.0.

Bug: 406503442
Test: Build successfully
Flag: DOCS_ONLY
(cherry picked from https://googleplex-android-review.googlesource.com/q/commit:8cada2e3f646c7fec48d5ce1c5e13e486a8bc31e)
Merged-In: If34941ab44d68f783cd9215eef822d952d9cad55
Change-Id: If34941ab44d68f783cd9215eef822d952d9cad55
---
 .../java/android/net/wifi/aware/Characteristics.java    | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/framework/java/android/net/wifi/aware/Characteristics.java b/framework/java/android/net/wifi/aware/Characteristics.java
index 600739029d..37fc1702dd 100644
--- a/framework/java/android/net/wifi/aware/Characteristics.java
+++ b/framework/java/android/net/wifi/aware/Characteristics.java
@@ -183,9 +183,22 @@ public final class Characteristics implements Parcelable {
         return mCharacteristics.getBoolean(KEY_IS_INSTANT_COMMUNICATION_MODE_SUPPORTED);
     }
 
+
     /**
-     * Check if the Aware Pairing is supported. The Aware Pairing is defined as per Wi-Fi Alliance
-     * (WFA) Wi-Fi Aware specifications version 4.0 Section 7.6.
+     * Check if the Aware Pairing and all associated security features as defined in Wi-Fi Alliance
+     * (WFA) Wi-Fi Aware Specification version 4.0 are supported.
+     * This includes:
+     * <ol>
+     * <li>NAN Pairing (as in Wi-Fi Aware Specification Version 4.0 section 7.6) with NIK caching
+     * <li>NDP unicast data frame encryption (as in Wi-Fi Aware Specification Version 4.0 section
+     * 7.3.1)
+     * <li>Group addressed data frame encryption (as in Wi-Fi Aware Specification Version 4.0
+     * section 7.3.3)
+     * <li>Management frame protection (as in Wi-Fi Aware Specification Version 4.0 section 7.3.2
+     * for both unicast and multicast frames)
+     * <li>Beacon integrity protection (as in Wi-Fi Aware Specification Version 4.0 section 7.3.4)
+     * </ol>
+     *
      * @return True if supported, false otherwise.
      */
     public boolean isAwarePairingSupported() {
-- 
cgit v1.2.3-59-g8ed1b