home | help
udpxrec(1)		       udpxrec manual page		      udpxrec(1)

NAME
     udpxrec - a programmable multicast traffic recording utility.

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

DESCRIPTION
     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).

OPTIONS
     udpxrec accepts the following options:

     -c <src_addr>:<port>
	     Channel i.e. multicast address and port from which to record data.

     -s <ssm_source_addr>
	     Optional SSM source address.

     -v      Enable verbose output [default = disabled].

     -m <mcast_ifc_addr>
	     IPv4 address/interface of (multicast) source [default = 0.0.0.0].

     -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 [de-
	     fault = 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.

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

     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 destina-
     tion file size >= 1.5 Gb; set socket buffer to 64Kb; increment  nice  value
     by 2; write captured video to /opt/video/tv5.mpg.

AUTHORS
     Pavel  V. Cherenkov and all the good people who submitted patches or other-
     wise contributed to the project.

SEE ALSO
     udpxy(1)

Version 1.0			November 18, 2012		      udpxrec(1)

home | help