1udpxrec(1)                    udpxrec manual page                   udpxrec(1)
2
3
4

NAME

6       udpxrec - a programmable multicast traffic recording utility.
7
8

SYNOPSIS

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

DESCRIPTION

16       udpxrec  is a utility designed to record (save into a disk file) a seg‐
17       ment of multicast network traffic; the amount  of  data  saved/recorded
18       could be specified in length (KB) or duration (seconds).
19
20

OPTIONS

22       udpxrec accepts the following options:
23
24
25       -v      Enable verbose output [default = disabled].
26
27       -T      Do NOT run as a daemon [default = daemon if root].
28
29       -m <mcast_ifc_addr>
30               IPv4   address/interface   of  (multicast)  source  [default  =
31               0.0.0.0].
32
33       -l <logfile>
34               Log output to file [default = stderr].
35
36       -n <nice_incr>
37               Nice value increment [default = 0].
38
39       -B <sizeK>
40               Buffer size (65536, 32Kb, 1Mb)  for  inbound  (multicast)  data
41               [default = 2048 bytes].
42
43       -R <msgs>
44               Maximum number of messages to buffer (-1 = all) [default = 1].
45
46       -b <begin_time>
47               Begin  recording  at  [+]dd:hh24:mi.ss,  '+' signifies relative
48               timing (in N hours/min/sec).
49
50       -e <endtime>
51               Stop recording at [+]dd:hh24:mi.ss, '+' signifies relative tim‐
52               ing (in N hours/min/sec).
53
54       -M <maxfilesize>
55               Maximum size of destination file.
56
57       -p <pidfile>
58               Pidfile for this process [MUST be specified if daemon].
59
60       -u <seconds_to_wait>
61               Seconds  to  wait  before  updating  on how long till recording
62               starts.
63
64

EXAMPLES

66       udpxrec  -b  15:45.00  -e  +2:00.00  -M  1.5Gb   -n   2   -B   64K   -c
67       224.0.11.31:5050 /opt/video/tv5.mpg
68
69       Begin recording multicast channel 224.0.11.31:5050 at 15:45 today, fin‐
70       ish recording in two hours or if destination file size >= 1.5  Gb;  set
71       socket  buffer to 64Kb; increment nice value by 2; write captured video
72       to /opt/video/tv5.mpg.
73
74

AUTHORS

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

SEE ALSO

81       udpxy(1)
82
83
84
85
86
87Version 1.0                    November 18, 2012                    udpxrec(1)