NAME
orb2orb_pfconvert - Convert orb2orb parameter-file from Antelope 5.9 to 5.10 format
SYNOPSIS
orb2orb_pfconvert [-n] pfname [pfout]
DESCRIPTION
The
orb2orb_pfconvert program modifies a named parameter-file
pfname to be compatible with Antelope 5.10 and later versions of
the
orb2orb(1) program. If only
pfname is specified, any pre-existing
file
pfname.pf is moved to
pfname.pf-- and the file
pfname.pf
is rewritten. If
pfout is specified, the resulting parameter-file is written
to the specified filename.
Reports about the changes being made are emitted to
stderr, prefaced with
hash marks to make them harmless comments in case they get accidentally redirected
into the output file.
OPTIONS
-
-n
No-output option. orb2orb_pfconvert reports what it would do but does not
output an edited parameter file.
EXAMPLE
% orb2orb_pfconvert orb2orb59
# Adding 'name reader_1' to 'connections' array 0
# Adding 'name writer_1' to 'connections' array 1
# Adding 'name writer_2' to 'connections' array 2
# Adding 'acknowledge no' to 'connections_defaults{write}' array
# Changing 'max_queue' from 100 to 10000 in 'connections_defaults{write}' array
# Removing 'name' from 'connections_defaults{shared}' array
# Adding 'verbose notify' to 'connections_defaults{shared}' array
# Moving 'connections_special{status_create}' to 'connections_special{status}'
# Moving 'connections_special{log_create}' to 'connections_special{logs}'
# Adding 'verbose notify' to 'connections_special{status}' array
# Adding 'verbose notify' to 'connections_special{logs}' array
# Adding 'commands' array to 'connections_special' array
# Adding 'state' array to 'connections_special' array
# Adding 'retain_unused_stateinfo 604800' to 'time_intervals_sec' array
# Moving 'orb2orb59.pf' to 'orb2orb59.pf--'
# Writing to orb2orb59.pf
%
SEE ALSO
orb2orb(1), pf(5)
BUGS AND CAVEATS
orb2orb_pfconvert relies on the default
orb2orb.pf parameter-file
in
$ANTELOPE/data/pf to be unmodified and up-to-date.
orb2orb_pfconvert does not preserve comments in the parameter file.
orb2orb_pfconvert assumes that the input is a valid Antelope 5.9 version
orb2orb
parameter-file. The
orb2orb_pfconvert program is an updater, not a verifier --
it does not check for the presence of all necessary entries.
orb2orb_pfconvert will complain and exit rather than overwriting any previously
made backup files.
AUTHOR
Kent Lindquist