[RFC 1/2] doc: Add reauthentication commands and event to Management API

[Szymon Janc <szymon.janc@gmail.com>]

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