NAME
wsbell,
wsbelldevprint —
wscons system bell support
SYNOPSIS
#include <dev/wscons/wsconsio.h>
#include <dev/wscons/wsbellvar.h>
int
wsbelldevprint(
void
*aux,
const char
*pnp);
DESCRIPTION
The
wsbell module is a component of the
wscons(9) framework, providing
keyboard-independent bell support. All of the support is provided by the
wsbell(4) device driver, which
must be a child of the hardware device driver. The only hardware device
drivers that can provide a
wsbell facility are
speaker(4) devices.
DATA TYPES
Speaker drivers providing support for wscons bell devices will make use of the
following data types:
-
-
- struct
wsbelldev_attach_args
- A structure used to attach the
wsbell(4) child device. It
has the following members:
FUNCTIONS
-
-
- wsbelldevprint(aux,
pnp)
- The default wsbell printing routine used by
config_found(). (see
autoconf(9)).
AUTOCONFIGURATION
Speaker drivers which want to use the wsbell module must be a parent to the
wsbell(4) device and provide an
attachment interface. To attach the
wsbell(4) device, the speaker
driver must allocate and populate a
wsbelldev_attach_args structure with a pointer to the
parent's device structure as an access cookie and call
config_found() to perform the attach (see
autoconf(9)).
OPERATION
When a bell event is received on a
wsdisplay(4) device the
system bell is sounded.
CODE REFERENCES
The wscons subsystem is implemented within the directory
sys/dev/wscons. The
wsbell module itself
is implement within the file
sys/dev/wscons/wsbell.c.
ioctl(2) operations are listed in
sys/dev/wscons/wsconsio.h.
SEE ALSO
ioctl(2),
wsbell(4),
wscons(4),
wskbd(4),
autoconf(9),
driver(9),
intro(9),
wscons(9),
wsdisplay(9),
wskbd(9)