PCI: hv: Document missing hv_pci_protocol_negotiation() parameter
Subsystems (4)
PATCH 1/1 PCI: hv: Document missing hv_pci_protocol_negotiation() parameter
Add missing documentation for the parameter "version" and "num_version" of the hv_pci_protocol_negotiation() function and resolve build time kernel-doc warnings:
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'version' not described in 'hv_pci_protocol_negotiation'
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'num_version' not described in 'hv_pci_protocol_negotiation'
No change to functionality intended.
--- drivers/pci/controller/pci-hyperv.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
drivers/pci/controller/pci-hyperv.c +4 -1
@@ -2515,7 +2515,10 @@ static void hv_pci_onchannelcallback(void *context)/** * hv_pci_protocol_negotiation() - Set up protocol -* @hdev: VMBus's tracking struct for this root PCI bus +* @hdev: VMBus's tracking struct for this root PCI bus. +* @version: Array of supported channel protocol versions in +* the order of probing - highest go first. +* @num_version: Number of elements in the version array. * * This driver is intended to support running on Windows 10 * (server) and later versions. It will not run on earlier
Signature · 1 line
2.28.0
From: Krzysztof Wilczyński <[email protected]> Sent: Friday, September 25, 2020 4:48 PM
Quoted 40 lines
To: KY Srinivasan <[email protected]>
Cc: Haiyang Zhang <[email protected]>; Stephen Hemminger <[email protected]>; Wei Liu <[email protected]>; Bjorn Helgaas <[email protected]>; [email protected]; [email protected]
Subject: [PATCH] PCI: hv: Document missinghv_pci_protocol_negotiation()parameterAdd missing documentation for the parameter "version" and "
num_version" of thehv_pci_protocol_negotiation()function and resolve build time kernel-doc warnings:
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'version' not described in 'hv_pci_protocol_negotiation'
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'num_version' not described in 'hv_pci_protocol_negotiation'No change to functionality intended.
Signed-off-by Krzysztof Wilczyński <[email protected]>--- drivers/pci/controller/pci-hyperv.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)drivers/pci/controller/pci-hyperv.c +4
-2@@ -2515,7 +2515,10 @@ static void hv_pci_onchannelcallback(void *context)/** * hv_pci_protocol_negotiation() - Set up protocol -* @hdev: VMBus's tracking struct for this root PCI bus +* @hdev: VMBus's tracking struct for this root PCI bus. +* @version: Array of supported channel protocol versions in +* the order of probing - highest go first. +* @num_version: Number of elements in the version array. * * This driver is intended to support running on Windows 10 * (server) and later versions. It will not run on earlier --
Quoted 1 line
2.28.0
Quoted 7 lines · Krzysztof Wilczyński
Add missing documentation for the parameter "version" and "
num_version" of thehv_pci_protocol_negotiation()function and resolve build time kernel-doc warnings:
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'version' not described in 'hv_pci_protocol_negotiation'
Quoted 6 lines
drivers/pci/controller/pci-hyperv.c:2535: warning: Function parameter or member 'num_version' not described in 'hv_pci_protocol_negotiation'No change to functionality intended.
Signed-off-by Krzysztof Wilczyński <[email protected]>
Applied to hyperv-next. Thanks.