summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2010-07-06 10:45:02 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2010-07-06 10:45:02 +0000
commit5400283462065d13a1f57ed472e93870218bbcb4 (patch)
treeeb837bba21ea1e6ad1d068e3f41c94d507fc378f
parent2131c68c97b6631b4d73544d2bcf44a6fabae1ee (diff)
various tweaks to previous; ok ratchov
-rw-r--r--usr.bin/aucat/aucat.124
-rw-r--r--usr.bin/aucat/aucat.c4
-rw-r--r--usr.bin/aucat/midicat.110
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