busers

Displays information about users and user groups.

Synopsis

busers [-w] [-alloc] [ -o "[field_name | all][:[-][output_width]] ... [delimiter='character']" [-json]] [user_name ... | user_group ... | all]
busers [-h | -V]

Description

By default, displays information about the user who runs the command.

When a resizable job has a resize allocation request, the busers command displays pending requests. When LSF adds more resources to a running resizable job, the busers command decreases pending job counts and displays the added resources. When LSF removes resources from a running resizable job, the busers command displays the updated resources.

Options

-w
Prints pending job thresholds for users and user groups and exits. Output shows PEND, MPEND, PJOBS, and MPJOBS fields.
-alloc
Shows counters for slots in RUN, SSUSP, USUSP, and RSV state. The slot allocation is different depending on whether the job is an exclusive job or not.
user_name ... | user_group ... | all
Displays information about the specified users or user groups, or about all users if you specify the all option. To specify a Windows user account, include the domain name in uppercase letters and use a single backslash (DOMAIN_NAME∖user_name) on a Windows command prompt or a double backslash (DOMAIN_NAME∖∖user_name) on a UNIX ore Linux command line.
-o
Sets the customized output format. Specify which busers fields to display, and in which order.

The busers -o option overrides the LSB_BUSERS_FORMAT environment variable, which overrides the LSB_BUSERS_FORMAT setting in lsf.conf.

The following are the field names used to specify the busers fields to display:

  • user (Name of the user or user group)
  • jl/p
  • max
  • nstart (Current number of starting tasks for all of a users' jobs)
  • pend
  • run
  • ssusp
  • ususp
  • rsv
  • njobs
  • pjobs
  • mpend
  • mpjobs
  • priority
  • ngpus (Number of physical GPUs that the users or user groups are using)
  • ngpus_shared (Number of physical GPUs that the users or user groups are using in shared mode)
  • ngpus_excl (Number of physical GPUs that the users or user groups are using in exclusive mode)
  • ngpus_shared_jexcl (Number of physical GPUs that the users or user groups are using in shared mode, but the jobs of the user is exclusive)
  • all (Displays all fields. Specify the colon (:) with an output width that applies to all fields. Available starting in Fix Pack 14.)

Field names are case-sensitive.

For example,

busers -o "user ngpus_alloc ngpus_excl_alloc ngpus_shared_alloc ngpus_shared_jexcl_alloc"

-h

Prints command usage to stderr and exits.

-V
Prints LSF release version to stderr and exits.

Output

A listing of the users and user groups is displayed with the following fields:
USER/GROUP
The name of the user or user group.
JL/P
The maximum number of job slots that can be processed simultaneously for the specified users on each processor. For non-preemptive scheduling, these job slots are used by running and suspended jobs or by pending jobs that with job slots that are reserved for them. For preemptive scheduling, these job slots are used by running jobs or by pending jobs with slots that are reserved for them. This job limit is configured per processor so that multiprocessor hosts have more job slots. The dash character (-) indicates no limit. JL/P is defined in the LSF configuration file lsb.users.
MAX
The maximum number of job slots that can be processed concurrently for the specified users' jobs. For non-preemptive scheduling, these job slots are used by running and suspended jobs or by pending jobs with job slots that are reserved for them. For preemptive scheduling, these job slots are used by running jobs or by pending jobs with job slots that are reserved for them. The dash character (-) indicates no limit. MAX is defined by the MAX_JOBS parameter in the lsb.users file.
NJOBS
The current number of tasks for all of a users' jobs. A parallel job that is pending is counted as n tasks for it uses n job slots in the queue when it is dispatched.

If the -alloc option is used, total is the sum of the RUN, SSUSP, USUSP, and RSV counters.

PEND
The number of tasks in all of the specified users' pending jobs. If used with the -alloc option, the total is 0.
RUN
The number of tasks in all of the specified users' running jobs. If the -alloc option is used, the total is the allocated slots for the users' jobs.
SSUSP
The number of tasks in all of the specified users' system-suspended jobs. If the -alloc option is used, total is the allocated slots for the users' jobs.
USUSP
The number of tasks in all of the specified users' user-suspended jobs. If the -alloc option is used, total is the allocated slots for the users' jobs.
RSV
The number of tasks that reserve slots for all of the specified users' pending jobs. If the -alloc option is used, total is the allocated slots for the users' jobs.
MPEND
The pending job slot threshold for the specified users or user groups. MPEND is defined by the MAX_PEND_SLOTS parameter in the lsb.users configuration file.
PRIORITY
The APS user (USER) factors for the specified users or user groups. PRIORITY is defined by the PRIORITY parameter in the lsb.users file. User priority is displayed only with the busers -w option.
PJOBS
The number of users' pending jobs.
MPJOBS
The pending job threshold for the specified users. MPJOBS is defined by the MAX_PEND_JOBS parameter in the configuration file lsb.users.

See also

bugroup, lsb.users, lsb.queues