sndio: Add a display string to the sioctl_open API

For hardware devices, add a server.device control
with a single item and the device name as display
string.

Add the necessary sndioctl(1) bits to print it.

sioctl_onval(3) returns int not void

Fix from Carlin Bingham <cb at viennan.net>, thanks!

Use .Dv for SIOCTL_SEL, as we do for all other macros

Allow switching between alternate devices (-F option) with sndioctl(1)

Add a new SIOCTL_SEL control type to select one of a predefined set of
mutually exclusive values. It's the same as SIOCTL_LIST except that
exactly one list element may be selected.

add missing ENVIRONMENT. HISTORY, and AUTHORS sections,
and a few other wording and markup improvements while here;
OK jmc@ ratchov@

uint8_t is a discrete, not a continuous type,
and some other wording improvements with respect to types;
OK ratchov@

Many of these functions have several arguments, and some arguments
are very long (function pointers), such that a number of input lines
in the SYNOPSIS do not fit into 80 columns. Consequently, consistently
use .Fo/.Fa/.Fc rather than .Fn for better readability of the source
code. Mechanical diff, no output change.

basic macro cleanup, and reword two phrases about closed intervals
of integers for clarity and to read better;
one of the issues (abuse of .Sm) was originally reported by jmc@;
ok jmc@ ratchov@

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

sioctl_onval(3) returns int not void

Fix from Carlin Bingham <cb at viennan.net>, thanks!

Use .Dv for SIOCTL_SEL, as we do for all other macros

Allow switching between alternate devices (-F option) with sndioctl(1)

Add a new SIOCTL_SEL control type to select one of a predefined set of
mutually exclusive values. It's the same as SIOCTL_LIST except that
exactly one list element may be selected.

add missing ENVIRONMENT. HISTORY, and AUTHORS sections,
and a few other wording and markup improvements while here;
OK jmc@ ratchov@

uint8_t is a discrete, not a continuous type,
and some other wording improvements with respect to types;
OK ratchov@

Many of these functions have several arguments, and some arguments
are very long (function pointers), such that a number of input lines
in the SYNOPSIS do not fit into 80 columns. Consequently, consistently
use .Fo/.Fa/.Fc rather than .Fn for better readability of the source
code. Mechanical diff, no output change.

basic macro cleanup, and reword two phrases about closed intervals
of integers for clarity and to read better;
one of the issues (abuse of .Sm) was originally reported by jmc@;
ok jmc@ ratchov@

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

Use .Dv for SIOCTL_SEL, as we do for all other macros

Allow switching between alternate devices (-F option) with sndioctl(1)

Add a new SIOCTL_SEL control type to select one of a predefined set of
mutually exclusive values. It's the same as SIOCTL_LIST except that
exactly one list element may be selected.

add missing ENVIRONMENT. HISTORY, and AUTHORS sections,
and a few other wording and markup improvements while here;
OK jmc@ ratchov@

uint8_t is a discrete, not a continuous type,
and some other wording improvements with respect to types;
OK ratchov@

Many of these functions have several arguments, and some arguments
are very long (function pointers), such that a number of input lines
in the SYNOPSIS do not fit into 80 columns. Consequently, consistently
use .Fo/.Fa/.Fc rather than .Fn for better readability of the source
code. Mechanical diff, no output change.

basic macro cleanup, and reword two phrases about closed intervals
of integers for clarity and to read better;
one of the issues (abuse of .Sm) was originally reported by jmc@;
ok jmc@ ratchov@

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

add missing ENVIRONMENT. HISTORY, and AUTHORS sections,
and a few other wording and markup improvements while here;
OK jmc@ ratchov@

uint8_t is a discrete, not a continuous type,
and some other wording improvements with respect to types;
OK ratchov@

Many of these functions have several arguments, and some arguments
are very long (function pointers), such that a number of input lines
in the SYNOPSIS do not fit into 80 columns. Consequently, consistently
use .Fo/.Fa/.Fc rather than .Fn for better readability of the source
code. Mechanical diff, no output change.

basic macro cleanup, and reword two phrases about closed intervals
of integers for clarity and to read better;
one of the issues (abuse of .Sm) was originally reported by jmc@;
ok jmc@ ratchov@

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

uint8_t is a discrete, not a continuous type,
and some other wording improvements with respect to types;
OK ratchov@

Many of these functions have several arguments, and some arguments
are very long (function pointers), such that a number of input lines
in the SYNOPSIS do not fit into 80 columns. Consequently, consistently
use .Fo/.Fa/.Fc rather than .Fn for better readability of the source
code. Mechanical diff, no output change.

basic macro cleanup, and reword two phrases about closed intervals
of integers for clarity and to read better;
one of the issues (abuse of .Sm) was originally reported by jmc@;
ok jmc@ ratchov@

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

Document sioctl_desc structure maxval attribute

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt

spelling fix;

Mention SIO_DEVANY instead of nonexistent SIOCTL_DEVANY constant

OK ratchov@

Fix .Dt line and copyright year.

From jmc@, thanks.

Add API to control audio device parameters exposed by sndiod.

The API exposes controls of modern audio hardware and sndiod software
volume knobs in a uniform way. Hardware knobs are exposed through
sndiod. Multiple programs may use the controls at the same time
without the need to continuously scan the controls.

For now sndiod exposes only its own controls and the master output and
input volumes of the underlying hardware (if any), i.e. those
typically exposed by acpi volume keys.

ok deraadt