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

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