OpenBSD CVS

CVS log for src/lib/libsndio/sndio.7


[BACK] Up to [local] / src / lib / libsndio

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.27 / (download) - annotate - [select for diffs], Mon Nov 1 14:43:24 2021 UTC (2 years, 7 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_7_5_BASE, OPENBSD_7_5, OPENBSD_7_4_BASE, OPENBSD_7_4, OPENBSD_7_3_BASE, OPENBSD_7_3, OPENBSD_7_2_BASE, OPENBSD_7_2, OPENBSD_7_1_BASE, OPENBSD_7_1, HEAD
Changes since 1.26: +6 -6 lines
Diff to previous 1.26 (colored)

Stop binding audio devices exposed by sndiod to physical devices

This a shift towards a new model: clients connect to logical devices
(created with -s option) then the server routes data to/from the
underlying physical device (registered with -f option). The binding
may be changed at run-time with the server.device control exposed by
sndioctl(1).

As audio devices exposed by sndiod(8) are not bound to fixed physical
devices anymore, the physical audio device number component of
sndio(7) descriptors was removed.

fixes, help from and ok denis, edd

Revision 1.26 / (download) - annotate - [select for diffs], Fri Nov 20 12:13:11 2020 UTC (3 years, 6 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_7_0_BASE, OPENBSD_7_0, OPENBSD_6_9_BASE, OPENBSD_6_9
Changes since 1.25: +58 -45 lines
Diff to previous 1.25 (colored)

* Make .Nd more specific.
* Avoid lots of short non-standard .Sh sections.
* Describe server and raw descriptors separately.
* Move examples to the EXAMPLES section.
* Mention that "default" is used even when *not* specified.
tweak and OK ratchov@

Revision 1.25 / (download) - annotate - [select for diffs], Thu Nov 19 08:14:19 2020 UTC (3 years, 6 months ago) by ratchov
Branch: MAIN
Changes since 1.24: +18 -6 lines
Diff to previous 1.24 (colored)

Allow specific devices to be used for play-only and rec-only modes.

Introduce new AUDIO{PLAY,REC}DEVICE environment variables that
override AUDIODEVICE in cases play-only and rec-only mode is
requested.  This allows using different devices for playback and
recording in programs requesting twice the default device (one in
play-only mode and one in rec-only mode).

Based on diffs from Peter J Philipp, semarie, and solene

ok solene, sthen

Revision 1.24 / (download) - annotate - [select for diffs], Sat Jul 18 05:01:14 2020 UTC (3 years, 10 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_6_8_BASE, OPENBSD_6_8
Changes since 1.23: +2 -8 lines
Diff to previous 1.23 (colored)

Raw device access is not anymore a fall-back for when sndiod isn't running

Found by Jan Stary <hans at stare.cz>, discussed with jmc@

Revision 1.23 / (download) - annotate - [select for diffs], Mon May 25 12:25:16 2020 UTC (4 years ago) by ratchov
Branch: MAIN
Changes since 1.22: +19 -12 lines
Diff to previous 1.22 (colored)

Add missing .Xr and .Nm, reword and simplify few sentences

from schwarze@

Revision 1.22 / (download) - annotate - [select for diffs], Tue May 19 07:46:10 2020 UTC (4 years ago) by jmc
Branch: MAIN
Changes since 1.21: +3 -3 lines
Diff to previous 1.21 (colored)

remove information already given in same sentence;
ok ratchov

Revision 1.21 / (download) - annotate - [select for diffs], Tue May 19 06:26:09 2020 UTC (4 years ago) by ratchov
Branch: MAIN
Changes since 1.20: +59 -63 lines
Diff to previous 1.20 (colored)

Replace off-topic parts of the desciption by an architecture overview

Remove useless (re)wording of what are audio(4) and midi(4), add a
quick description of sndiod as intermediate layer. Try to focuse on
what the sndio library and sndiod do instead of how they do it. As
suggested by schwarze, use the word "device descriptor" instead of
"device name" to avoid the common confusion with the device files.

ok and tweaks from jmc

Revision 1.20 / (download) - annotate - [select for diffs], Sat Jul 28 09:11:55 2018 UTC (5 years, 10 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_6_7_BASE, OPENBSD_6_7, OPENBSD_6_6_BASE, OPENBSD_6_6, OPENBSD_6_5_BASE, OPENBSD_6_5, OPENBSD_6_4_BASE, OPENBSD_6_4
Changes since 1.19: +3 -3 lines
Diff to previous 1.19 (colored)

Move libsndio session cookie in its own $HOME/.sndio/ directory to
make libsndio easier to use with unveil(2).

"make sense" deraadt

Revision 1.19 / (download) - annotate - [select for diffs], Thu Dec 7 15:43:03 2017 UTC (6 years, 6 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_6_3_BASE, OPENBSD_6_3
Changes since 1.18: +32 -29 lines
Diff to previous 1.18 (colored)

* clean up macro usage: use .Ar for command arguments, .Cm for fixed
strings to be used in commands, and .Li for example strings
* clarify what uses the two environment variables, and that only these
two are ignored for issetugid(2) programs
triggered by a question from Jan Stary <hans at stare dot cz>
feedback and OK ratchov@

Revision 1.18 / (download) - annotate - [select for diffs], Thu Jan 7 08:51:48 2016 UTC (8 years, 5 months ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_6_2_BASE, OPENBSD_6_2, OPENBSD_6_1_BASE, OPENBSD_6_1, OPENBSD_6_0_BASE, OPENBSD_6_0, OPENBSD_5_9_BASE, OPENBSD_5_9
Changes since 1.17: +4 -4 lines
Diff to previous 1.17 (colored)

fix SEE ALSO;

Revision 1.17 / (download) - annotate - [select for diffs], Thu Jan 7 07:41:01 2016 UTC (8 years, 5 months ago) by ratchov
Branch: MAIN
Changes since 1.16: +21 -21 lines
Diff to previous 1.16 (colored)

Move sndiod man page to section 8.

suggested by deraadt, fixes from jmc, ok millert

Revision 1.16 / (download) - annotate - [select for diffs], Wed Nov 25 17:22:36 2015 UTC (8 years, 6 months ago) by ratchov
Branch: MAIN
Changes since 1.15: +1 -1 lines
Diff to previous 1.15 (colored)

-M option was removed, midi ports registered with -q

Revision 1.15 / (download) - annotate - [select for diffs], Thu Oct 1 06:38:19 2015 UTC (8 years, 8 months ago) by ratchov
Branch: MAIN
Changes since 1.14: +2 -6 lines
Diff to previous 1.14 (colored)

Remove support for the AUCAT_COOKIE environment variable.

Revision 1.14 / (download) - annotate - [select for diffs], Sat Aug 1 10:30:52 2015 UTC (8 years, 10 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_5_8_BASE, OPENBSD_5_8
Changes since 1.13: +3 -3 lines
Diff to previous 1.13 (colored)

Use "Ev" macro for AUCAT_COOKIE environment variable. From Michael
Reed <m.reed at mykolab.com>. Thanks.

Revision 1.13 / (download) - annotate - [select for diffs], Sat Apr 6 11:38:41 2013 UTC (11 years, 2 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_5_7_BASE, OPENBSD_5_7, OPENBSD_5_6_BASE, OPENBSD_5_6, OPENBSD_5_5_BASE, OPENBSD_5_5, OPENBSD_5_4_BASE, OPENBSD_5_4
Changes since 1.12: +37 -3 lines
Diff to previous 1.12 (colored)

explain what "default" means in sndio.7 rather than {sio,mio}_open.3,
with tweaks from jmc

Revision 1.12 / (download) - annotate - [select for diffs], Sat Dec 22 10:10:04 2012 UTC (11 years, 5 months ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_5_3_BASE, OPENBSD_5_3
Changes since 1.11: +5 -5 lines
Diff to previous 1.11 (colored)

some fixes, based on a diff from Martin Toft;

Revision 1.11 / (download) - annotate - [select for diffs], Fri Nov 23 07:03:28 2012 UTC (11 years, 6 months ago) by ratchov
Branch: MAIN
Changes since 1.10: +5 -2 lines
Diff to previous 1.10 (colored)

Remplace aucat server by a new sndiod daemon aimed to be simpler
smaller and faster than aucat. It's a drop in replacement with the
following exceptions that don't affect the default setup:
  - The sample rate and the encoding are a per-device parameters
    thus -r and -e options must precede the corresponding -f option
  - MIDI thru boxes are dynamically created and no -M option
    is required anymore, so -M was removed.
  - MIDI ports are exposed with a new ``midi/N'' name, rather
    than abusing MIDI thru boxes.
with help from armani@, ok deraadt@

Revision 1.10 / (download) - annotate - [select for diffs], Wed May 23 19:25:11 2012 UTC (12 years ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_5_2_BASE, OPENBSD_5_2
Changes since 1.9: +4 -2 lines
Diff to previous 1.9 (colored)

Make the "default" string a valid device name that has the same effect
as NULL has. This will (hopefully) simplify ports where the user
passes the device string.

Revision 1.9 / (download) - annotate - [select for diffs], Fri Dec 9 14:38:09 2011 UTC (12 years, 6 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_5_1_BASE, OPENBSD_5_1
Changes since 1.8: +20 -20 lines
Diff to previous 1.8 (colored)

mention sndiod rather than aucat when talking about the server

Revision 1.8 / (download) - annotate - [select for diffs], Tue Nov 15 08:05:22 2011 UTC (12 years, 6 months ago) by ratchov
Branch: MAIN
Changes since 1.7: +47 -43 lines
Diff to previous 1.7 (colored)

Add a "device number" component in sndio(7) device names, allowing a
single aucat instance to handle all audio and MIDI services. Since
this partially breaks compatibility, this is a opportunitiy to fix few
other design mistakes (eg ':' being used by inet6, type name vs api
name confusion, etc..). This leads to the following names:

        type[@hostname][,unit]/devnum[.option]

The device number is the minor device number for direct hardware
access (ie the 'N' in /dev/audioN). For aucat, this is the occurence
number of the -f (or -M) option.

There's a compatibility hook to keep old names working if only one
aucat server is running.

Revision 1.7 / (download) - annotate - [select for diffs], Tue Oct 18 07:07:25 2011 UTC (12 years, 7 months ago) by jmc
Branch: MAIN
Changes since 1.6: +4 -4 lines
Diff to previous 1.6 (colored)

some minor tweaks concerning midicat removal; ok ratchov

Revision 1.6 / (download) - annotate - [select for diffs], Mon Oct 17 21:09:11 2011 UTC (12 years, 7 months ago) by ratchov
Branch: MAIN
Changes since 1.5: +19 -43 lines
Diff to previous 1.5 (colored)

Remove midicat since aucat can now be used instead of midicat
with almost the same syntax (roughly an extra -M option).
Thru boxes are created with aucat, and corresponding MIDI port
names have the "aucat" prefix instead of "midithru". The old
device name will still work some time for backward compatibility.

ok deraadt

Revision 1.5 / (download) - annotate - [select for diffs], Fri Jun 3 18:57:51 2011 UTC (13 years ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_5_0_BASE, OPENBSD_5_0
Changes since 1.4: +7 -3 lines
Diff to previous 1.4 (colored)

one midicat server can export multiple midithru ports

Revision 1.4 / (download) - annotate - [select for diffs], Thu Apr 28 06:19:57 2011 UTC (13 years, 1 month ago) by ratchov
Branch: MAIN
Changes since 1.3: +33 -3 lines
Diff to previous 1.3 (colored)

Implement a new authentication method allowing aucat and midicat to
work over TCP, for instance, to expose the sound card of one machine
with other machines of the network.

The first client generates a 128-bit random number (aka the
session cookie), saves it in $HOME/.aucat_cookie and sends it to the
server. Successive clients load the cookie from $HOME/.aucat_cookie
and send it to the server but the server accepts only clients whose
cookie matches the session cookie. When all clients are gone, the
session is over, and another cookie could start a new session, and so
on.

TCP is enabled on the server with the new -L option, and on the client
side hostnames are specified with a new optional component in the
device name.

hints from damien, dlg and deraadt, tweaks from jmc

Revision 1.3 / (download) - annotate - [select for diffs], Sat Apr 16 11:58:41 2011 UTC (13 years, 1 month ago) by ratchov
Branch: MAIN
Changes since 1.2: +3 -9 lines
Diff to previous 1.2 (colored)

remove aucat(1) and midicat(1) socket paths from the FILES sections.
Besides being wrong, they are part of sndio internals and don't need
to be exposed in such a high level man page.

Revision 1.2 / (download) - annotate - [select for diffs], Fri Aug 21 16:48:03 2009 UTC (14 years, 9 months ago) by ratchov
Branch: MAIN
CVS Tags: OPENBSD_4_9_BASE, OPENBSD_4_9, OPENBSD_4_8_BASE, OPENBSD_4_8, OPENBSD_4_7_BASE, OPENBSD_4_7
Changes since 1.1: +20 -8 lines
Diff to previous 1.1 (colored)

make aucat(1) expose a MIDI device to control server behaviour in
realtime.  For now only the playback volume of individual streams can be
changed/monitored. To each stream is assigned a MIDI channel; the volume
is changed/monitored using the standard controller number 7.

Revision 1.1 / (download) - annotate - [select for diffs], Sat Jul 25 09:55:12 2009 UTC (14 years, 10 months ago) by ratchov
Branch: MAIN

add sndio.7, forgotten in last commit
spotted by jasper@

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.