gbch-uconv - dump out GNUbatch user permissions to file

# NAME

gbch-uconv - dump out GNUbatch user permissions to file

# SYNOPSIS

gbch-uconv [ -D dir ] [ -v n ] [ -e n ] [ -s ] [ -f ] user file outfile

# DESCRIPTION

gbch-uconv converts the GNUbatch user file, which is usually btufile held in the batch spool directory to an executable shell script file outfile, which if executed, would recreate the GNUbatch users permissions with the same options and privileges.

gbch-uconv understands the format of the saved user file for versions of Xi-Batch 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.

User file

  This is the file containing the attributes of the variables, btufile in the batch spool directory.

Output file

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

  This file should be run before restarting the scheduler.

# OPTIONS

-D directory

  specifies the source directory for the users and user 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-uconv -D '${SPOOLDIR-/var/spool/gnubatch}' ...

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

-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 user file, up to the limit of errors given by the -e option.

-s

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

-v number

  Tell gbch-uconv that the user file is for release number of Xi-Batch, where number is 4 to 6.

  This may be necessary where the user file is corrupted and gbch-uconv cannot guess what is meant.

# SEE ALSO

gbch-cjlist(8), gbch-cvlist(8), gbch-ciconv(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.