Those will be used to allow/disallow of performing remote device reauthentication. --- doc/mgmt-api.txt | 105 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index 1e450e4..96603cd 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -1223,6 +1223,82 @@ Set Device ID Command Possible errors: Invalid Parameters Invalid Index +Set Reauthentication Policy Command +=================================== + + Command Code: 0x0029 + Controller Index: <non-controller> + Command Parameters: Policy (1 Octet) + Return Parameters: + + This command is used to change kernel policy regarding remote device + reauthentication. When remote device reports no link key presence while + kernel holds link key for this device action taken by kernel depends on + selected policy. + + The Policy parameter selects desired policy: + + 0x00 Disallow + 0x01 Ask for consent + 0x02 Reauthenticate without asking for consent + + By default 'Disconnect' policy is used. Selecting 'Ask for consent' + policy will result in emmiting 'Reauthentication Consent Event' if + circumstance described above occurs. + + This command generates a Command Complete event on success or + a Command Status event on failure. + + Possible errors: Invalid Parameters + +Reauthentication Consent Reply Command +====================================== + + Command Code: 0x002A + Controller Index: <controller id> + Command Parameters: Address (6 Octets) + Address_Type (1 Octet) + Return Parameters: Address (6 Octets) + Address_Type (1 Octet) + + This command is used to respond to a Reauthentication Consent event. + This will result in current link key being removed by kernel and new + authentication process will start. + + This command can only be used when the controller is powered. + + This command generates a Command Complete event on success + or failure. + + Possible errors: Not Connected + Invalid Parameters + Not Powered + Invalid Index + Failed + +Reauthentication Consent Negative Reply Command +=============================================== + + Command Code: 0x002B + Controller Index: <controller id> + Command Parameters: Address (6 Octets) + Address_Type (1 Octet) + Return Parameters: Address (6 Octets) + Address_Type (1 Octet) + + This command is used to return a negative response to a Reauthentication + Consent event. + + This command can only be used when the controller is powered. + + This command generates a Command Complete event on success + or failure. + + Possible errors: Not Connected + Invalid Parameters + Not Powered + Invalid Index + Failed Command Complete Event ====================== @@ -1621,3 +1697,32 @@ Event Parameters Address (6 Octets) The Passkey parameter indicates the passkey to be shown to the user whereas the Entered parameter indicates how many characters the user has entered on the remote side. + +Reauthentication Consent Event +============================== + +Event Code 0x0018 +Controller Index <controller id> +Event Parameters Address (6 Octets) + Address_Type (1 Octet) + + This event is used to request a consent for reauthentication. It is + emmited when remote device reports no link key presence while kernel + holds link key and reuthentication policy for this device is set to + 'Ask for consent'. + + User space should respond to this command either using the + Reauthentication Consent Reply or the Reauthentication Consent Negative + Reply command. + +Reauthentication Policy Changed Event +===================================== + +Event Code 0x0019 +Controller Index <non-controller> +Event Parameters Policy (1 Octet) + + This event indicates that reauthentication policy has been changed + using Set Reauthentication Policy command. The event will only be sent + to Management sockets other than the one through which the command was + sent. -- 1.7.10.4 -- To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
