Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f680b284 authored by Guenter Roeck's avatar Guenter Roeck
Browse files

hwmon: (core) Clarify when read and write callbacks are mandatory 



The callback descrption in hwmon.h was misleading and stated that read and
write callbacks would be optional. More accurate is is that the callbacks
are mandatory if readable / writeable attributes are present.

Signed-off-by: default avatarGuenter Roeck <linux@roeck-us.net>
parent a2a0c3c5

include/linux/hwmon.h

+2 −4
Original line number Diff line number Diff line
@@ -298,8 +298,7 @@ enum hwmon_pwm_attributes { 
 *			Channel number

 *		The function returns the file permissions.

 *		If the return value is 0, no attribute will be created.

 * @read:       Read callback. Optional. If not provided, attributes

 *		will not be readable.

 * @read:	Read callback. Mandatory if readable attributes are present.

 *		Parameters are:

 *		@dev:	Pointer to hardware monitoring device

 *		@type:	Sensor type
@@ -308,8 +307,7 @@ enum hwmon_pwm_attributes { 
 *			Channel number

 *		@val:	Pointer to returned value

 *		The function returns 0 on success or a negative error number.

 * @write:	Write callback. Optional. If not provided, attributes

 *		will not be writable.

 * @write:	Write callback. Mandatory if writeable attributes are present.

 *		Parameters are:

 *		@dev:	Pointer to hardware monitoring device

 *		@type:	Sensor type