Commit 2164242c authored by Randy Dunlap's avatar Randy Dunlap Committed by Jakub Kicinski
Browse files

NFC: fix header file kernel-doc warnings 



Repair some of the comments:
- use the correct enum names
- don't use "/**" for a non-kernel-doc comment

to fix these warnings:

Warning: include/uapi/linux/nfc.h:127 Excess enum value
 '@NFC_EVENT_DEVICE_DEACTIVATED' description in 'nfc_commands'
Warning: include/uapi/linux/nfc.h:204 Excess enum value
 '@NFC_ATTR_APDU' description in 'nfc_attrs'
Warning: include/uapi/linux/nfc.h:302 expecting prototype for Pseudo().
 Prototype was for NFC_RAW_HEADER_SIZE() instead

Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Link: https://patch.msgid.link/20260226221004.1037909-1-rdunlap@infradead.org


Signed-off-by: default avatarJakub Kicinski <kuba@kernel.org>
parent 6466441a

include/uapi/linux/nfc.h

+3 −3
Original line number Diff line number Diff line
@@ -55,7 +55,7 @@ 
 *	(it sends %NFC_ATTR_DEVICE_INDEX)

 * @NFC_EVENT_TM_ACTIVATED: event emitted when the adapter is activated in

 *      target mode.

 * @NFC_EVENT_DEVICE_DEACTIVATED: event emitted when the adapter is deactivated

 * @NFC_EVENT_TM_DEACTIVATED: event emitted when the adapter is deactivated

 *      from target mode.

 * @NFC_CMD_LLC_GET_PARAMS: request LTO, RW, and MIUX parameters for a device

 * @NFC_CMD_LLC_SET_PARAMS: set one or more of LTO, RW, and MIUX parameters for
@@ -156,7 +156,7 @@ enum nfc_commands { 
 * @NFC_ATTR_SE_INDEX: Secure element index

 * @NFC_ATTR_SE_TYPE: Secure element type (UICC or EMBEDDED)

 * @NFC_ATTR_FIRMWARE_DOWNLOAD_STATUS: Firmware download operation status

 * @NFC_ATTR_APDU: Secure element APDU

 * @NFC_ATTR_SE_APDU: Secure element APDU

 * @NFC_ATTR_TARGET_ISO15693_DSFID: ISO 15693 Data Storage Format Identifier

 * @NFC_ATTR_TARGET_ISO15693_UID: ISO 15693 Unique Identifier

 * @NFC_ATTR_SE_PARAMS: Parameters data from an evt_transaction
@@ -291,7 +291,7 @@ struct sockaddr_nfc_llcp { 


#define NFC_HEADER_SIZE 1



/**

/*

 * Pseudo-header info for raw socket packets

 * First byte is the adapter index

 * Second byte contains flags