ericonr
/
sndio
mirror of https://github.com/ericonr/sndio.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

explain what "default" means in sndio.7

This commit is contained in:
Alexandre Ratchov 2013-04-12 16:24:59 +02:00
parent 8748c853c2
commit b5f32675fc
3 changed files with 35 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
libsndio/mio_open.3
View File

@ -61,13 +61,6 @@ later it will be passed as the
.Ar hdl
argument of most other functions.
The
.Fn mio_open
function tries to connect to the
.Xr sndiod 1
MIDI thru box or to use the
.Xr midi 4
hardware port.
The
.Ar name
parameter gives the device string discussed in
.Xr sndio 7 .

8
libsndio/sio_open.3
View File

@ -95,14 +95,6 @@ later it will be passed as the
.Ar hdl
argument of most other functions.
The
.Fn sio_open
function first tries to connect to the
.Xr sndiod 1
audio server.
If that fails, it then tries to use the
.Xr audio 4
hardware device.
The
.Ar name
parameter gives the device string discussed in
.Xr sndio 7 .

36
libsndio/sndio.7
View File

@ -97,7 +97,7 @@ MIDI thru box created with
MIDI port exposed by
.Xr sndiod 1 .
.It Pa default
Any audio device or MIDI port.
Default audio device or MIDI port (see below).
.El
.It Pa hostname
The hostname or address where the remote
@ -146,6 +146,40 @@ Sub-device registered with
First MIDI thru box created with
.Xr sndiod 1 .
.El
.Sh DEFAULTS
If
.Pa default
is used as the audio device, the program will use the
one specified in the
.Ev AUDIODEVICE
environment variable.
If it is not set, the program first tries to connect to
.Pa snd/0 .
If that fails, it then tries to use
.Pa rsnd/0 .
This allows the
.Xr sndiod 1
audio server to be used by default and the bare hardware as fallback;
programs don't have to be reconfigured when
.Xr sndiod 1
is started or stopped.
.Pp
If
.Pa default
is used as the MIDI port, the program will use the
one specified in the
.Ev MIDIDEVICE
environment variable.
If it is not set, the program first tries to connect to
.Pa midithru/0 .
If that fails, it then tries to use
.Pa rmidi/0 .
As long as
.Xr sndiod 1
is running, this allows programs to exchange MIDI data on
machines with no MIDI hardware by default, e.g. a MIDI player
could use a software synthesizer with no manual configuration
required.
.Sh AUTHENTICATION
If a shared
.Xr sndiod 1