summaryrefslogtreecommitdiff
path: root/usr.bin/aucat/aucat.1
diff options
context:
space:
mode:
authorAlexandre Ratchov <ratchov@cvs.openbsd.org>2011-04-28 06:19:58 +0000
committerAlexandre Ratchov <ratchov@cvs.openbsd.org>2011-04-28 06:19:58 +0000
commitfa9d7b6082456caf8e490d50bc5d343277a2c67b (patch)
tree42fa8b593e554f30357234384779ee406d23e311 /usr.bin/aucat/aucat.1
parent7c46124c1f9b4e99b5ca7e36469b292d77b6663f (diff)
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
Diffstat (limited to 'usr.bin/aucat/aucat.1')
-rw-r--r--usr.bin/aucat/aucat.120
1 files changed, 17 insertions, 3 deletions
diff --git a/usr.bin/aucat/aucat.1 b/usr.bin/aucat/aucat.1
index 539e33b6f91..bce07ff0d4b 100644
--- a/usr.bin/aucat/aucat.1
+++ b/usr.bin/aucat/aucat.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: aucat.1,v 1.75 2011/03/21 16:33:17 okan Exp $
+.\" $OpenBSD: aucat.1,v 1.76 2011/04/28 06:19:57 ratchov Exp $
.\"
.\" Copyright (c) 2006 Alexandre Ratchov <alex@caoua.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 21 2011 $
+.Dd $Mdocdate: April 28 2011 $
.Dt AUCAT 1
.Os
.Sh NAME
@@ -33,6 +33,7 @@
.Op Fl h Ar fmt
.Op Fl i Ar file
.Op Fl j Ar flag
+.Op Fl L Ar addr
.Op Fl m Ar mode
.Op Fl o Ar file
.Op Fl q Ar device
@@ -140,6 +141,17 @@ For instance, this feature could be used to request mono streams to
be sent on multiple outputs or to record a stereo input into a mono stream.
The default is
.Ar on .
+.It Fl L Ar addr
+Specify a local network address to listen on in server mode.
+.Nm
+will listen on TCP port 11025+n, where n is the unit number
+specified with
+.Fl U .
+Without this option,
+.Nm
+listens on the
+.Ux Ns -domain
+socket only, and is not reachable from any network.
.It Fl l
Detach and become a daemon.
.It Fl m Ar mode
@@ -533,7 +545,9 @@ Note that the sequencer must use
.Va aucat:0
as the MTC source, i.e. the audio server, not the audio player.
.Sh ENVIRONMENT
-.Bl -tag -width "AUDIODEVICE" -compact
+.Bl -tag -width "AUCAT_COOKIE" -compact
+.It Ev AUCAT_COOKIE
+file containing user's session cookie.
.It Ev AUDIODEVICE
.Xr sndio 7
audio device to use if the