tty_port.rst 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. .. SPDX-License-Identifier: GPL-2.0
  2. ========
  3. TTY Port
  4. ========
  5. .. contents:: :local:
  6. The TTY drivers are advised to use struct tty_port helpers as much as possible.
  7. If the drivers implement :c:member:`tty_port.ops.activate()` and
  8. :c:member:`tty_port.ops.shutdown()`, they can use tty_port_open(),
  9. tty_port_close(), and tty_port_hangup() in respective
  10. :c:member:`tty_struct.ops` hooks.
  11. The reference and details are contained in the `TTY Port Reference`_ and `TTY
  12. Port Operations Reference`_ sections at the bottom.
  13. TTY Port Functions
  14. ==================
  15. Init & Destroy
  16. --------------
  17. .. kernel-doc:: drivers/tty/tty_port.c
  18. :identifiers: tty_port_init tty_port_destroy
  19. tty_port_get tty_port_put
  20. Open/Close/Hangup Helpers
  21. -------------------------
  22. .. kernel-doc:: drivers/tty/tty_port.c
  23. :identifiers: tty_port_install tty_port_open tty_port_block_til_ready
  24. tty_port_close tty_port_close_start tty_port_close_end tty_port_hangup
  25. tty_port_shutdown
  26. TTY Refcounting
  27. ---------------
  28. .. kernel-doc:: drivers/tty/tty_port.c
  29. :identifiers: tty_port_tty_get tty_port_tty_set
  30. TTY Helpers
  31. -----------
  32. .. kernel-doc:: drivers/tty/tty_port.c
  33. :identifiers: tty_port_tty_hangup tty_port_tty_wakeup
  34. Modem Signals
  35. -------------
  36. .. kernel-doc:: drivers/tty/tty_port.c
  37. :identifiers: tty_port_carrier_raised tty_port_raise_dtr_rts
  38. tty_port_lower_dtr_rts
  39. ----
  40. TTY Port Reference
  41. ==================
  42. .. kernel-doc:: include/linux/tty_port.h
  43. :identifiers: tty_port
  44. ----
  45. TTY Port Operations Reference
  46. =============================
  47. .. kernel-doc:: include/linux/tty_port.h
  48. :identifiers: tty_port_operations