orbxfer - move arbitrary files using an orb
orbxfer [-b pktsize] [-ovv] file ... orb
orbxfer [-b pktsize] [-ovv] -w dir orb
orbxfer [-d dir] [-S state] [-m match] [-r reject] [-s where] [-ovv] orb
orbxfer may be used to transfer arbitrary files to and from an
orbserver(1). The first example above puts all the named files
onto the named orb as a series of packets. The second example watches the
directory dir and puts any file which appears in that directory onto the orb,
and then removes it from the directory.
The packets created by orbxfer are given srcnames
where the source is the original hostname, the type is file, and the
remainder of the source name is the original filename. For example,
crestone.brtt.com/file/rtexec.pf.
The final example reads
orb packets and reconstructs the original files.
All received
files are deposited in the same directory, by default the directory in
which orbxfer is run.
-
-b pktsize
choose some size for the orb packets. The default is 1200.
-
-d dir
Put received files into this directory.
-
-m match
-
-r reject
These are standard match and reject parameters, which affect what packets are
examined by orbxfer. The receiving orbxfer sets these parameters by default
so that it does not copy packets from the local machine, and sees only /file/
or /raw/ packets (packets created by orbxfer).
-
-o
The original packet type used by orbxfer was raw, but file is
more descriptive. However, to send to older versions of orbxfer, it is necessary
to use the original raw packet type, with the -o option.
-
-S state
Use a state file to resume at the same place in the orb after a shutdown
(receiver only)
-
-s where
Position the read pointer to the specified time in the orb when starting
(receiver only). The time may be "newest" or "oldest" as well as an
explicit time.
-
-v
Mention each file sent or received.
-
-vv
Mention each packet sent or received.
-
-w dir
Watch the directory dir and take files from that directory into the orb.
% orbxfer -vv -d /etc termcap :
orbxfer: packet #0 for termcap
orbxfer: packet #1 for termcap
orbxfer: packet #2 for termcap
orbxfer: packet #3 for termcap
orbxfer: packet #4 for termcap
orbxfer: transferred termcap to orb
% orbxfer -d /tmp/dq -vv :
orbxfer: received packet #0 for 'termcap'
orbxfer: received packet #1 for 'termcap'
orbxfer: received packet #2 for 'termcap'
orbxfer: received packet #3 for 'termcap'
orbxfer: received packet #4 for 'termcap'
orbxfer: received packet #5 for 'termcap'
orbxfer: received termcap (136545 bytes, 6 packets)
orb2orb(1)
orbserver(1)
In receiver mode, if a received file already exists, it is quietly replaced.
No locking is employed, so it's quite possible for a file to be modified
as orbxfer copies it to an orb. This will typically result in a failure of the file
transfer, because the checksum is calculated once before the transfer is
initiated. In this case, the file should be transferred again (by hand).
Daniel Quinlan
Table of Contents
Antelope Release 4.7 Darwin 7.9.0 2005-07-19
Boulder Real Time Technologies, Inc
For more information, contact support@brtt.com