1UDP-RECEIVER(1)                     Udpcast                    UDP-RECEIVER(1)
2
3
4

NAME

6       udp-receiver - receive files broadcast by udp-sender
7

SYNOPSIS

9       ./udp-receiver [--file file] [--pipe pipe] [--portbase portbase]
10       [--interface net-interface] [--log file] [--ttl time-to-live]
11       [--mcast-rdv-address mcast-rdv-address] [--nokbd] [--exitWait
12       milliseconds]
13

DESCRIPTION

15       "Udp-receiver" is used to receive files sent by "udp-sender" (for
16       instance a disk image).
17

OPTIONS

19       Basic options
20
21       --file file
22           Writes received data to file. If this parameter is not supplied,
23           received data is written to stdout instead.
24
25       --pipe command
26           Sends data through pipe after receiving it. This is useful for
27           decompressing the data, or for filling in unused filesystem blocks
28           that may have been stripped out by udp-sender. The command gets a
29           direct handle on the output file or device, and thus may seek
30           inside it, if needed. "Udpcast" itself also keeps a handle on the
31           file, which is used for an informational progress display. The
32           command's stdin is a pipe from udp-receiver. Example: "udp-receiver
33           -p "gzip -dc""
34
35       --log file
36           Logs some stuff into file.
37
38       --nosync
39           Do not open target in synchronous mode. This is the default when
40           writing to a file or a pipe.
41
42       --sync
43           Write to target in synchronous mode. This is the default when
44           writing to a device (character or block)
45
46       --nokbd
47           Do not read start signal from keyboard, and do not display any
48           message telling the user to press any key to start.
49
50       --start-timeout sec
51           receiver aborts at start if it doesn't see a sender within this
52           many seconds. Furthermore, the sender needs to start transmission
53           of data within this delay. Once transmission is started, the
54           timeout no longer applies.
55
56       Networking options
57
58       --portbase portbase
59           Default ports to use for udpcast. Two ports are used: portbase and
60           portbase+1 . Thus, Portbase must be even. Default is 9000. The same
61           portbase must be specified for both "udp-sender" and
62           "udp-receiver".
63
64       --interface interface
65           Network interface used to send out the data. Default is "eth0"
66
67       --ttl ttl
68           Time to live for connection request packet (by default connection
69           request is broadcast to the LAN's broadcast address. If ttl is set,
70           the connection request is multicast instead to 224.0.0.1 with the
71           given ttl, which should enable udpcast to work between LANs. Not
72           tested though.
73
74       --mcast-rdv-address address
75           Uses a non-standard multicast address for the control connection
76           (which is used by the sender and receivers to "find" each other).
77           This is not the address that is used to transfer the data. By
78           default "mcast-rdv-address" is the Ethernet broadcast address if
79           "ttl" is 1, and 224.0.0.1 otherwise. This setting should not be
80           used except in very special situations, such as when 224.0.0.1
81           cannot be used for policy reasons.
82
83       --exit-wait milliseconds
84           When transmission is over, receiver will wait for this time after
85           receiving the final REQACK. This is done in order to guard against
86           loss of the final ACK. Is 500 milliseconds by default.
87

SEE ALSO

89       udp-sender
90

AUTHOR

92       Alain Knaff
93
94
95
96current                          July 28, 2009                 UDP-RECEIVER(1)