mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-08-05 16:54:27 +00:00
6241b49540
The commit below added a new helper, but omitted to move (and add) the
corressponding kernel-doc. Do it now.
Signed-off-by: "Jiri Slaby (SUSE)" <jirislaby@kernel.org>
Fixes: 2b5eac0f8c ("tty: introduce and use tty_port_tty_vhangup() helper")
Link: https://lore.kernel.org/all/b23d566c-09dc-7374-cc87-0ad4660e8b2e@linux.intel.com/
Reported-by: Ilpo Järvinen <ilpo.jarvinen@linux.intel.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Link: https://lore.kernel.org/r/20250624080641.509959-6-jirislaby@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
71 lines
1.7 KiB
ReStructuredText
71 lines
1.7 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
========
|
|
TTY Port
|
|
========
|
|
|
|
.. contents:: :local:
|
|
|
|
The TTY drivers are advised to use struct tty_port helpers as much as possible.
|
|
If the drivers implement :c:member:`tty_port.ops.activate()` and
|
|
:c:member:`tty_port.ops.shutdown()`, they can use tty_port_open(),
|
|
tty_port_close(), and tty_port_hangup() in respective
|
|
:c:member:`tty_struct.ops` hooks.
|
|
|
|
The reference and details are contained in the `TTY Port Reference`_ and `TTY
|
|
Port Operations Reference`_ sections at the bottom.
|
|
|
|
TTY Port Functions
|
|
==================
|
|
|
|
Init & Destroy
|
|
--------------
|
|
|
|
.. kernel-doc:: drivers/tty/tty_port.c
|
|
:identifiers: tty_port_init tty_port_destroy
|
|
tty_port_get tty_port_put
|
|
|
|
Open/Close/Hangup Helpers
|
|
-------------------------
|
|
|
|
.. kernel-doc:: drivers/tty/tty_port.c
|
|
:identifiers: tty_port_install tty_port_open tty_port_block_til_ready
|
|
tty_port_close tty_port_close_start tty_port_close_end tty_port_hangup
|
|
tty_port_shutdown
|
|
|
|
TTY Refcounting
|
|
---------------
|
|
|
|
.. kernel-doc:: drivers/tty/tty_port.c
|
|
:identifiers: tty_port_tty_get tty_port_tty_set
|
|
|
|
TTY Helpers
|
|
-----------
|
|
|
|
.. kernel-doc:: include/linux/tty_port.h
|
|
:identifiers: tty_port_tty_hangup tty_port_tty_vhangup
|
|
.. kernel-doc:: drivers/tty/tty_port.c
|
|
:identifiers: tty_port_tty_wakeup
|
|
|
|
Modem Signals
|
|
-------------
|
|
|
|
.. kernel-doc:: drivers/tty/tty_port.c
|
|
:identifiers: tty_port_carrier_raised tty_port_raise_dtr_rts
|
|
tty_port_lower_dtr_rts
|
|
|
|
----
|
|
|
|
TTY Port Reference
|
|
==================
|
|
|
|
.. kernel-doc:: include/linux/tty_port.h
|
|
:identifiers: tty_port
|
|
|
|
----
|
|
|
|
TTY Port Operations Reference
|
|
=============================
|
|
|
|
.. kernel-doc:: include/linux/tty_port.h
|
|
:identifiers: tty_port_operations
|