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

staging: gasket: ioctl: 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 f975c995
...@@ -170,14 +170,7 @@ long gasket_is_supported_ioctl(uint cmd) ...@@ -170,14 +170,7 @@ long gasket_is_supported_ioctl(uint cmd)
} }
} }
/* /* Check permissions for Gasket ioctls. */
* Permission checker for Gasket ioctls.
* @filp: File structure pointer describing this node usage session.
* @cmd: ioctl number to handle.
*
* Check permissions for Gasket ioctls.
* Returns true if the file opener may execute this ioctl, or false otherwise.
*/
static bool gasket_ioctl_check_permissions(struct file *filp, uint cmd) static bool gasket_ioctl_check_permissions(struct file *filp, uint cmd)
{ {
bool alive; bool alive;
...@@ -218,11 +211,7 @@ static bool gasket_ioctl_check_permissions(struct file *filp, uint cmd) ...@@ -218,11 +211,7 @@ static bool gasket_ioctl_check_permissions(struct file *filp, uint cmd)
return false; /* unknown permissions */ return false; /* unknown permissions */
} }
/* /* Associate an eventfd with an interrupt. */
* Associate an eventfd with an interrupt.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to gasket_interrupt_eventfd struct in userspace.
*/
static int gasket_set_event_fd(struct gasket_dev *gasket_dev, static int gasket_set_event_fd(struct gasket_dev *gasket_dev,
struct gasket_interrupt_eventfd __user *argp) struct gasket_interrupt_eventfd __user *argp)
{ {
...@@ -237,11 +226,7 @@ static int gasket_set_event_fd(struct gasket_dev *gasket_dev, ...@@ -237,11 +226,7 @@ static int gasket_set_event_fd(struct gasket_dev *gasket_dev,
gasket_dev->interrupt_data, die.interrupt, die.event_fd); gasket_dev->interrupt_data, die.interrupt, die.event_fd);
} }
/* /* Read the size of the page table. */
* Reads the size of the page table.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to gasket_page_table_ioctl struct in userspace.
*/
static int gasket_read_page_table_size( static int gasket_read_page_table_size(
struct gasket_dev *gasket_dev, struct gasket_dev *gasket_dev,
struct gasket_page_table_ioctl __user *argp) struct gasket_page_table_ioctl __user *argp)
...@@ -268,11 +253,7 @@ static int gasket_read_page_table_size( ...@@ -268,11 +253,7 @@ static int gasket_read_page_table_size(
return ret; return ret;
} }
/* /* Read the size of the simple page table. */
* Reads the size of the simple page table.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to gasket_page_table_ioctl struct in userspace.
*/
static int gasket_read_simple_page_table_size( static int gasket_read_simple_page_table_size(
struct gasket_dev *gasket_dev, struct gasket_dev *gasket_dev,
struct gasket_page_table_ioctl __user *argp) struct gasket_page_table_ioctl __user *argp)
...@@ -299,11 +280,7 @@ static int gasket_read_simple_page_table_size( ...@@ -299,11 +280,7 @@ static int gasket_read_simple_page_table_size(
return ret; return ret;
} }
/* /* Set the boundary between the simple and extended page tables. */
* Sets the boundary between the simple and extended page tables.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to gasket_page_table_ioctl struct in userspace.
*/
static int gasket_partition_page_table( static int gasket_partition_page_table(
struct gasket_dev *gasket_dev, struct gasket_dev *gasket_dev,
struct gasket_page_table_ioctl __user *argp) struct gasket_page_table_ioctl __user *argp)
...@@ -340,11 +317,7 @@ static int gasket_partition_page_table( ...@@ -340,11 +317,7 @@ static int gasket_partition_page_table(
return ret; return ret;
} }
/* /* Map a userspace buffer to a device virtual address. */
* Maps a userspace buffer to a device virtual address.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to a gasket_page_table_ioctl struct in userspace.
*/
static int gasket_map_buffers(struct gasket_dev *gasket_dev, static int gasket_map_buffers(struct gasket_dev *gasket_dev,
struct gasket_page_table_ioctl __user *argp) struct gasket_page_table_ioctl __user *argp)
{ {
...@@ -370,11 +343,7 @@ static int gasket_map_buffers(struct gasket_dev *gasket_dev, ...@@ -370,11 +343,7 @@ static int gasket_map_buffers(struct gasket_dev *gasket_dev,
ibuf.host_address, ibuf.device_address, ibuf.size / PAGE_SIZE); ibuf.host_address, ibuf.device_address, ibuf.size / PAGE_SIZE);
} }
/* /* Unmap a userspace buffer from a device virtual address. */
* Unmaps a userspace buffer from a device virtual address.
* @gasket_dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to a gasket_page_table_ioctl struct in userspace.
*/
static int gasket_unmap_buffers(struct gasket_dev *gasket_dev, static int gasket_unmap_buffers(struct gasket_dev *gasket_dev,
struct gasket_page_table_ioctl __user *argp) struct gasket_page_table_ioctl __user *argp)
{ {
...@@ -402,10 +371,8 @@ static int gasket_unmap_buffers(struct gasket_dev *gasket_dev, ...@@ -402,10 +371,8 @@ static int gasket_unmap_buffers(struct gasket_dev *gasket_dev,
} }
/* /*
* Tell the driver to reserve structures for coherent allocation, and allocate * Reserve structures for coherent allocation, and allocate or free the
* or free the corresponding memory. * corresponding memory.
* @dev: Pointer to the current gasket_dev we're using.
* @argp: Pointer to a gasket_coherent_alloc_config_ioctl struct in userspace.
*/ */
static int gasket_config_coherent_allocator( static int gasket_config_coherent_allocator(
struct gasket_dev *gasket_dev, struct gasket_dev *gasket_dev,
......
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