GSPL-SETSPDIR(8)
NAME
gspl-setspdir - tidy up or redistribute GNUspool jobs into
subdirectories
SYNOPSIS
gspl-setspdir [ -s n ] [ -r ] [ -d ] [ -f form ] [ -y ]
DESCRIPTION
gspl-setspdir tidies up the GNUspool spool directory, removing old
spool files, or alternatively re-queuing them with a given default form
type, and eliminating jobs where the spool file is missing.
Optionally, it may be used to split the main spool directory into a
series of subdirectories 000, 001 etc, reducing the size of the main
spool directory to manageable proportions and also speeding up file
searches. Alternatively, the subdirectories may be linked to different
file systems by the user.
For reasonably obvious reasons, gspl-setspdir should be run with the
spooler shut down.
OPTIONS
- -d Clear (delete) any orphaned job files found in the directory or
- directories.
- -f form
- Requeue any orphaned job files with the form type form rather than deleting them.
- -r Instead of moving jobs between subdirectories, renumber the jobs
- instead. This should only apply when there were existing
subdirectories, and the number is being increased. - -s n
- Split the spool directory into n subdirectories, or change the
number of subdirectories to n, where n may be 0 (to convert back to a single spool directory), or a number up to 999. - We recommend that n be a prime number, as this minimises the chance
of a cycle of operations which is a factor of the number of
subdirectories causing just a small number of subdirectories to be filled more or less exclusively. Confirmation will be requested if n is not prime. - The subdirectories are given the names 000 to 999, and each job
will be moved to a subdirectory given by the remainder when its job number (the number after the "SP") is divided by the number of
subdirectories. - -y Answer "yes" to any questions which gspl-setspdir asks.
ENVIRONMENT
gspl-setspdir creates or updates the environment variable "SPOOLSUBDS"
in gnuspool.conf.
- SPOOLDIR
- location of spool directory
- SPOOLSUBDS
- number of subdirectories
SEE ALSO
gspl-cjlist(8), gspl-cplist(8), gspl-spuconv(8), gnuspool.conf(5).
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.