diff --git a/libsndio/Makefile.in b/libsndio/Makefile.in index c7fc5c6..880f980 100644 --- a/libsndio/Makefile.in +++ b/libsndio/Makefile.in @@ -45,8 +45,8 @@ MAN7 = sndio.7 # # libraries to build and install # -MAJ = 6 -MIN = 1 +MAJ = 7 +MIN = 0 SO = @so@ SO_LINK = @so_link@ diff --git a/libsndio/sndio.7 b/libsndio/sndio.7 index 72af2e0..171235f 100644 --- a/libsndio/sndio.7 +++ b/libsndio/sndio.7 @@ -74,36 +74,36 @@ type[@hostname][,unit]/devnum[.option] This information is used by audio and MIDI applications to determine how to access the audio device or MIDI port. .Bl -tag -width "hostname" -.It Pa type +.It Ar type The type of the audio device or MIDI port. Possible values are: .Pp .Bl -tag -width "midithru" -offset 3n -compact -.It Pa rsnd +.It Cm rsnd Raw .Xr audio 4 device. -.It Pa rmidi +.It Cm rmidi Raw .Xr midi 4 port. -.It Pa snd +.It Cm snd Audio device exposed by .Xr sndiod 8 . -.It Pa midithru +.It Cm midithru MIDI thru box created with .Xr sndiod 8 . -.It Pa midi +.It Cm midi MIDI port exposed by .Xr sndiod 8 . -.It Pa default +.It Cm default Default audio device or MIDI port (see below). .El -.It Pa hostname +.It Ar hostname The hostname or address where the remote .Xr sndiod 8 server to connect to is running. -.It Pa unit +.It Ar unit The number of the .Xr sndiod 8 server to connect to, corresponding to the integer specified using the @@ -113,7 +113,7 @@ option of Useful only if multiple .Xr sndiod 8 servers are running on the same system. -.It Pa devnum +.It Ar devnum Device number. For hardware audio or MIDI ports, this corresponds to the character device minor number. @@ -122,7 +122,7 @@ For audio devices or MIDI ports created with it corresponds to the number of the corresponding .Fl fq option on the command line. -.It Pa option +.It Ar option Corresponds to the sub-device string registered using the .Fl s option of @@ -132,31 +132,31 @@ option of For example: .Pp .Bl -tag -width "snd/0.rear" -offset 3n -compact -.It Pa rsnd/0 +.It Li rsnd/0 First hardware audio device. -.It Pa rmidi/5 +.It Li rmidi/5 Hardware MIDI port number 5. -.It Pa snd/0 +.It Li snd/0 First audio device exposed by .Xr sndiod 8 . -.It Pa snd/0.rear +.It Li snd/0.rear Sub-device registered with .Fl s Fa rear . -.It Pa midithru/0 +.It Li midithru/0 First MIDI thru box created with .Xr sndiod 8 . .El .Sh DEFAULTS If -.Pa default +.Cm 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 . +.Li snd/0 . If that fails, it then tries to use -.Pa rsnd/0 . +.Li rsnd/0 . This allows the .Xr sndiod 8 audio server to be used by default and the bare hardware as fallback; @@ -165,15 +165,15 @@ programs don't have to be reconfigured when is started or stopped. .Pp If -.Pa default +.Cm 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 . +.Li midithru/0 . If that fails, it then tries to use -.Pa rmidi/0 . +.Li rmidi/0 . As long as .Xr sndiod 8 is running, this allows programs to exchange MIDI data on @@ -199,15 +199,18 @@ can connect to the server using the same cookie. .Sh ENVIRONMENT .Bl -tag -width "AUDIODEVICEXXX" -compact .It Ev AUDIODEVICE -Audio device to use if the application provides -no device chooser. +Audio device that +.Xr sio_open 3 +uses if the application provides no device chooser. .It Ev MIDIDEVICE -MIDI port to use if the application provides -no MIDI port chooser. +MIDI port that +.Xr mio_open 3 +uses if the application provides no MIDI port chooser. .El .Pp -Environment variables are ignored by programs -with the set-user-ID or set-group-ID bits set. +These environment variables are ignored by +.Nm +if the program has the set-user-ID or set-group-ID bits set. .Sh FILES .Bl -tag -width "/dev/audioNXXX" -compact .It Pa /dev/audioN diff --git a/sndiod/sock.c b/sndiod/sock.c index 58bfd1f..864760b 100644 --- a/sndiod/sock.c +++ b/sndiod/sock.c @@ -644,7 +644,7 @@ sock_setpar(struct sock *f) if (AMSG_ISSET(rchan) && (s->mode & MODE_RECMASK)) { if (rchan < 1) rchan = 1; - if (rchan > NCHAN_MAX) + else if (rchan > NCHAN_MAX) rchan = NCHAN_MAX; s->sub.slot_cmin = f->opt->rmin; s->sub.slot_cmax = f->opt->rmin + rchan - 1; @@ -668,7 +668,7 @@ sock_setpar(struct sock *f) if (AMSG_ISSET(pchan) && (s->mode & MODE_PLAY)) { if (pchan < 1) pchan = 1; - if (pchan > NCHAN_MAX) + else if (pchan > NCHAN_MAX) pchan = NCHAN_MAX; s->mix.slot_cmin = f->opt->pmin; s->mix.slot_cmax = f->opt->pmin + pchan - 1; @@ -692,7 +692,7 @@ sock_setpar(struct sock *f) if (AMSG_ISSET(rate)) { if (rate < RATE_MIN) rate = RATE_MIN; - if (rate > RATE_MAX) + else if (rate > RATE_MAX) rate = RATE_MAX; s->round = dev_roundof(d, rate); s->rate = rate;