AUSCOPE(1)

💖 AUSCOPE(1) — the manual, but make it cute 💖

okay bestie, sit down, hydrate, and let me tell you about auscope from the General Commands Manual era. she's a whole vibe and she's about to make your audio packets make sense. 🎀

---

✨ NAME ✨

auscope — Network Audio System Protocol Filter. yes that's her full government name. 🫶

---

🌸 SYNOPSIS 🌸

auscope [ option ] ...

that's it. that's the whole summoning ritual. ✨

---

🦋 DESCRIPTION 🦋

so auscope is an audio protocol filter, and what she does is iconic: she lets you peek at the network packets flying back and forth between an audio application and an audio server. it's giving wiretap but for audio and fully legal. 👑

real talk though — auscope is written in Perl, so you literally have to have Perl installed on your machine to run her. no Perl, no auscope, periodt. 😭

and listen, if your Perl executable is not installed as /usr/local/bin/perl, you gotta go edit the first line of the auscope script so it points at wherever your Perl actually lives. or, alternative slay, you can just invoke her like this:

perl auscope [ option ] ...

...which works assuming the Perl executable is in your path. easy. 💅

now, for the ✨ mechanics ✨ — to actually operate, auscope has to know three things:

• the port on which she should listen for audio clients
• the name of the desktop machine on which the audio server is running
• the port to use to connect to the audio server

and here's the lil detail everyone forgets: both the output port (server) and the input port (client) are automatically biased by 8000. 🎀

defaults, bestie, write these down:

• the output port defaults to 0
• the input port defaults to 1

---

💅 ARGUMENTS 💅

• -i<input-port> — specify the port that auscope will use to take requests from clients. that's the listening port, her lil ears. 👂
• -o<output-port> — determines the port that auscope will use to connect to the audio server. her outgoing line, her dial-out moment. 📞
• -h<audio server name> — determines the desktop machine name that auscope will use to find the audio server. where is the server, bestie, she needs the address. 🗺️
• -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. more number = more yapping = more info. 🗣️✨

---

🌈 EXAMPLES 🌈

okay so in this first example, mcxterm is the name of the desktop machine running the audio server, and it's connected to the TCP/IP network host tcphost. auscope uses the desktop machine via the -h command line option, will listen for client requests on port 8001, and connects 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

and in this second 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

like?? the range?? she's doing packet inspection and letting you see the GUI somewhere else entirely. main character energy fr fr. 💖

---

👑 SEE ALSO 👑

nas(1), perl(1)

go read those too, they're the supporting cast and they ate. 🫶

---

🎀 COPYRIGHT 🎀

Copyright 1994 Network Computing Devices, Inc.

---

🦋 AUTHOR 🦋

Greg Renda, Network Computing Devices, Inc.

---

and that's the whole page, bestie. version 1.9.4, straight from the General Commands Manual — now go peek at some packets, you absolute legend. 💖✨🎀🦋🌸💅🫶🔥👑🌈⭐