mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-09-04 20:19:47 +08:00
b49a0ff732
Use __tty_insert_flip_string_flags() for the slow path of tty_insert_flip_char(). The former is generic enough, so there is no reason to reimplement the injection once again. So now we have a single function stuffing into tty buffers. Signed-off-by: "Jiri Slaby (SUSE)" <jirislaby@kernel.org> Link: https://lore.kernel.org/r/20230816105530.3335-8-jirislaby@kernel.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
50 lines
1.1 KiB
ReStructuredText
50 lines
1.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
==========
|
|
TTY Buffer
|
|
==========
|
|
|
|
.. contents:: :local:
|
|
|
|
Here, we document functions for taking care of tty buffer and their flipping.
|
|
Drivers are supposed to fill the buffer by one of those functions below and
|
|
then flip the buffer, so that the data are passed to :doc:`line discipline
|
|
<tty_ldisc>` for further processing.
|
|
|
|
Flip Buffer Management
|
|
======================
|
|
|
|
.. kernel-doc:: drivers/tty/tty_buffer.c
|
|
:identifiers: tty_prepare_flip_string
|
|
tty_flip_buffer_push tty_ldisc_receive_buf
|
|
|
|
.. kernel-doc:: include/linux/tty_flip.h
|
|
:identifiers: tty_insert_flip_string_fixed_flag tty_insert_flip_string_flags
|
|
tty_insert_flip_char
|
|
|
|
----
|
|
|
|
Other Functions
|
|
===============
|
|
|
|
.. kernel-doc:: drivers/tty/tty_buffer.c
|
|
:identifiers: tty_buffer_space_avail tty_buffer_set_limit
|
|
|
|
----
|
|
|
|
Buffer Locking
|
|
==============
|
|
|
|
These are used only in special circumstances. Avoid them.
|
|
|
|
.. kernel-doc:: drivers/tty/tty_buffer.c
|
|
:identifiers: tty_buffer_lock_exclusive tty_buffer_unlock_exclusive
|
|
|
|
----
|
|
|
|
Internal Functions
|
|
==================
|
|
|
|
.. kernel-doc:: drivers/tty/tty_buffer.c
|
|
:internal:
|