comcontrol(8)

comcontrol8

Control a special tty device

Usage

comcontrol special_device [drainwait number]

Deprecation notice

The comcontrol utility is deprecated and will be removed in FreeBSD 16.0.

Overview

The comcontrol utility is used to examine and modify some of the special characteristics of the specified tty device. If no arguments other than the device (or "-" for stdin) are specified, it prints the settings of all controllable characteristics. This usage requires only read access on the device. Only the superuser can change the settings.

The following options are available:

drainwait number

Set the time to wait for output drain to the given number. The units are seconds. The default is 5 minutes, 0 means waiting forever. This option is needed mainly to specify an upper limit of minutes to prevent modem hanging.

The standard way to use comcontrol is to put invocations of it in the /etc/rc.d/serial startup script.

Files

/dev/ttyd?

dialin devices, hardwired terminals

/dev/cuau?

dialout devices

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 49 times.

  1. 2.0.5
  2. 2.1.5–2.1.7.1
  3. 2.2.2–2.2.6
  4. 2.2.7–2.2.8
  5. 2.2.9
  6. 3.0–3.2
  7. 3.3–3.4
  8. 3.5–3.5.1
  9. 4.0
  10. 4.1–4.2
  11. 4.3
  12. 4.4–4.6.2
  13. 4.7–4.11
  14. 5.0–5.2.1
  15. 5.3–5.5
  16. 6.0–6.3
  17. 6.4
  18. 7.0
  19. 7.1
  20. 7.2
  21. 7.3
  22. 7.4
  23. 8.0
  24. 8.1
  25. 8.2
  26. 8.3
  27. 8.4
  28. 9.0
  29. 9.1
  30. 9.2
  31. 9.3
  32. 10.0
  33. 10.1
  34. 10.2
  35. 10.3
  36. 10.4
  37. 11.0
  38. 11.1
  39. 11.2
  40. 11.3
  41. 11.4
  42. 12.0
  43. 12.1
  44. 12.2
  45. 12.3
  46. 12.4
  47. 13.0–13.2
  48. 13.3–14.2
  49. 14.3–14.5
  50. 15.0–16.0

History

Originally part of cgd's com package patches, version 0.2.1, to 386BSD-0.1. Once controlled bidirectional capabilities. Little is left to control now that these capabilities are standard.

Authors

Christopher G. Demetriou

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.