spulist - list permissions for users

# NAME

spulist - list permissions for users

# SYNOPSIS

spulist [ -options ]

# DESCRIPTION

spulist lists the permissions of users known to the GNUspool print spooler system.

The invoking user must have edit admin file permission to use spulist.

# OPTIONS

The environment variable on which options are supplied is `SPULIST` and the environment variable to specify the help file is `SPRESTCONF`.

-? or +explain

  causes a summary of the other options to be displayed without taking further action.

-D or +default-format

  cancel the -F option and revert to the default format.

-d or +default-line

  display an initial line giving the default options (default).

-F or +format

  format the output according to the format string given.

-H or +header

  generate a header for each column of the output appropriate for the format.

-N or +no-header

  cancel the -H option.

-n or +numeric-sort

  sort the list of users by the numeric user id (default).

-S or +no-user-lines

  suppress the user lines. It is an error to invoke this and the -s option as well.

-s or +no-default-line

  suppress the initial line giving the default options.

-U or +user-lines

  display the user lines (default).

-u or +user-sort

  sort the list of users by the user name.

+freeze-current

  Save all the current options in a .gnuspool file in the current directory.

+freeze-home

  Save all the current options in a .gnuspool file in the user's home directory.

## Format argument.

The format string consists of a string containing the following character sequences, which are replaced by various user permission parameters. The string may contain various other printing characters or spaces as required.

Each column is padded on the right to the length of the longest entry.

If a header is requested, the appropriate abbreviation is obtained from the message file and inserted.

`%a`

  allowed form types

`%b`

  allowed printer types

`%c`

  allowed class code

`%d`

  default priority

`%f`

  default form type

`%l`

  minimum priority

`%m`

  maximum priority

`%n`

  maximum copies

`%o`

  default printer

`%p`

  privileges

`%u`

  user name.

`%v`

  `L` if the user is a valid user

The string `DEFAULT` replaces the user name in the default values line.

Note that the various strings are read from the message file, so it is possible to modify them as required by the user.

The default format is

            %u %d %l %m %n %c %p

## Privileges format

The following are output via the `%p` format. Note that the actual strings are read from the message file, and are the same ones as are used by spuchange(1). `ALL` is displayed if all privileges are set.

Adm

  edit admin file

Stp

  stop scheduler

Form

  select forms other than restriction pattern

Otherp

  select printers other than restriction pattern

Cpri

  change priority once queued

Otherj

  edit other users' jobs.

Prinq

  select printer list

Hgo

  stop and start printers

Anyp

  select any priority once queued

Cdef

  change own default priority within range

Addp

  add and delete printers

Cover

  override class

Unq

  unqueue jobs

Votj

  view (but not change) other users' jobs

Remj

  access remote jobs

Remp

  access remote printers

Accessj

  access non-displayed job attributes

Freeze

  freeze parameters from display

# FILES

~/.gnuspool configuration file (home directory)

.gnuspool configuration file (current directory)

rest.help message file

# ENVIRONMENT

SPULIST

  space-separated options to override defaults.

SPRESTCONF

  location of alternative help file.

# SEE ALSO

spuchange(1), spuser(1), spsyntax(5), gnuspool.conf(5), gnuspool.hosts(5).

# DIAGNOSTICS

Various diagnostics are read and printed as required from the message file, by default rest.help.

# AUTHOR

John M Collins, Xi Software Ltd.