HomeFreeBSD

vt: add comments for KDMKTONE ioctl implementation

Description

vt: add comments for KDMKTONE ioctl implementation

The KDMKTONE ioctl, introduced in commit 916347f77e6c, is used to beep
the PC speaker. For historical reasons the frequency is specified as an
8254 PIT divisor for a 1.19MHz clock. Linux provides this same ioctl.
Add a comment to vtterm_beep to avoid someone wanting to "fix" this in
the future.

Also add an XXX comment that the period unit is supposed to be "timer
ticks." Note that nothing in the base system uses this ioctl.

Reviewed by: imp
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D47395

(cherry picked from commit adba3c74209eb5d2197b9092002cc9d7505fd3c6)

Details

Provenance
emasteAuthored on Nov 1 2024, 4:29 PM
Reviewer
imp
Differential Revision
D47395: vt: add comments for KDMKTONE ioctl implementation
Parents
rG8c922db4f3d9: syscons: add deprecation notice
Branches
Unknown
Tags
Unknown