fuvst_sniffer(1)

🌸 NAME 🌸

okay so bestie, meet fuvst_sniffer — it lives in section 1, the General Commands Manual, and the header literally says fuvst_sniffer(1) on both ends which is giving symmetrical queen energy 👑

fuvst_sniffer — http://osmocom-analog.eversberg.eu/docs/

that's the whole one-liner. it's just a URL. the docs live there. go look. 💖

✨ SYNOPSIS ✨

fuvst_sniffer -k <kanal/channel> [options] [station_id]

🌈 Global options 🌈

• -h --help — the help. that's it, that's the whole vibe 🫶
• --config [~/]<path to config file> — hand it a config file to use. if the path starts with ~/, the path is at your home dir. every line in the config file is one option, and you must not write - or -- in there, no cap. default: (null)
• --no-config — even if a config file exists, don't use it. respectfully, ignored. 🙈
• -v --verbose <level> | <level>,<category>[,<category>[,...]] | list — use list to get a list of all levels and categories. verbose level: a digit of debug level (default = '3'). verbose level+category: level digit followed by one or more categories -> if no category is specified, all categories are selected.
• -v --verbose date — show the date with debug output 📅
• -k --kanal <channel> — (the description lands on the next one, keep scrolling bestie)
• -k --channel <channel> — channel (German = Kanal) number of "Sender" (German = Transceiver) 📡
• -a --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number (default = 'hw:0,0'). you may specify a different recording device by using /. don't set it for SDR! 🎧
• -s --samplerate <rate> — sample rate of sound device (default = '48000')
• -i --interval 0.1..25 — interval of processing loop in ms (default = '1.0' ms). use 10 to drastically reduce CPU usage. in case of buffer underrun, increase buffer accordingly. 🔥
• -b --buffer <ms> — how many milliseconds are processed in advance (default = '50'). a buffer below 10 ms requires a low interval like 0.1 ms.
• --rx-gain <dB> — raise/lower receiver's RX level by the given gain in dB. (works with sound card only.)
• --tx-gain <dB> — raise/lower transmitters's RX level by the given gain in dB. (works with sound card only.)
• -e --echo-test — use echo test, to send back audio from mobile phone's microphone to the speaker. (German: 'Blasprobe'). 💀
• -c --call-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number for headset (default = ''). you may specify a different recording device by using /.
• --call-samplerate <rate> — sample rate of sound device for headset (default = '48000')
• --call-buffer <ms> — how many milliseconds are processed in advance (default = '50')
• -x --osmocc-cross — enable built-in call forwarding between mobiles. be sure to have at least one control channel and two voice channels. alternatively use one combined control+voice channel and one voice channels. ✨
• -o --osmocc-sock — disable built-in call control and offer socket
• --cc "<osmo-cc arg>" [--cc ...] — pass arguments to Osmo-CC endpoint. use '-cc help' for description.
• --no-l16 — disable L16 (linear 16 bit) codec.
• -t --tones 0 | 1 — connect call on setup/release to provide classic tones towards fixed network (default = '1') ☎️
• -l --loopback <type> — loopback test: 1 = internal | 2 = external | 3 = echo
• -r --realtime <prio> — set prio: 0 to disable, 99 for maximum (default = 0)
• --fast-math — use fast math approximation for slow CPU / ARM based systems. 🐢➡️🐇
• --write-rx-wave <file> — write received audio to the given wave file.
• --write-tx-wave <file> — write transmitted audio to the given wave file.
• --read-rx-wave <file> — replace received audio by the given wave file.
• --read-tx-wave <file> — replace transmitted audio by the given wave file.

🦋 Network specific options 🦋

use '-k BS -k BSC' to trace both sides of an SS7 link, using a stereo input. use '-v 0' for total message logging, including errors. use '-v 1' for all messages, including resends (and weird messages from SAE). use '-v 2' for messages between DKO and MSC. 🫶

keyboard tea, since we're all main characters here:

• press digits '0'..'9' and then the 'd' key to dial towards mobile station.
• press the 'h' key to hangup.
• press the 'w' key to toggle display of RX wave form.
• press the 'c' key to toggle display of channel status.
• press the 'm' key to toggle display of measurement value.

💫 SEE ALSO 💫

the full documentation for [0;33m[1;31mDOPTIONS[0;m[0;33m is maintained as a Texinfo manual. (yes bestie, those raw escape codes are literally baked right into the page like that, I'm not touching them, not my business 💅) if the info and [0;33m[1;31mDOPTIONS[0;m[0;33m programs are properly installed at your site, the command

info [0;33m[1;31mDOPTIONS[0;m[0;33m

should give you access to the complete manual.

and that's the whole page! the footer just says fuvst_sniffer(1) again, which means it's page 1 of the General Commands Manual, and honestly? iconic bookend behaviour. periodt. 🌈👑💖