gbch-ciconv - dump out GNUbatch command interpreters to a shell script
gbch-ciconv [ -D dir ] [ -v n ] [ -e n ] [ -u ] [ -s ] [ -f ] ci file outfile
gbch-ciconv converts GNUbatch command interpreters held in the batch spool directory to an executable shell script which may be used to re-install them. This may be useful for backup purposes or for one stage in upgrade from one release of GNUbatch to another.
gbch-ciconv understands the format of the saved job file for versions of GNUbatch going back to release 4, and when presented with a saved file, will attempt to work out from the format which release it relates to.
In addition to options, two arguments are always supplied to gbch-cvlist.
This is the file containing the attributes of the variables, cifile
in the batch spool directory, or as relocated by re-specifying
SPOOLDIR
.
This file is created by gbch-ciconv to contain the executable shell script, containing gbch-cichange(1) commands, which may be used to recreate the command interpreters.
specifies the source directory for the command interpreter file. It
can be specified as $SPOOLDIR
or ${SPOOLDIR-/var/spool/gnubatch}
etc and the environment and/or gnubatch.conf will be interrogated
to interpolate the value of the environment variable given.
If you use this, don't forget to put single quotes around it thus:
gbch-ciconv -D '${SPOOLDIR-/var/spool/gnubatch}' ...
otherwise the shell will try to interpret the $
construct and not
gbch-ciconv.
Tolerate n errors of the kinds denoted by the other options before giving up trying to convert the file.
Ignore format errors in the saved command interpreter file up to the limit of errors given in the -e option.
Ignore file size errors in the saved command interpreter file (up to the number of total errors given by the -e option).
Do not check user names (not used, but included for consistency with gbch-cjlist(8) and gbch-cvlist(8)).
Tell gbch-ciconv that the job file is for release number of GNUbatch, where number is 4 to 6.
This may be necessary where the command interpreter file is corrupted and gbch-ciconv cannot guess what is meant.
gbch-cjlist(8), gbch-cvlist(8), gbch-uconv(8).
Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
John M Collins, Xi Software Ltd.