CPLIST(8)

NAME
cplist - dump out GNUspool printers to a shell script

SYNOPSIS
cplist [ -D dir ] [ -e n ] [ -s ] [ -f ] [ -l ] ptr file outfile

DESCRIPTION
cplist 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.

cplist 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.

cplist understands the format of the saved printer file for versions of GNUspool going back to release 16, and when presented with a saved file, will attempt to work out from the format which release it relates to.

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 cplist.

Printer list file
    This is the file containing the attributes of the printers, spshed_pfile in the spool directory, by default /var/spool/gnuspool, or as relocated by re-specifying "SPOOLDIR".

Output file
    This file is created by cplist to contain the executable shell script, containing spadd(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 /etc/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:

     cplist -D '${SPOOLDIR-/var/spool/gnuspool}' ...

    otherwise the shell will try to interpret the "$" construct and not cplist.

-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. This may be relevant to pre-release 18 files.

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

SEE ALSO
cjlist(8), setspdir(8), spuconv(8).

AUTHOR
John M Collins, Xi Software Ltd.