NAME

orbxfer2 - transport arbitrary files using the orb protocol

SYNOPSIS

orbxfer2 [-p pf] [-w dir] [-v][file ...] orb
orbxfer2 [-p pf] [-S state] [-v] orb

DESCRIPTION

orbxfer2 uses an orbserver to transport files. It has two modes, transmit and receive. In transmit mode, indicated by files on the command line or a directory to watch (the -w option), it reads files, converting them into packets on the output orbserver.

In receive mode, it reads xfer packets from an orbserver and writes these out to new files with the original base name. It can optionally preserve directory structure, but all files are written into some destination directory chosen in the parameter file.

Recommended configuration

When transferring files with orbxfer2, the preferred configuration is the following:

If there's only one reader from the source, that reader should never see any missing files, as the source orbxfer2 waits for the reader to catch up. However, if there is more than one reader, it's possible for packets to fall off the source orb before they're copied by the destination orbxfer2.

The orbxfer demo is an example of this setup.

OPTIONS

PARAMETER FILE

Receive Parameters

Transmit Parameters

EXAMPLE



% orbxfer2 -v /etc/motd /etc/skel :
orbxfer2: $Revision: 1.7 $ $Date: 2005/06/13 17:43:04 $
orbxfer2: starting '/etc/motd'
orbxfer2: finished '/etc/motd'
orbxfer2: starting '/etc/skel/.profile'
orbxfer2: finished '/etc/skel/.profile'
orbxfer2: starting '/etc/skel/local.cshrc'
orbxfer2: finished '/etc/skel/local.cshrc'
orbxfer2: starting '/etc/skel/local.login'
orbxfer2: finished '/etc/skel/local.login'
orbxfer2: starting '/etc/skel/local.profile'
orbxfer2: finished '/etc/skel/local.profile'

% orbxfer2 -v -w xfer : &
% cp /etc/motd xfer
% orbxfer2: starting 'xfer/motd'
orbxfer2: finished 'xfer/motd'

% orbxfer2 -v :
orbxfer2: $Revision: 1.7 $ $Date: 2005/06/13 17:43:04 $
orbxfer2: Starting at pktid=0
orbxfer2: receiving '/etc/motd'
orbxfer2: received etc/motd (60 bytes, 2 packets)
orbxfer2: receiving '/etc/skel/.profile'
orbxfer2: received etc/skel/.profile (144 bytes, 2 packets)
orbxfer2: receiving '/etc/skel/local.cshrc'
orbxfer2: received etc/skel/local.cshrc (124 bytes, 2 packets)
orbxfer2: receiving '/etc/skel/local.login'
orbxfer2: received etc/skel/local.login (607 bytes, 2 packets)
orbxfer2: receiving '/etc/skel/local.profile'
orbxfer2: received etc/skel/local.profile (582 bytes, 2 packets)
orbxfer2: receiving 'xfer/motd'
orbxfer2: received xfer/motd (60 bytes, 2 packets)

DIAGNOSTICS

orbxfer2 avoids overfilling the orb by watching orb readers which match (by default) (orb2orb|orbxfer2). If no readers are present, it stalls until a reader starts. Thereafter, it stalls if that reader appears to be falling well behind.

SEE ALSO

orbxfer(1) (the original)
$ANTELOPE/demo/orbxfer

BUGS AND CAVEATS

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.7 Darwin 7.9.0 2005-07-18
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com