1AUSCOPE(1)                  General Commands Manual                 AUSCOPE(1)
2
3
4

NAME

6       auscope - Network Audio System Protocol Filter
7

SYNOPSIS

9       auscope [ option ] ...
10

DESCRIPTION

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 ma‐
17       chine in order to run auscope.  If your  Perl  executable  is  not  in‐
18       stalled as /usr/local/bin/perl, you should modify the first line of the
19       auscope script to reflect the Perl executable's location.  Or, you  can
20       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 de‐
31       faults to 1.
32

ARGUMENTS

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 au‐
40               dio 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

EXAMPLES

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 op‐
55       tion, 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

SEE ALSO

76       nas(1), perl(1)
77

79       Copyright 1994 Network Computing Devices, Inc.
80

AUTHOR

82       Greg Renda, Network Computing Devices, Inc.
83
84
85
86                                     1.9.5                          AUSCOPE(1)
Impressum