udpxrec man page

udpxrec — a programmable multicast traffic recording utility.


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>] -c <src_addr>:<port> <dstfile>


udpxrec is a utility designed to record (save into a disk file) a segment of multicast network traffic; the amount of data saved/recorded could be specified in length (KB) or duration (seconds).


udpxrec accepts the following options:


Enable verbose output [default = disabled].


Do NOT run as a daemon [default = daemon if root].

-m <mcast_ifc_addr>

IPv4 address/interface of (multicast) source [default =].

-l <logfile>

Log output to file [default = stderr].

-n <nice_incr>

Nice value increment [default = 0].

-B <sizeK>

Buffer size (65536, 32Kb, 1Mb) for inbound (multicast) data [default = 2048 bytes].

-R <msgs>

Maximum number of messages to buffer (-1 = all) [default = 1].

-b <begin_time>

Begin recording at [+]dd:hh24:mi.ss, '+' signifies relative timing (in N hours/min/sec).

-e <endtime>

Stop recording at [+]dd:hh24:mi.ss, '+' signifies relative timing (in N hours/min/sec).

-M <maxfilesize>

Maximum size of destination file.

-p <pidfile>

Pidfile for this process [MUST be specified if daemon].

-u <seconds_to_wait>

Seconds to wait before updating on how long till recording starts.


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

Begin recording multicast channel at 15:45 today, finish recording in two hours or if destination file size >= 1.5 Gb; set socket buffer to 64Kb; increment nice value by 2; write captured video to /opt/video/tv5.mpg.


Pavel V. Cherenkov and all the good people who submitted patches or otherwise contributed to the project.

See Also


Referenced By


November 18, 2012 Version 1.0 udpxrec manual page