Commit cef73302 authored by Todd Poynor's avatar Todd Poynor Committed by Greg Kroah-Hartman

staging: gasket: sysfs: simplify comments for static functions

Static functions don't need kernel doc formatting, can be simplified.
Reformat comments that can be single-line.  Remove extraneous text.
Signed-off-by: default avatarTodd Poynor <toddpoynor@google.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent e4c4afa8
...@@ -47,22 +47,13 @@ struct gasket_sysfs_mapping { ...@@ -47,22 +47,13 @@ struct gasket_sysfs_mapping {
*/ */
static struct gasket_sysfs_mapping dev_mappings[GASKET_SYSFS_NUM_MAPPINGS]; static struct gasket_sysfs_mapping dev_mappings[GASKET_SYSFS_NUM_MAPPINGS];
/* /* Callback when a mapping's refcount goes to zero. */
* Callback when a mapping's refcount goes to zero.
* @ref: The reference count of the containing sysfs mapping.
*/
static void release_entry(struct kref *ref) static void release_entry(struct kref *ref)
{ {
/* All work is done after the return from kref_put. */ /* All work is done after the return from kref_put. */
} }
/* /* Look up mapping information for the given device. */
* Looks up mapping information for the given device.
* @device: The device whose mapping to look for.
*
* Looks up the requested device and takes a reference and returns it if found,
* and returns NULL otherwise.
*/
static struct gasket_sysfs_mapping *get_mapping(struct device *device) static struct gasket_sysfs_mapping *get_mapping(struct device *device)
{ {
int i; int i;
...@@ -82,17 +73,7 @@ static struct gasket_sysfs_mapping *get_mapping(struct device *device) ...@@ -82,17 +73,7 @@ static struct gasket_sysfs_mapping *get_mapping(struct device *device)
return NULL; return NULL;
} }
/* /* Put a reference to a mapping. */
* Returns a reference to a mapping.
* @mapping: The mapping we're returning.
*
* Decrements the refcount for the given mapping (if valid). If the refcount is
* zero, then it cleans up the mapping - in this function as opposed to the
* kref_put callback, due to a potential deadlock.
*
* Although put_mapping_n exists, this function is left here (as an implicit
* put_mapping_n(..., 1) for convenience.
*/
static void put_mapping(struct gasket_sysfs_mapping *mapping) static void put_mapping(struct gasket_sysfs_mapping *mapping)
{ {
int i; int i;
...@@ -140,8 +121,7 @@ static void put_mapping(struct gasket_sysfs_mapping *mapping) ...@@ -140,8 +121,7 @@ static void put_mapping(struct gasket_sysfs_mapping *mapping)
} }
/* /*
* Returns a reference N times. * Put a reference to a mapping N times.
* @mapping: The mapping to return.
* *
* In higher-level resource acquire/release function pairs, the release function * In higher-level resource acquire/release function pairs, the release function
* will need to release a mapping 2x - once for the refcount taken in the * will need to release a mapping 2x - once for the refcount taken in the
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment