3
$NCDId: @(#)auscope.man,v 1.6 1994/07/26 00:36:26 greg Exp $
6
<!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
7
<!-- available at http://polyglotman.sourceforge.net/ -->
11
<title>AUSCOPE(1) manual page</title>
13
<body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
14
<a href='#toc'>Table of Contents</a><p>
16
<h2><a name='sect0' href='#toc0'>Name</a></h2>
17
auscope - Network Audio System Protocol Filter
18
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
19
<b>auscope</b> [ option
21
<h2><a name='sect2' href='#toc2'>Description</a></h2>
22
<i>auscope</i> is an audio protocol filter that can be used to view
23
the network packets being sent between an audio application and an audio
25
<i>auscope</i> is written in <i>Perl</i>, so you must have <i>Perl</i> installed on your
26
machine in order to run <i>auscope</i>. If your <i>Perl</i> executable is not installed
27
as /usr/local/bin/perl, you should modify the first line of the <i>auscope</i>
28
script to reflect the <i>Perl</i> executable's location. Or, you can invoke <i>auscope</i>
30
<b>perl auscope</b> [ option ] ... <p>
31
assuming the <i>Perl</i> executable is in your path.
33
To operate, <i></i> auscope must know the port on which it should listen for
34
audio clients, the name of the desktop machine on which the audio server
35
is running and the port to use to connect to the audio server. Both the
36
output port (server) and input port (client) are automatically biased
37
by 8000. The output port defaults to 0 and the input port defaults to
39
<h2><a name='sect3' href='#toc3'>Arguments</a></h2>
44
<dt><b>-i</b><i><input-port></i> </dt>
45
<dd>Specify the port that <i>auscope</i> will use to take requests
52
<dt><b>-o</b><i><output-port></i> </dt>
53
<dd>Determines the port that <i>auscope</i> will use to
54
connect to the audio server. </dd>
60
<dt><b>-h</b><i><audio server name></i> </dt>
61
<dd>Determines the desktop
62
machine name that <i>auscope</i> will use to find the audio server. </dd>
68
<dt><b>-v</b><i><print-level></i>
70
<dd>Determines the level of printing which <i>auscope</i> will provide. The print-level
71
can be 0 or 1. The larger numbers provide greater output detail. </dd>
74
<h2><a name='sect4' href='#toc4'>Examples</a></h2>
77
the following example, <i>mcxterm</i> is the name of the desktop machine running
78
the audio server, which is connected to the TCP/IP network host <i>tcphost</i>.
79
<i>auscope</i> uses the desktop machine with the <b></b> -h command line option, will
80
listen for client requests on port 8001 and connect to the audio server
82
Ports (file descriptors) on the network host are used to read
83
and write the audio protocol. The audio client <i></i> auplay will connect to
84
the audio server via the TCP/IP network host <i>tcphost</i> and port <i>8001</i>:
88
-i1 -o0 -hmcxterm </dt>
91
<dt>auplay -audio tcp/tcphost:8001 dial.snd </dt>
96
example, the auscope verbosity is increased to 1, and the audio client
97
<i></i> autool will connect to the audio server via the network host <i>tcphost</i>,
98
while displaying its graphical interface on another server <i>labmcx</i>:
102
-i1 -o0 -hmcxterm -v1 </dt>
105
<dt>autool -audio tcp/tcphost:8001 -display labmcx:0.0 </dt>
109
<h2><a name='sect5' href='#toc5'>See Also</a></h2>
110
<a href='nas.1.html'>nas(1)</a>
112
<a href='perl.1.html'>perl(1)</a>
114
<h2><a name='sect6' href='#toc6'>Copyright</a></h2>
115
Copyright 1994 Network Computing Devices, Inc.
116
<h2><a name='sect7' href='#toc7'>Author</a></h2>
118
Renda, Network Computing Devices, Inc. <p>
121
<a name='toc'><b>Table of Contents</b></a><p>
123
<li><a name='toc0' href='#sect0'>Name</a></li>
124
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
125
<li><a name='toc2' href='#sect2'>Description</a></li>
126
<li><a name='toc3' href='#sect3'>Arguments</a></li>
127
<li><a name='toc4' href='#sect4'>Examples</a></li>
128
<li><a name='toc5' href='#sect5'>See Also</a></li>
129
<li><a name='toc6' href='#sect6'>Copyright</a></li>
130
<li><a name='toc7' href='#sect7'>Author</a></li>