korg/linux
0
0
Fork 0
mirror of https://mirrors.bfsu.edu.cn/git/linux.git synced 2024-12-25 12:04:46 +08:00
Code Issues Packages Projects Releases Wiki Activity

tty: whitespaces in descriptions corrected by replacing tabs with spaces

Browse Source 
Tabs were used in the function description, to make this look more
uniform, the tabs were replaced by spaces where necessary.

While we're at it, I also replaced the 'ndashes' with simple dashes, since
only those are supported by sphinx.

Reviewed-by: Jiri Slaby <jirislaby@kernel.org>
Signed-off-by: Florian Eckert <fe@dev.tdt.de>
Link: https://lore.kernel.org/r/20231019112809.881730-2-fe@dev.tdt.de
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Florian Eckert 2023-10-19 13:28:07 +02:00 committed by Greg Kroah-Hartman
parent 4bebd64497
commit 838eb763c3
1 changed files with 47 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

94
drivers/tty/tty_io.c
View File

@ -159,7 +159,7 @@ static int tty_fasync(int fd, struct file *filp, int on);
static void release_tty(struct tty_struct *tty, int idx); static void release_tty(struct tty_struct *tty, int idx);
/** /**
* free_tty_struct - free a disused tty * free_tty_struct - free a disused tty
* @tty: tty struct to free * @tty: tty struct to free
* *
* Free the write buffers, tty queue and tty memory itself. * Free the write buffers, tty queue and tty memory itself.
@ -233,7 +233,7 @@ static void tty_del_file(struct file *file)
} }
/** /**
* tty_name - return tty naming * tty_name - return tty naming
* @tty: tty structure * @tty: tty structure
* *
* Convert a tty structure into a name. The name reflects the kernel naming * Convert a tty structure into a name. The name reflects the kernel naming
@ -295,7 +295,7 @@ static void check_tty_count(struct tty_struct *tty, const char *routine)
} }
/** /**
* get_tty_driver - find device of a tty * get_tty_driver - find device of a tty
* @device: device identifier * @device: device identifier
* @index: returns the index of the tty * @index: returns the index of the tty
* *
@ -320,7 +320,7 @@ static struct tty_driver *get_tty_driver(dev_t device, int *index)
} }
/** /**
* tty_dev_name_to_number - return dev_t for device name * tty_dev_name_to_number - return dev_t for device name
* @name: user space name of device under /dev * @name: user space name of device under /dev
* @number: pointer to dev_t that this function will populate * @number: pointer to dev_t that this function will populate
* *
@ -372,7 +372,7 @@ EXPORT_SYMBOL_GPL(tty_dev_name_to_number);
#ifdef CONFIG_CONSOLE_POLL #ifdef CONFIG_CONSOLE_POLL
/** /**
* tty_find_polling_driver - find device of a polled tty * tty_find_polling_driver - find device of a polled tty
* @name: name string to match * @name: name string to match
* @line: pointer to resulting tty line nr * @line: pointer to resulting tty line nr
* *
@ -505,7 +505,7 @@ static DEFINE_SPINLOCK(redirect_lock);
static struct file *redirect; static struct file *redirect;
/** /**
* tty_wakeup - request more data * tty_wakeup - request more data
* @tty: terminal * @tty: terminal
* *
* Internal and external helper for wakeups of tty. This function informs the * Internal and external helper for wakeups of tty. This function informs the
@ -529,7 +529,7 @@ void tty_wakeup(struct tty_struct *tty)
EXPORT_SYMBOL_GPL(tty_wakeup); EXPORT_SYMBOL_GPL(tty_wakeup);
/** /**
* tty_release_redirect - Release a redirect on a pty if present * tty_release_redirect - Release a redirect on a pty if present
* @tty: tty device * @tty: tty device
* *
* This is available to the pty code so if the master closes, if the slave is a * This is available to the pty code so if the master closes, if the slave is a
@ -550,7 +550,7 @@ static struct file *tty_release_redirect(struct tty_struct *tty)
} }
/** /**
* __tty_hangup - actual handler for hangup events * __tty_hangup - actual handler for hangup events
* @tty: tty device * @tty: tty device
* @exit_session: if non-zero, signal all foreground group processes * @exit_session: if non-zero, signal all foreground group processes
* *
@ -673,7 +673,7 @@ static void do_tty_hangup(struct work_struct *work)
} }
/** /**
* tty_hangup - trigger a hangup event * tty_hangup - trigger a hangup event
* @tty: tty to hangup * @tty: tty to hangup
* *
* A carrier loss (virtual or otherwise) has occurred on @tty. Schedule a * A carrier loss (virtual or otherwise) has occurred on @tty. Schedule a
@ -687,7 +687,7 @@ void tty_hangup(struct tty_struct *tty)
EXPORT_SYMBOL(tty_hangup); EXPORT_SYMBOL(tty_hangup);
/** /**
* tty_vhangup - process vhangup * tty_vhangup - process vhangup
* @tty: tty to hangup * @tty: tty to hangup
* *
* The user has asked via system call for the terminal to be hung up. We do * The user has asked via system call for the terminal to be hung up. We do
@ -703,7 +703,7 @@ EXPORT_SYMBOL(tty_vhangup);
/** /**
* tty_vhangup_self - process vhangup for own ctty * tty_vhangup_self - process vhangup for own ctty
* *
* Perform a vhangup on the current controlling tty * Perform a vhangup on the current controlling tty
*/ */
@ -719,7 +719,7 @@ void tty_vhangup_self(void)
} }
/** /**
* tty_vhangup_session - hangup session leader exit * tty_vhangup_session - hangup session leader exit
* @tty: tty to hangup * @tty: tty to hangup
* *
* The session leader is exiting and hanging up its controlling terminal. * The session leader is exiting and hanging up its controlling terminal.
@ -735,7 +735,7 @@ void tty_vhangup_session(struct tty_struct *tty)
} }
/** /**
* tty_hung_up_p - was tty hung up * tty_hung_up_p - was tty hung up
* @filp: file pointer of tty * @filp: file pointer of tty
* *
* Return: true if the tty has been subject to a vhangup or a carrier loss * Return: true if the tty has been subject to a vhangup or a carrier loss
@ -756,7 +756,7 @@ void __stop_tty(struct tty_struct *tty)
} }
/** /**
* stop_tty - propagate flow control * stop_tty - propagate flow control
* @tty: tty to stop * @tty: tty to stop
* *
* Perform flow control to the driver. May be called on an already stopped * Perform flow control to the driver. May be called on an already stopped
@ -790,7 +790,7 @@ void __start_tty(struct tty_struct *tty)
} }
/** /**
* start_tty - propagate flow control * start_tty - propagate flow control
* @tty: tty to start * @tty: tty to start
* *
* Start a tty that has been stopped if at all possible. If @tty was previously * Start a tty that has been stopped if at all possible. If @tty was previously
@ -898,7 +898,7 @@ static ssize_t iterate_tty_read(struct tty_ldisc *ld, struct tty_struct *tty,
/** /**
* tty_read - read method for tty device files * tty_read - read method for tty device files
* @iocb: kernel I/O control block * @iocb: kernel I/O control block
* @to: destination for the data read * @to: destination for the data read
* *
@ -1091,7 +1091,7 @@ static ssize_t file_tty_write(struct file *file, struct kiocb *iocb, struct iov_
} }
/** /**
* tty_write - write method for tty device file * tty_write - write method for tty device file
* @iocb: kernel I/O control block * @iocb: kernel I/O control block
* @from: iov_iter with data to write * @from: iov_iter with data to write
* *
@ -1133,7 +1133,7 @@ ssize_t redirected_tty_write(struct kiocb *iocb, struct iov_iter *iter)
} }
/** /**
* tty_send_xchar - send priority character * tty_send_xchar - send priority character
* @tty: the tty to send to * @tty: the tty to send to
* @ch: xchar to send * @ch: xchar to send
* *
@ -1167,7 +1167,7 @@ int tty_send_xchar(struct tty_struct *tty, char ch)
} }
/** /**
* pty_line_name - generate name for a pty * pty_line_name - generate name for a pty
* @driver: the tty driver in use * @driver: the tty driver in use
* @index: the minor number * @index: the minor number
* @p: output buffer of at least 6 bytes * @p: output buffer of at least 6 bytes
@ -1188,7 +1188,7 @@ static void pty_line_name(struct tty_driver *driver, int index, char *p)
} }
/** /**
* tty_line_name - generate name for a tty * tty_line_name - generate name for a tty
* @driver: the tty driver in use * @driver: the tty driver in use
* @index: the minor number * @index: the minor number
* @p: output buffer of at least 7 bytes * @p: output buffer of at least 7 bytes
@ -1239,7 +1239,7 @@ static struct tty_struct *tty_driver_lookup_tty(struct tty_driver *driver,
} }
/** /**
* tty_init_termios - helper for termios setup * tty_init_termios - helper for termios setup
* @tty: the tty to set up * @tty: the tty to set up
* *
* Initialise the termios structure for this tty. This runs under the * Initialise the termios structure for this tty. This runs under the
@ -1322,7 +1322,7 @@ static void tty_driver_remove_tty(struct tty_driver *driver, struct tty_struct *
} }
/** /**
* tty_reopen() - fast re-open of an open tty * tty_reopen() - fast re-open of an open tty
* @tty: the tty to open * @tty: the tty to open
* *
* Re-opens on master ptys are not allowed and return -%EIO. * Re-opens on master ptys are not allowed and return -%EIO.
@ -1366,7 +1366,7 @@ static int tty_reopen(struct tty_struct *tty)
} }
/** /**
* tty_init_dev - initialise a tty device * tty_init_dev - initialise a tty device
* @driver: tty driver we are opening a device on * @driver: tty driver we are opening a device on
* @idx: device index * @idx: device index
* *
@ -1488,7 +1488,7 @@ void tty_save_termios(struct tty_struct *tty)
EXPORT_SYMBOL_GPL(tty_save_termios); EXPORT_SYMBOL_GPL(tty_save_termios);
/** /**
* tty_flush_works - flush all works of a tty/pty pair * tty_flush_works - flush all works of a tty/pty pair
* @tty: tty device to flush works for (or either end of a pty pair) * @tty: tty device to flush works for (or either end of a pty pair)
* *
* Sync flush all works belonging to @tty (and the 'other' tty). * Sync flush all works belonging to @tty (and the 'other' tty).
@ -1504,7 +1504,7 @@ static void tty_flush_works(struct tty_struct *tty)
} }
/** /**
* release_one_tty - release tty structure memory * release_one_tty - release tty structure memory
* @work: work of tty we are obliterating * @work: work of tty we are obliterating
* *
* Releases memory associated with a tty structure, and clears out the * Releases memory associated with a tty structure, and clears out the
@ -1552,7 +1552,7 @@ static void queue_release_one_tty(struct kref *kref)
} }
/** /**
* tty_kref_put - release a tty kref * tty_kref_put - release a tty kref
* @tty: tty device * @tty: tty device
* *
* Release a reference to the @tty device and if need be let the kref layer * Release a reference to the @tty device and if need be let the kref layer
@ -1566,7 +1566,7 @@ void tty_kref_put(struct tty_struct *tty)
EXPORT_SYMBOL(tty_kref_put); EXPORT_SYMBOL(tty_kref_put);
/** /**
* release_tty - release tty structure memory * release_tty - release tty structure memory
* @tty: tty device release * @tty: tty device release
* @idx: index of the tty device release * @idx: index of the tty device release
* *
@ -1643,7 +1643,7 @@ static int tty_release_checks(struct tty_struct *tty, int idx)
} }
/** /**
* tty_kclose - closes tty opened by tty_kopen * tty_kclose - closes tty opened by tty_kopen
* @tty: tty device * @tty: tty device
* *
* Performs the final steps to release and free a tty device. It is the same as * Performs the final steps to release and free a tty device. It is the same as
@ -1673,7 +1673,7 @@ void tty_kclose(struct tty_struct *tty)
EXPORT_SYMBOL_GPL(tty_kclose); EXPORT_SYMBOL_GPL(tty_kclose);
/** /**
* tty_release_struct - release a tty struct * tty_release_struct - release a tty struct
* @tty: tty device * @tty: tty device
* @idx: index of the tty * @idx: index of the tty
* *
@ -1702,7 +1702,7 @@ void tty_release_struct(struct tty_struct *tty, int idx)
EXPORT_SYMBOL_GPL(tty_release_struct); EXPORT_SYMBOL_GPL(tty_release_struct);
/** /**
* tty_release - vfs callback for close * tty_release - vfs callback for close
* @inode: inode of tty * @inode: inode of tty
* @filp: file pointer for handle to tty * @filp: file pointer for handle to tty
* *
@ -1983,7 +1983,7 @@ out:
} }
/** /**
* tty_kopen_exclusive - open a tty device for kernel * tty_kopen_exclusive - open a tty device for kernel
* @device: dev_t of device to open * @device: dev_t of device to open
* *
* Opens tty exclusively for kernel. Performs the driver lookup, makes sure * Opens tty exclusively for kernel. Performs the driver lookup, makes sure
@ -2003,7 +2003,7 @@ struct tty_struct *tty_kopen_exclusive(dev_t device)
EXPORT_SYMBOL_GPL(tty_kopen_exclusive); EXPORT_SYMBOL_GPL(tty_kopen_exclusive);
/** /**
* tty_kopen_shared - open a tty device for shared in-kernel use * tty_kopen_shared - open a tty device for shared in-kernel use
* @device: dev_t of device to open * @device: dev_t of device to open
* *
* Opens an already existing tty for in-kernel use. Compared to * Opens an already existing tty for in-kernel use. Compared to
@ -2018,7 +2018,7 @@ struct tty_struct *tty_kopen_shared(dev_t device)
EXPORT_SYMBOL_GPL(tty_kopen_shared); EXPORT_SYMBOL_GPL(tty_kopen_shared);
/** /**
* tty_open_by_driver - open a tty device * tty_open_by_driver - open a tty device
* @device: dev_t of device to open * @device: dev_t of device to open
* @filp: file pointer to tty * @filp: file pointer to tty
* *
@ -2086,7 +2086,7 @@ out:
} }
/** /**
* tty_open - open a tty device * tty_open - open a tty device
* @inode: inode of device file * @inode: inode of device file
* @filp: file pointer to tty * @filp: file pointer to tty
* *
@ -2180,7 +2180,7 @@ retry_open:
/** /**
* tty_poll - check tty status * tty_poll - check tty status
* @filp: file being polled * @filp: file being polled
* @wait: poll wait structures to update * @wait: poll wait structures to update
* *
@ -2258,7 +2258,7 @@ static int tty_fasync(int fd, struct file *filp, int on)
static bool tty_legacy_tiocsti __read_mostly = IS_ENABLED(CONFIG_LEGACY_TIOCSTI); static bool tty_legacy_tiocsti __read_mostly = IS_ENABLED(CONFIG_LEGACY_TIOCSTI);
/** /**
* tiocsti - fake input character * tiocsti - fake input character
* @tty: tty to fake input into * @tty: tty to fake input into
* @p: pointer to character * @p: pointer to character
* *
@ -2295,7 +2295,7 @@ static int tiocsti(struct tty_struct *tty, char __user *p)
} }
/** /**
* tiocgwinsz - implement window query ioctl * tiocgwinsz - implement window query ioctl
* @tty: tty * @tty: tty
* @arg: user buffer for result * @arg: user buffer for result
* *
@ -2316,7 +2316,7 @@ static int tiocgwinsz(struct tty_struct *tty, struct winsize __user *arg)
} }
/** /**
* tty_do_resize - resize event * tty_do_resize - resize event
* @tty: tty being resized * @tty: tty being resized
* @ws: new dimensions * @ws: new dimensions
* *
@ -2346,7 +2346,7 @@ done:
EXPORT_SYMBOL(tty_do_resize); EXPORT_SYMBOL(tty_do_resize);
/** /**
* tiocswinsz - implement window size set ioctl * tiocswinsz - implement window size set ioctl
* @tty: tty side of tty * @tty: tty side of tty
* @arg: user buffer for result * @arg: user buffer for result
* *
@ -2373,7 +2373,7 @@ static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
} }
/** /**
* tioccons - allow admin to move logical console * tioccons - allow admin to move logical console
* @file: the file to become console * @file: the file to become console
* *
* Allow the administrator to move the redirected console device. * Allow the administrator to move the redirected console device.
@ -2412,7 +2412,7 @@ static int tioccons(struct file *file)
} }
/** /**
* tiocsetd - set line discipline * tiocsetd - set line discipline
* @tty: tty device * @tty: tty device
* @p: pointer to user data * @p: pointer to user data
* *
@ -2434,7 +2434,7 @@ static int tiocsetd(struct tty_struct *tty, int __user *p)
} }
/** /**
* tiocgetd - get line discipline * tiocgetd - get line discipline
* @tty: tty device * @tty: tty device
* @p: pointer to user data * @p: pointer to user data
* *
@ -2457,7 +2457,7 @@ static int tiocgetd(struct tty_struct *tty, int __user *p)
} }
/** /**
* send_break - performed time break * send_break - performed time break
* @tty: device to break on * @tty: device to break on
* @duration: timeout in mS * @duration: timeout in mS
* *
@ -2495,7 +2495,7 @@ static int send_break(struct tty_struct *tty, unsigned int duration)
} }
/** /**
* tty_tiocmget - get modem status * tty_tiocmget - get modem status
* @tty: tty device * @tty: tty device
* @p: pointer to result * @p: pointer to result
* *
@ -2518,7 +2518,7 @@ static int tty_tiocmget(struct tty_struct *tty, int __user *p)
} }
/** /**
* tty_tiocmset - set modem status * tty_tiocmset - set modem status
* @tty: tty device * @tty: tty device
* @cmd: command - clear bits, set bits or set all * @cmd: command - clear bits, set bits or set all
* @p: pointer to desired bits * @p: pointer to desired bits
@ -2559,7 +2559,7 @@ static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
} }
/** /**
* tty_get_icount - get tty statistics * tty_get_icount - get tty statistics
* @tty: tty device * @tty: tty device
* @icount: output parameter * @icount: output parameter
* *
@ -3122,7 +3122,7 @@ struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
} }
/** /**
* tty_put_char - write one character to a tty * tty_put_char - write one character to a tty
* @tty: tty * @tty: tty
* @ch: character to write * @ch: character to write
* *