1
<!-- manual page source format generated by PolyglotMan v3.0.7, -->
2
<!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
6
<TITLE>man page(1)</TITLE>
9
<A HREF="#toc">Table of Contents</A><P>
11
<H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
14
auscope - Network Audio System Protocol Filter
16
<H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
19
<B>auscope</B> [ option ] ...
21
<H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
24
<I>auscope</I> is an audio protocol filter that can be used to
25
view the network packets being sent between an audio
26
application and an audio server.
28
<I>auscope</I> is written in <I>Perl</I>, so you must have <I>Perl</I>
29
installed on your machine in order to run <I>auscope</I>. If
30
your <I>Perl</I> executable is not installed as
31
/usr/local/bin/perl, you should modify the first line of
32
the <I>auscope</I> script to reflect the <I>Perl</I> executable's location.
33
Or, you can invoke <I>auscope</I> as
35
<B>perl</B> <B>auscope</B> [ option ] ...
37
assuming the <I>Perl</I> executable is in your path.
39
To operate, <I>auscope</I> must know the port on which it should
40
listen for audio clients, the name of the desktop machine
41
on which the audio server is running and the port to use
42
to connect to the audio server. Both the output port
43
(server) and input port (client) are automatically biased
44
by 8000. The output port defaults to 0 and the input port
47
<H2><A NAME="sect3" HREF="#toc3"><B>Arguments</B></A></H2>
50
<B>-i</B><I><input-port></I><BR>
52
Specify the port that <I>auscope</I> will use to take
53
requests from clients.
57
<DT><B>-o</B><I><output-port></I></DT></DT>
59
Determines the port that <I>auscope</I> will use to connect
63
<DT><B>-h</B><I><audio</I> <I>server</I> <I>name></I></DT></DT>
65
Determines the desktop machine name that <I>auscope</I>
66
will use to find the audio server.
69
<DT><B>-v</B><I><print-level></I></DT></DT>
71
Determines the level of printing which <I>auscope</I>
72
will provide. The print-level can be 0 or 1. The
73
larger numbers provide greater output detail.
77
<H2><A NAME="sect4" HREF="#toc4"><B>Examples</B></A></H2>
80
In the following example, <I>mcxterm</I> is the name of the desktop
81
machine running the audio server, which is connected
82
to the TCP/IP network host <I>tcphost</I>. <I>auscope</I> uses the
83
desktop machine with the <B>-h</B> command line option, will listen
84
for client requests on port 8001 and connect to the
85
audio server on port 8000.
87
Ports (file descriptors) on the network host are used to
88
read and write the audio protocol. The audio client
89
<I>auplay</I> will connect to the audio server via the TCP/IP
90
network host <I>tcphost</I> and port <I>8001</I>:
92
auscope -i1 -o0 -hmcxterm
94
auplay -audio tcp/tcphost:8001 dial.snd
96
In the following example, the auscope verbosity is
97
increased to 1, and the audio client <I>autool</I> will connect
98
to the audio server via the network host <I>tcphost</I>, while
99
displaying its graphical interface on another server
102
auscope -i1 -o0 -hmcxterm -v1
104
autool -audio tcp/tcphost:8001 -display labmcx:0.0
106
<H2><A NAME="sect5" HREF="#toc5"><B>See</B> <B>Also</B></A></H2>
109
<A HREF="man:nas(1)">nas(1)</A>
110
, <A HREF="man:perl(1)">perl(1)</A>
113
<H2><A NAME="sect6" HREF="#toc6"><B>Copyright</B></A></H2>
116
Copyright 1994 Network Computing Devices, Inc.
118
<H2><A NAME="sect7" HREF="#toc7"><B>Author</B></A></H2>
121
Greg Renda, Network Computing Devices, Inc.
125
<A NAME="toc"><B>Table of Contents</B></A><P>
127
<LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
128
<LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
129
<LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
130
<LI><A NAME="toc3" HREF="#sect3">Arguments</A></LI>
131
<LI><A NAME="toc4" HREF="#sect4">Examples</A></LI>
132
<LI><A NAME="toc5" HREF="#sect5">See Also</A></LI>
133
<LI><A NAME="toc6" HREF="#sect6">Copyright</A></LI>
134
<LI><A NAME="toc7" HREF="#sect7">Author</A></LI>