WSBELL(4)

NAME
wsbell - generic bell support in wscons

SYNOPSIS
wsbell* at spkr? console?

DESCRIPTION
The wsbell driver utilizes the speaker(4) driver to provide a system bell with or without a keyboard for the wscons(4) framework. When a bell character is received on a wsdisplay(4) screen, wsbell sounds the bell.

The wsconsctl(8) utility gives access to several configurable parameters that effect the sound of the system bell.

  Ioctls
The following ioctl(2) calls are provided by the wsbell driver. Their definitions are found in dev/wscons/wsconsio.h.

WSKBDIO_BELL
    Will sound the default bell.

WSKBDIO_GETBELL
    Will return a struct wskbd_bell_data with the current bell parameters.

WSKBDIO_SETBELL
    Takes a struct wskbd_bell_data and uses it to set the bell parameters. These are used by the WSKBDIO_BELL ioctl(2) call.

WSKBDIO_COMPLEXBELL
    Will sound a bell using a supplied struct wskbd_bell_data for its parameters.

WSKBDIO_GETDEFAULTBELL
    Will return a struct wskbd_bell_data with the default bell parameters.

WSKBDIO_SETDEFAULTBELL
    Takes a struct wskbd_bell_data and uses it to set the default bell parameters.

Ioctls use the following structure:

    struct wskbd_bell_data {
    	u_int	which;			/* values to get/set */
    #define	WSKBD_BELL_DOPITCH	0x1	/* get/set pitch */
    #define	WSKBD_BELL_DOPERIOD	0x2	/* get/set period */
    #define	WSKBD_BELL_DOVOLUME	0x4	/* get/set volume */
    #define	WSKBD_BELL_DOALL	0x7	/* all of the above */
    	u_int	pitch;			/* pitch, in Hz */
    	u_int	period;			/* period, in milliseconds */
    	u_int	volume;			/* percentage of max volume */
    };

FILES

/usr/include/dev/wscons/wsconsio.h.

SEE ALSO
speaker(4), wscons(4), wskbd(4), wsmux(4), wsconsctl(8), wsbell(9)