gbch-cvlist - dump out GNUbatch variables to a shell script

# NAME

gbch-cvlist - dump out GNUbatch variables to a shell script

# SYNOPSIS

gbch-cvlist [ -D dir ] [ -e n ] [ -s ] [ -f ] var file outfile

# DESCRIPTION

gbch-cvlist converts GNUbatch variables 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.

In addition to options, two arguments are always supplied to gbch-cvlist.

Variable list file

  This is the file containing the attributes of the variables, btsched_vfile in the batch spool directory, by default /usr/spool/batch, or as relocated by re-specifying `SPOOLDIR`.

Output file

  This file is created by gbch-cvlist to contain the executable shell script, containing gbch-var(1) commands, which may be used to recreate the variables.

# OPTIONS

-D directory

  Specifies the source directory for the variables and var file if not the current directory. It can be specified as `$SPOOLDIR` or `${SPOOLDIR-/var/spool/gnubatch}` etc and the environment and/or /etc/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-cvlist -D '${SPOOLDIR-/var/spool/gnubatch}' ...

  otherwise the shell will try to interpret the `$` construct and not gbch-cvlist.

-e n

  Tolerate n errors of the kinds denoted by the other options before giving up trying to convert the file.

-f

  Ignore format errors in the saved variable file, skip over invalid entries up to the limit given by the -e option.

-s

  Ignore file size errors in the saved variable file (up to the number of total errors given by the -e option).

# SEE ALSO

gbch-ciconv(8), gbch-cjlist(8), gbch-uconv(8).

# COPYRIGHT

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.

# AUTHOR

John M Collins, Xi Software Ltd.