diff options
author | Jason McIntyre <jmc@cvs.openbsd.org> | 2010-07-06 10:45:02 +0000 |
---|---|---|
committer | Jason McIntyre <jmc@cvs.openbsd.org> | 2010-07-06 10:45:02 +0000 |
commit | 5400283462065d13a1f57ed472e93870218bbcb4 (patch) | |
tree | eb837bba21ea1e6ad1d068e3f41c94d507fc378f | |
parent | 2131c68c97b6631b4d73544d2bcf44a6fabae1ee (diff) |
various tweaks to previous; ok ratchov
-rw-r--r-- | usr.bin/aucat/aucat.1 | 24 | ||||
-rw-r--r-- | usr.bin/aucat/aucat.c | 4 | ||||
-rw-r--r-- | usr.bin/aucat/midicat.1 | 10 |
3 files changed, 21 insertions, 17 deletions
diff --git a/usr.bin/aucat/aucat.1 b/usr.bin/aucat/aucat.1 index 2b60a6750ca..9c77a6b3a8d 100644 --- a/usr.bin/aucat/aucat.1 +++ b/usr.bin/aucat/aucat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: aucat.1,v 1.71 2010/07/06 01:12:45 ratchov Exp $ +.\" $OpenBSD: aucat.1,v 1.72 2010/07/06 10:45:01 jmc Exp $ .\" .\" Copyright (c) 2006 Alexandre Ratchov <alex@caoua.org> .\" @@ -92,7 +92,8 @@ and thus controls the playback latency. .Fl C Ar min : Ns Ar max , .Fl c Ar min : Ns Ar max .Xc -The range of stream channel numbers for recording and playback directions, respectively. +The range of stream channel numbers for recording and playback directions, +respectively. The default is 0:1, i.e. stereo. .It Fl d Increase log verbosity. @@ -246,7 +247,8 @@ is and samples that cannot be read are replaced by silence. If the policy is .Dq sync -then recorded samples are discarded, but the same amount of silence will be written +then recorded samples are discarded, +but the same amount of silence will be written once the stream is unblocked, in order to reach the right position in time. Similarly silence is played, but the same amount of samples will be discarded once the stream is unblocked. @@ -418,8 +420,8 @@ require a low latency audio setup. To reduce the probability of buffer underruns or overruns, especially on busy machines, the server can be started by the super-user, in which case it will run with higher priority. -Any user will still be able to -connect to it, but for privacy reasons, only one user may have +Any user will still be able to connect to it, +but for privacy reasons only one user may have connections to it at a given time. .Sh MIDI CONTROL .Nm @@ -461,7 +463,8 @@ In this mode, .Nm waits for all streams to become ready to start, and then starts them synchronously. -Once started, new streams can be created (server mode), but they will be blocked +Once started, new streams can be created (server mode) +but they will be blocked until the next stop-to-start transition. .It stop Put all streams in stopped mode (the default). @@ -609,8 +612,8 @@ $ aucat -l -v 65 -s default -v 127 -s max The following will start .Nm in server mode configuring the audio device to use -48kHz sample frequency, 240-frame block size, -and a 2-block buffers. +a 48kHz sample frequency, 240-frame block size, +and 2-block buffers. The corresponding latency is 10ms, which is the time it takes the sound to propagate 3.5 meters. .Bd -literal -offset indent @@ -643,9 +646,10 @@ thus samples with more than 16 bits are rounded. .Pp If .Fl a Ar off -option is used in server mode, +is used in server mode, .Nm -creates sub-devices to expose first and then opens the audio hardware on demand. +creates sub-devices to expose first +and then opens the audio hardware on demand. Technically, this allows .Nm to attempt to use one of the sub-devices it exposes as audio device, diff --git a/usr.bin/aucat/aucat.c b/usr.bin/aucat/aucat.c index cd88c2f3942..81f2646a512 100644 --- a/usr.bin/aucat/aucat.c +++ b/usr.bin/aucat/aucat.c @@ -1,4 +1,4 @@ -/* $OpenBSD: aucat.c,v 1.98 2010/07/06 01:12:45 ratchov Exp $ */ +/* $OpenBSD: aucat.c,v 1.99 2010/07/06 10:45:01 jmc Exp $ */ /* * Copyright (c) 2008 Alexandre Ratchov <alex@caoua.org> * @@ -851,7 +851,7 @@ void midicat_usage(void) { (void)fputs("usage: " PROG_MIDICAT " [-dl] " - "[-i file] [-o file] [-q device] [-U unit]\n", + "[-i file] [-o file] [-q port] [-s name] [-U unit]\n", stderr); } diff --git a/usr.bin/aucat/midicat.1 b/usr.bin/aucat/midicat.1 index 968e5d1421f..a4edb4c0e48 100644 --- a/usr.bin/aucat/midicat.1 +++ b/usr.bin/aucat/midicat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: midicat.1,v 1.12 2010/07/06 01:12:45 ratchov Exp $ +.\" $OpenBSD: midicat.1,v 1.13 2010/07/06 10:45:01 jmc Exp $ .\" .\" Copyright (c) 2006 Alexandre Ratchov <alex@caoua.org> .\" @@ -62,7 +62,7 @@ Write received data into this file. If the option argument is .Sq - then standard output will be used. -.It Fl q Ar device +.It Fl q Ar port Send and receive data from this .Xr sndio 7 MIDI port. @@ -102,14 +102,14 @@ If no streams are specified, server mode is assumed and a thru box is created as if .Fl s Ar default -was used as last argument. +was used as the last argument. .Pp Generally MIDI applications are real-time. To reduce jitter, especially on busy machines, the server can be started by the super-user, in which case it will run with higher priority. -Any user will still be able to connect to it, but -for privacy reasons, only one user may have connections to +Any user will still be able to connect to it, +but for privacy reasons only one user may have connections to it at a given time. .Pp If |