udpxrec(1)

💖 udpxrec — a programmable multicast traffic recording utility 💖

okay bestie, welcome to udpxrec(1), the manual page for the little program that saves a slice of multicast network traffic straight to disk 🎀

---

✨ SYNOPSIS ✨

udpxrec [-v] [-b <begin_time>] [-e <end_time>] [-M <maxfilesize>] [-p
<pidfile>] [-B <bufsizeK>] [-n <nice_incr>] [-u <seconds_to_wait>] [-m
<mcast_ifc_addr>] [-l <logfile>] [-s <ssm_source_addr>] -c
<src_addr>:<port> <dstfile>

no cap, that's the whole shape of it 💅

---

🌸 DESCRIPTION 🌸

udpxrec is a utility that records — like, saves into a disk file — a segment of multicast network traffic. it's giving "grab this stream and keep it". and the amount of data that gets saved/recorded? you can specify it in length (KB) or in duration (seconds). both. either. your call, queen 👑

---

👑 OPTIONS 👑

udpxrec accepts the following options:

• -c <src_addr>:<port> — the Channel, bestie. i.e. the multicast address and port you're recording data from. iconic, mandatory, the main character of this whole operation.
• -s <ssm_source_addr> — optional SSM source address. optional!! but very useful if you know your source 🦋
• -v — enable verbose output. [default = disabled] — so by default she's quiet 🤫
• -m <mcast_ifc_addr> — IPv4 address/interface of the (multicast) source. [default = 0.0.0.0] 🌈
• -l <logfile> — log output to a file. [default = stderr] — yeah, by default the logs just vibe out to stderr 💜
• -n <nice_incr> — nice value increment. [default = 0] — polite little process, not asking for more priority than she needs 🎀
• -B <sizeK> — buffer size for inbound (multicast) data. accepted vibes are like 65536, 32Kb, 1Mb. [default = 2048 bytes] ✨
• -R <msgs> — maximum number of messages to buffer. (-1 = all) [default = 1] — lowkey the "hoard everything" switch 🍓
• -b <begin_time> — begin recording at [+]dd:hh24:mi.ss, where a + signifies relative timing (in N hours/min/sec). so like, when do we start, bestie ⏰
• -e <endtime> — stop recording at [+]dd:hh24:mi.ss, where a + signifies relative timing (in N hours/min/sec). and when do we stop 🛑
• -M <maxfilesize> — maximum size of the destination file. she will not grow past this, periodt 📏
• -p <pidfile> — pidfile for this process. MUST be specified if daemon 🚨 like, not optional, not negotiable, mandatory.
• -u <seconds_to_wait> — seconds to wait before updating you on how long till recording starts. the "are we there yet" interval 🫶

💀 heads up: -R shows up in the OPTIONS list above but she is not in the SYNOPSIS. i don't make the rules, i just report them faithfully.

---

🧚 EXAMPLES 🧚

udpxrec -b 15:45.00 -e +2:00.00 -M 1.5Gb -n 2 -B 64K -s 87.141.215.251
-c 224.0.11.31:5050 /opt/video/tv5.mpg

let me translate this absolute slay of a command line, bestie:

begin recording multicast channel 224.0.11.31:5050 from source address 87.141.215.251 at 15:45 today, finish recording in two hours or if the destination file size goes >= 1.5 Gb — whichever comes first, no cap. also: set the socket buffer to 64Kb, increment the nice value by 2, and write the captured video to /opt/video/tv5.mpg 🎬🔥

---

💜 AUTHORS 💜

Pavel V. Cherenkov and all the good people who submitted patches or otherwise contributed to the project. we love a collaborative queen 🌈🫶

---

🌟 SEE ALSO 🌟

• udpxy(1) — go read her too, iykyk ✨

---

and that's a wrap!! this page is from Version 1.0, dated November 18, 2012, brought to you by the udpxrec(1) manual. stay recording, stay slaying 💅🎀💖