xenial (1) auscope.1nas.gz

Provided by: nas-bin_1.9.4-4_amd64 bug

NAME

       auscope - Network Audio System Protocol Filter

SYNOPSIS

       auscope [ option ] ...

DESCRIPTION

       auscope  is  an  audio protocol filter that can be used to view the network packets being sent between an
       audio application and an audio server.

       auscope is written in Perl, so you must have Perl installed on your machine in order to run auscope.   If
       your  Perl  executable  is  not installed as /usr/local/bin/perl, you should modify the first line of the
       auscope script to reflect the Perl executable's location.  Or, you can invoke auscope as

       perl auscope [ option ] ...

       assuming the Perl executable is in your path.

       To operate, auscope must know the port on which it should listen for  audio  clients,  the  name  of  the
       desktop  machine on which the audio server is running and the port to use to connect to the audio server.
       Both the output port (server) and input port (client) are automatically biased by 8000.  The output  port
       defaults to 0 and the input port defaults to 1.

ARGUMENTS

       -i<input-port>
               Specify the port that auscope will use to take requests from clients.

       -o<output-port>
               Determines the port that auscope will use to connect to the audio server.

       -h<audio server name>
               Determines the desktop machine name that auscope will use to find the audio server.

       -v<print-level>
               Determines the level of printing which auscope will provide.  The print-level can be 0 or 1.  The
               larger numbers provide greater output detail.

EXAMPLES

       In the following example, mcxterm is the name of the desktop machine running the audio server,  which  is
       connected  to the TCP/IP network host tcphost.  auscope uses the desktop machine with the -h command line
       option, will listen for client requests on port 8001 and connect to the audio server on port 8000.

       Ports (file descriptors) on the network host are used to read and write the audio  protocol.   The  audio
       client auplay will connect to the audio server via the TCP/IP network host tcphost and port 8001:

              auscope -i1 -o0 -hmcxterm

              auplay -audio tcp/tcphost:8001 dial.snd

       In  the  following  example,  the  auscope  verbosity is increased to 1, and the audio client autool will
       connect to the audio server via the network host tcphost, while displaying  its  graphical  interface  on
       another server labmcx:

              auscope -i1 -o0 -hmcxterm -v1

              autool -audio tcp/tcphost:8001 -display labmcx:0.0

SEE ALSO

       nas(1), perl(1)

       Copyright 1994 Network Computing Devices, Inc.

AUTHOR

       Greg Renda, Network Computing Devices, Inc.

                                                      1.9.4                                           AUSCOPE(1)