~ubuntu-branches/debian/squeeze/nas/squeeze

« back to all changes in this revision

Viewing changes to doc/html/auscope.1.html

  • Committer: Bazaar Package Importer
  • Author(s): Steve McIntyre
  • Date: 2008-10-08 01:18:19 UTC
  • mfrom: (4.1.7 intrepid)
  • Revision ID: james.westby@ubuntu.com-20081008011819-wmr4h2w0298k8t7z
Tags: 1.9.1-5
* Fix pending l10n issues. Debconf translations:
* Swedish. Closes: #491766 (thanks to brother@bsnet.se)
* Arabic. Closes: #500437 (thanks to Ossama Khayat)
* Basque. Closes: #500533 (thanks to Piarres Beobide)
* Brazilian Portuguese. Closes: #500973 (thanks to Felipe
  Augusto van de Wiel)
* Many thanks again to Christian Perrier for his i18n efforts,
  co-ordinating the above.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
<!--
 
3
  $NCDId: @(#)auscope.man,v 1.6 1994/07/26 00:36:26 greg Exp $
 
4
 
 
5
-->
 
6
<!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
 
7
<!-- available at http://polyglotman.sourceforge.net/ -->
 
8
 
 
9
<html>
 
10
<head>
 
11
<title>AUSCOPE(1) manual page</title>
 
12
</head>
 
13
<body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
 
14
<a href='#toc'>Table of Contents</a><p>
 
15
 
 
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
 
20
] ... 
 
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
 
24
server. <p>
 
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>
 
29
as <p>
 
30
<b>perl auscope</b> [ option ] ... <p>
 
31
assuming the <i>Perl</i> executable is in your path.
 
32
<p>
 
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
 
38
1.  
 
39
<h2><a name='sect3' href='#toc3'>Arguments</a></h2>
 
40
<p>
 
41
 
 
42
<dl>
 
43
 
 
44
<dt><b>-i</b><i>&lt;input-port&gt;</i> </dt>
 
45
<dd>Specify the port that <i>auscope</i> will use to take requests
 
46
from clients.  </dd>
 
47
</dl>
 
48
<p>
 
49
 
 
50
<dl>
 
51
 
 
52
<dt><b>-o</b><i>&lt;output-port&gt;</i> </dt>
 
53
<dd>Determines the port that <i>auscope</i> will use to
 
54
connect to the audio  server.  </dd>
 
55
</dl>
 
56
<p>
 
57
 
 
58
<dl>
 
59
 
 
60
<dt><b>-h</b><i>&lt;audio server name&gt;</i> </dt>
 
61
<dd>Determines the desktop
 
62
machine name that <i>auscope</i> will use to find  the audio server. </dd>
 
63
</dl>
 
64
<p>
 
65
 
 
66
<dl>
 
67
 
 
68
<dt><b>-v</b><i>&lt;print-level&gt;</i>
 
69
</dt>
 
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>
 
72
</dl>
 
73
 
 
74
<h2><a name='sect4' href='#toc4'>Examples</a></h2>
 
75
<p>
 
76
In
 
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
 
81
on port 8000. <p>
 
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>: 
 
85
<dl>
 
86
 
 
87
<dt>auscope
 
88
-i1 -o0 -hmcxterm </dt>
 
89
<dd></dd>
 
90
 
 
91
<dt>auplay -audio tcp/tcphost:8001 dial.snd  </dt>
 
92
<dd></dd>
 
93
</dl>
 
94
<p>
 
95
In the following
 
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>: 
 
99
<dl>
 
100
 
 
101
<dt>auscope
 
102
-i1 -o0 -hmcxterm -v1 </dt>
 
103
<dd></dd>
 
104
 
 
105
<dt>autool -audio tcp/tcphost:8001 -display labmcx:0.0 </dt>
 
106
<dd></dd>
 
107
</dl>
 
108
 
 
109
<h2><a name='sect5' href='#toc5'>See Also</a></h2>
 
110
<a href='nas.1.html'>nas(1)</a>
 
111
,
 
112
<a href='perl.1.html'>perl(1)</a>
 
113
 
 
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>
 
117
Greg
 
118
Renda, Network Computing Devices, Inc. <p>
 
119
 
 
120
<hr><p>
 
121
<a name='toc'><b>Table of Contents</b></a><p>
 
122
<ul>
 
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>
 
131
</ul>
 
132
</body>
 
133
</html>