gspl-stop - cancel spooler

# NAME

gspl-stop - cancel spooler

gspl-suspend - suspend assignment of printers

gspl-release - release assignment of printers

# SYNOPSIS

gspl-stop [ -y ]

gspl-suspend [ -y ] [ n ]

# DESCRIPTION

gspl-stop is a program which should be invoked to bring the GNUspool spooler system to an orderly halt prior to system shutdown. Any jobs in progress will be saved, and the current page noted for resumption when the spooler is restarted. Confirmation is requested (reply `y` or `n`) unless the `-y` option is specified.

gspl-suspend halts the assignment of jobs to printers for a short time, which defaults to 5 minutes or as given as a time in seconds last argument to the command, or until released by gspl-release. Again confirmation is requested unless the `-y` option is given.

Only a user with the Stop spooler privilege may successfully invoke any of these commands.

The reason why gspl-suspend this may be useful is that in a network scenario, where a new host is brought on line, a considerable amount of network traffic is created, and the assignment of printers to jobs and the broadcasting of information between hosts can flood the network to an unacceptable degree.

# OPTIONS

Note that there is no means of saving the `-y` option in a .gnuspool file as this is not considered to be sensible. If you have to do this, put the command in a shell ``wrapper''.

-y

  Do not ask for confirmation.

# ENVIRONMENT

SPRESTCONF

  path name of alternative message file.

# SEE ALSO

gspl-start(1), gnuspool.conf(5), gnuspool.hosts(5), spd(8), spdinit(8), spshed(8).

# DIAGNOSTICS

Various diagnostics may be issued, read as required from the message file rest.help.

The most important ones are that it is not running and that the user is not permitted to invoke the command.

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