NAME
orb2cd11xmit - Transmit CD1.1 packets from orbserver via CD1.1 Protocol
SYNOPSIS
orb2cd11xmit [-v[v[v[v]]]] [-p pf] [-m match] [-r reject] orbname cd11_data_consumer
DESCRIPTION
The
orb2cd11xmit program reads
.*/CD11 format
orbserver(1) packets
from an
orbname, then serves as a CD1.1
data provider (as defined
by the
IDC 3.4.3 document cited below) to send these as CD1.1 frames via CD1.1 protocol
to a CD1.1
data consumer (for example an instance of the
cd11rcv2orb(1) program).
The
orbname parameter should specify the name (
host:port) of an Antelope
orbserver(1).
The
cd11_data_consumer argument should specify a CD1.1 Data Consumer in the form
host:port.
If
host is omitted, the data consumer is assumed to be running on
localhost.
Signature creation for packet authentication is outsourced to an instance of the
versignd(1) daemon, which must be running in order for
orb2cd11xmit to function.
An authentication key identifier, specified in the
orb2cd11xmit parameter file, is given
to
versignd(1) to identify the authentication protocol to be used. Incoming packets,
such as CD1.1
Connection Response and
AckNack packets, are signed via the same
method.
OPTIONS
-
-m match
Regular expression of orbserver(1) source-names to match. If unset, this defaults to .*/CD11.
-
-n
Test mode: ignore authentication on incoming packets
-
-p pf
Parameter file name. If omitted, this defaults to orb2cd11xmit.pf.
-
-r reject
Regular expression of orbserver(1) source-names to reject.
-
-v[v[v[v]]]
Verbose. Increasing numbers of v options increase the level of verbosity. With four v's,
print summaries of all incoming and outgoing CD1.1 packets are dumped to stderr.
PARAMETER FILE
Parameter File Parameters
-
auth_key_identifier
This integer is given to the versignd(1) daemon for packet authentication.
-
epoch_to_sequence_modulo_sec
orb2cd11xmit creates unique sequence numbers by dividing the nominal epoch time of the
packet by a standard number of seconds equal to the nominal packet length. This parameter gives
that divisor.
-
frame_creator
This string gives the name of the frame creator, embedded in transmitted packets per the CD1.1 protocol.
-
frame_destination
This string gives the destination name for CD1.1 protocol packets, which per protocol
should be set to 0 for multiple or unspecified destinations.
-
series_number
This integer parameter gives the series number embedded in CD1.1 packet headers.
-
station
This string parameter gives the name of the CD1.1 station being transmitted.
-
station_type
This string parameter is the station type per CD1.1 protocol, for example IMS, IDC, NDC
-
time_intervals_sec
This array contains any time-interval configuration parameters for orb2cd11xmit. All of these values
must be specified in seconds.
-
time_intervals_sec{internal_timeout}
The internal_timeout value is used for a variety of purposes inside orb2cd11xmit, for example
orbreap_timeout(3) settings and bnstimeout(3) settings on the CD1.1 socket(s).
-
time_intervals_sec{establishment_maxwait}
The establishment_maxwait value sets how long orb2cd11xmit will wait for protocol handshake
exchanges to finish (connection response and option request frames, and connection to assigned port) once
a connection to the receiver's well-known port is established, before giving up on the new connection
and trying again to contact the receiver's well-known port.
-
versignd_address
This parameter gives a host:port name for a versignd(1) daemon used to create authentication
signatures for packets.
Parameter File Example
frame_creator ORB2CDXM
frame_destination 0
auth_key_identifier 1
epoch_to_sequence_modulo_sec 10
versignd_address localhost:6511
series_number 1
station BRTT
station_type IMS
time_intervals_sec &Arr{
internal_timeout 1
establishment_maxwait 120
}
EXAMPLE
% orb2cd11xmit -v -m '.*/CD11' localhost ctbto.org:12677
SEE ALSO
orb2cd11s(1), cd11s2cd11(1), cd11rcv2orb(1), cd11(3)
CTBTO (2002). Formats and Protocols for Continuous Data CD-1.1, Document ID IDC 3.4.3,
Preparatory Commission for the Comprehensive Nuclear-test-ban Treaty Organization.
AUTHOR
Kent Lindquist