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

« back to all changes in this revision

Viewing changes to doc/html/man1/auscope.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
 
<!-- 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 -->
3
 
 
4
 
<HTML>
5
 
<HEAD>
6
 
<TITLE>man page(1)</TITLE>
7
 
</HEAD>
8
 
<BODY bgcolor=white>
9
 
<A HREF="#toc">Table of Contents</A><P>
10
 
 
11
 
<H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
12
 
 
13
 
<P>
14
 
auscope - Network Audio System Protocol Filter
15
 
 
16
 
<H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
17
 
 
18
 
<P>
19
 
<B>auscope</B> [ option ] ...
20
 
 
21
 
<H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
22
 
 
23
 
<P>
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.
27
 
<P>
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
34
 
<P>
35
 
<B>perl</B> <B>auscope</B> [ option ] ...
36
 
<P>
37
 
assuming the <I>Perl</I> executable is in your path.
38
 
<P>
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
45
 
defaults to 1.
46
 
 
47
 
<H2><A NAME="sect3" HREF="#toc3"><B>Arguments</B></A></H2>
48
 
 
49
 
<P>
50
 
<B>-i</B><I>&lt;input-port&gt;</I><BR>
51
 
 
52
 
Specify the port that <I>auscope</I> will use to take
53
 
requests from clients.
54
 
 
55
 
<DL>
56
 
 
57
 
<DT><B>-o</B><I>&lt;output-port&gt;</I></DT></DT>
58
 
<DD>
59
 
Determines the port that <I>auscope</I> will use to connect
60
 
to the audio server.
61
 
</DD>
62
 
 
63
 
<DT><B>-h</B><I>&lt;audio</I> <I>server</I> <I>name&gt;</I></DT></DT>
64
 
<DD>
65
 
Determines the desktop machine name that <I>auscope</I>
66
 
will use to find the audio server.
67
 
</DD>
68
 
 
69
 
<DT><B>-v</B><I>&lt;print-level&gt;</I></DT></DT>
70
 
<DD>
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.
74
 
</DD>
75
 
</DL>
76
 
 
77
 
<H2><A NAME="sect4" HREF="#toc4"><B>Examples</B></A></H2>
78
 
 
79
 
<P>
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.
86
 
<P>
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>:
91
 
<P>
92
 
auscope -i1 -o0 -hmcxterm
93
 
<P>
94
 
auplay -audio tcp/tcphost:8001 dial.snd
95
 
<P>
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
100
 
<I>labmcx</I>:
101
 
<P>
102
 
auscope -i1 -o0 -hmcxterm -v1
103
 
<P>
104
 
autool -audio tcp/tcphost:8001 -display labmcx:0.0
105
 
 
106
 
<H2><A NAME="sect5" HREF="#toc5"><B>See</B> <B>Also</B></A></H2>
107
 
 
108
 
<P>
109
 
<A HREF="man:nas(1)">nas(1)</A>
110
 
, <A HREF="man:perl(1)">perl(1)</A>
111
 
 
112
 
 
113
 
<H2><A NAME="sect6" HREF="#toc6"><B>Copyright</B></A></H2>
114
 
 
115
 
<P>
116
 
Copyright 1994 Network Computing Devices, Inc.
117
 
 
118
 
<H2><A NAME="sect7" HREF="#toc7"><B>Author</B></A></H2>
119
 
 
120
 
<P>
121
 
Greg Renda, Network Computing Devices, Inc.
122
 
<P>
123
 
 
124
 
<HR><P>
125
 
<A NAME="toc"><B>Table of Contents</B></A><P>
126
 
<UL>
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>
135
 
</UL>
136
 
</BODY></HTML>