1AUSCOPE(1) General Commands Manual AUSCOPE(1)
2
3
4
6 auscope - Network Audio System Protocol Filter
7
9 auscope [ option ] ...
10
12 auscope is an audio protocol filter that can be used to view the net‐
13 work packets being sent between an audio application and an audio
14 server.
15
16 auscope is written in Perl, so you must have Perl installed on your
17 machine in order to run auscope. If your Perl executable is not
18 installed as /usr/local/bin/perl, you should modify the first line of
19 the auscope script to reflect the Perl executable's location. Or, you
20 can invoke auscope as
21
22 perl auscope [ option ] ...
23
24 assuming the Perl executable is in your path.
25
26 To operate, auscope must know the port on which it should listen for
27 audio clients, the name of the desktop machine on which the audio
28 server is running and the port to use to connect to the audio server.
29 Both the output port (server) and input port (client) are automatically
30 biased by 8000. The output port defaults to 0 and the input port
31 defaults to 1.
32
34 -i<input-port>
35 Specify the port that auscope will use to take requests from
36 clients.
37
38 -o<output-port>
39 Determines the port that auscope will use to connect to the
40 audio server.
41
42 -h<audio server name>
43 Determines the desktop machine name that auscope will use to
44 find the audio server.
45
46 -v<print-level>
47 Determines the level of printing which auscope will provide.
48 The print-level can be 0 or 1. The larger numbers provide
49 greater output detail.
50
52 In the following example, mcxterm is the name of the desktop machine
53 running the audio server, which is connected to the TCP/IP network host
54 tcphost. auscope uses the desktop machine with the -h command line
55 option, will listen for client requests on port 8001 and connect to the
56 audio server on port 8000.
57
58 Ports (file descriptors) on the network host are used to read and write
59 the audio protocol. The audio client auplay will connect to the audio
60 server via the TCP/IP network host tcphost and port 8001:
61
62 auscope -i1 -o0 -hmcxterm
63
64 auplay -audio tcp/tcphost:8001 dial.snd
65
66 In the following example, the auscope verbosity is increased to 1, and
67 the audio client autool will connect to the audio server via the net‐
68 work host tcphost, while displaying its graphical interface on another
69 server labmcx:
70
71 auscope -i1 -o0 -hmcxterm -v1
72
73 autool -audio tcp/tcphost:8001 -display labmcx:0.0
74
76 nas(1), perl(1)
77
79 Copyright 1994 Network Computing Devices, Inc.
80
82 Greg Renda, Network Computing Devices, Inc.
83
84
85
86 1.9.1 AUSCOPE(1)