GSPL-CPLIST(8)
NAME
gspl-plist - dump out GNUspool printers to a shell script
SYNOPSIS
gspl-plist [ -D dir ] [ -e n ] [ -s ] [ -f ] [ -l ] ptr file outfile
DESCRIPTION
gspl-plist converts GNUspool printers held in the 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 GNUspool to another.
gspl-plist considers a GNUspool spool directory, by default the current
directory, takes the printer file, which is usually spshed_pfile, and
generates a shell script file outfile, which if executed, would
recreate the GNUspool printers with the same options.
N.B. setup files are not copied, this should be done as a separate
exercise. In many cases these can be separately copied over from one
release to the next.
In addition to options, two arguments are always supplied to gsplplist.
- Printer list file
- This is the file containing the attributes of the printers,
spshed_pfile in the spool directory or as relocated by respecifying "SPOOLDIR". - Output file
- This file is created by gspl-plist to contain the executable shell script, containing gspl-padd(1) commands, which may be used to reinstall the printers.
OPTIONS
- -D directory
- specifies the source directory for the printers and ptr file.
It can be specified as $SPOOLDIR or
"${SPOOLDIR-/var/spool/gnuspool}" etc and the environment
and/or gnuspool.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:
gspl-plist -D '${SPOOLDIR-/var/spool/gnuspool}' ... - otherwise the shell will try to interpret the "$" construct and not gspl-plist.
- -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 (invalid form types etc) in the saved
- printer file up to the limit of number of errors given by the
-e option. - -l Modify the shell script created so that printers recreated with
- be "local only" access rather than network wide.
- -s Ignore file size errors in the saved printer file (up to the
- number of total errors given by the -e option.
SEE ALSO
gspl-cjlist(8), gspl-setspdir(8), gspl-spuconv(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.