gbch-ulist - list permissions for users
gbch-ulist [ -options ] [ user ... ]
gbch-ulist lists the permissions of users known to the GNUbatch batch scheduler system. All users are listed if no users are specified, otherwise the named users are listed. The report is similar to the main display of gbch-user(1).
The invoking user must have read admin file permission to use gbch-ulist.
Note that the order of treatment, letters and keywords described below may be modified by editing the file btrest.help - see btsyntax(5).
The environment variable on which options are supplied is GBCH_ULIST
and the
environment variable to specify the help file is BTRESTCONF
.
Causes a summary of the other options to be displayed without taking further action.
Cancel the -F option and revert to the default format.
Display an initial line giving the default options (included by default).
Format the output according to the format string given.
Sort the list of users by the group name in ascending order, then by users within that group as primary group.
Generate a header for each column of the output.
Cancel the -H option.
Sort the list of users by the numeric user id (default).
Suppress the user lines. It is an error to invoke this and the -s option as well.
Suppress the initial line giving the default options.
Display the user lines (default).
Sort the list of users by the user name.
Save all the current options in a .gnubatch file in the current directory.
Save all the current options in a .gnubatch file in the user's home directory.
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.
Insert a single %
character.
Default priority
Group name
Job mode
Minimum priority
Maximum priority
Privileges
Special create load level
Total load level
User name.
Variable mode
Maximum load level
The string DEFAULT
replaces the user name in the default values
line, or the group name if the user name is not printed. If the group
name is not printed as well, then this will be omitted and will be
indistinguishable from the rest of the output.
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 %g %d %l %m %x %t %s %p
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 gbch-uchange(1).
read admin file
write admin file
create
special create
stop scheduler
change default
or user and group modes
or user and other modes
or group and other modes.
ALL
is printed if all privileges are set.
Modes printed by the %j
and %v
options are as follows:
read permission
write permission
reveal permission
read mode
set mode
give away owner
assume owner
give away group
assume group
delete
kill (only valid for jobs)
Each section of the mode (job, group, others) is represented by the
prefixes U:
, G:
and O:
and separated by commas.
For example:
U:RWSMPDK,G:RWSDK,O:RS
This is exactly the same format as is expected by gbch-uchange(1) etc.
~/.gnubatch configuration file (home directory)
.gnubatch configuration file (current directory)
btrest.help message file
btufile user control file
space-separated options to override defaults.
location of alternative help file.
gbch-uchange(1), gbch-user(1), btsyntax(5), gnubatch.conf(5), gnubatch.hosts(5).
Various diagnostics are read and printed as required from the message file btrest.help.
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.
John M Collins, Xi Software Ltd.