1Multicat(1)                 General Commands Manual                Multicat(1)
2
3
4

NAME

6       multicat - Multicast equivalent of Netcat
7

SYNOPSIS

9       multicat  [-i  <RT  priority>]  [-t  <ttl>]  [-f]  [-p  <PCR  PID>] [-s
10       <chunks>] [-n <chunks>] [-k <start  time>]  [-d  <duration>]  [-a]  [-r
11       <file  duration>]  [-S  <SSRC IP>] [-u] [-U] [-m <payload size>] <input
12       item> <output item>
13

DESCRIPTION

15       Multicat is a 1 input/1 output application. Inputs and outputs  can  be
16       network streams (unicast and multicast, IPv4 and IPv6), files, directo‐
17       ries, character devices or FIFOs. It  is  thought  to  be  a  multicast
18       equivalent of the popular netcat tool.
19
20       Multicat  tries  to rebuild the internal clock of the input stream; but
21       it wants to remain agnostic of what is transported, so in case of files
22       and  directories,  the said clock is stored to an auxiliary file (exam‐
23       ple.aux accompanies example.ts) while recording. Other inputs are  con‐
24       sidered  "live",  and the input clock is simply derived from the recep‐
25       tion time of the packets.
26

ITEMS

28       Item format <file path | device path | FIFO path | network host>
29
30       Host  format  [<connect  addr>[:<connect  port>]][@[<bind  addr][:<bind
31       port>]][/<options>]
32

OPTIONS

34       -a Append to existing destination file (risky)
35
36       -d <duration>
37              Exit after a definite time (in 27 MHz units)
38
39       -f     Output packets as fast as possible
40
41       -h     Show summary of options
42
43       -i <RT priority>
44              Real time priority
45
46       -k <time>
47              Start  at  the  given position (in 27 MHz units, negative = from
48              the end)
49
50       -m <payload size>
51              Size  of  the  payload  chunk,  excluding  optional  RTP  header
52              (default 1316)
53
54       -n <chunks>
55              Exit after playing N chunks of payload
56
57       -p <PCR PID>
58              PCR PID
59
60       -r <duration>
61              In  directory  mode,  rotate  file after this duration (default:
62              97200000000 ticks = 1 hour)
63
64       -s <chunks>
65              Skip the first N chunks of payload
66
67       -S <SSRC IP>
68              Overwrite or create RTP SSRC
69
70       -t <ttl>
71              TTL of the packets send by multicat
72
73       -u     Source has no RTP header
74
75       -U     Destination has no RTP header
76
77       -X     Pass-thought all packets to stdout
78

SEE ALSO

80       aggregartp(1), reordertp(1).  ingests(1).  offsets(1).
81       Read the README file for more information about  the  configuration  of
82       multicat.
83

AUTHOR

85       multicat was written by Christophe Massiot.
86

LICENCE

88       This program is free software; you can redistribute it and/or modify it
89       under the terms of version 2 of the GNU General Public License as  pub‐
90       lished by the Free Software Foundation.
91
92       This  manual page was written by Rémi Duraffort <ivoire at videolan dot
93       org>, for the Debian project (and may be used by others).
94
95
96
97Multicat 1.0                    August 23, 2010                    Multicat(1)
Impressum