NAME
orbcp - orb copy program
SYNOPSIS
orbcp -orbin in_orbname -orbout out_orbname [-src srcexpr]
[-ircnt] [-orcnt] [-pktstart pktid]
[-rcnt_time minutes] [-npackets npackets]
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
orbcp is a program for copying packets from one orb to another.
OPTIONS
-
-orbin in_orbname
Name of input orbserver. This argument is required.
-
-orbout out_orbname
Name of output orbserver. This argument is required.
-
-src srcexpr
A source expression string. This is used to sift the types of packets
for copying. If this is not specified, then all packet types are
copied.
-
-ircnt
Input reconnect flag. If this is specified, then orbcp will
attempt to reconnect to the input orbserver if there is a
read error, an end of file, or if there has been no activity
on the read socket for some specified time (see -rcnt_time).
When orbcp decides to reconnect to the input orbserver it
first closes the exisiting socket, reopens a read connection
to the orbserver, selects using the -src selection string (if
specified), and attempts to position the read pointer to the
next pktid that should be read. If the input reconnect flag
is not specified, then any read errors will cause the program
to terminate.
-
-orcnt
Output reconnect flag. If this is specified, then orbcp will
attempt to reconnect to the output orbserver if there is a
write error.
When orbcp decides to reconnect to the output orbserver it
suspends all reads until a new output connection is established.
If the output reconnect flag
is not specified, then any write errors will cause the program
to terminate.
-
-pktstart pktid
A packet id for initially positioning the read pointer. If this
is not specified, then the read pointer will be initially
positioned to the newest packet.
-
-rcnt_time minutes
The maximum number of minutes for determining inactivity on the
read socket. The default value is 10 minutes.
-
-npackets npackets
A total packet count for copying. orbcp will exit when this
count is reached. If not specified, then orbcp will execute
indefinitely.
DIAGNOSTICS
-
orbcp: Need argument for -in_orbname
-
orbcp: Need argument for -out_orbname
-
orbcp: Need argument for -src
-
orbcp: Need argument for -pktstart
-
orbcp: Need argument for -rcnt_time
-
orbcp: Need argument for -npackets
-
orbcp: Illegal argument '%s'
-
orbcp: No input -in_orbname specified
-
orbcp: No output -out_orbname specified
-
orbcp: orbopen() error for '%s'
-
orbcp: orbselect(%s, %s) error
-
orbcp: orbseek() error for '%s'
-
orbcp: orbreap_nd() error for '%s'
-
orbcp: orbput() error for '%s'
SEE ALSO
orb2orb(1)
AUTHOR
Danny Harvey
Antelope User Group Contributed Software