NAME
sprio - view the factors that comprise a job’s scheduling priority
SYNOPSIS
sprio [OPTIONS...]
DESCRIPTION
sprio is used to view the components of a job’s scheduling priority
when the multi-factor priority plugin is installed. sprio is a read-
only utility that extracts information from the multi-factor priority
plugin. By default, sprio returns information for all pending jobs.
Options exist to display specific jobs by job ID and user name.
OPTIONS
-h, --noheader
Do not print a header on the output.
--help Print a help message describing all options sprio.
-j <job_id_list>, --jobs=<job_id_list>
Requests a comma separated list of job ids to display. Defaults
to all jobs.
-l, --long
Report more of the available information for the selected jobs.
-n, --norm
Display the normalized priority factors for the selected jobs.
-o <output_format>, --format=<output_format>
Specify the information to be displayed, its size and position
(right or left justified). The default formats with various
options are
default "%.7i %.8u %.10A %.10F %.10J %.10P %.10Q"
-l, --long "%.7i %.8u %.10Y %.10A %.10F %.10J %.10P %.10Q
%.6N"
The format of each field is "%[.][size]type".
size is the minimum field size. If no size is specified,
whatever is needed to print the information will be
used.
. indicates the output should be left justified. By
default, output is right justified.
Valid type specifications include:
%a Normalized age priority
%A Weighted age priority
%f Normalized fair-share priority
%F Weighted fair-share priority
%i Job ID
%j Normalized job size priority
%J Weighted job size priority
%N Nice adjustment
%p Normalized partition priority
%P Weighted partition priority
%q Normalized quality of service priority
%Q Weighted quality of service priority
%u User name for a job
%Y Job priority
%y Normalized job priority
-u <user_list>, --user=<user_list>
Request jobs from a comma separated list of users. The list can
consist of user names or user id numbers.
--usage
Print a brief help message listing the sprio options.
-v, --verbose
Report details of sprios actions.
-V , --version
Print version information and exit.
-w , --weights Display the configured weights for each
factor. This is for information purposes only. Actual job data
is suppressed.
EXAMPLES
Print the list of all pending jobs with their weighted priorities
> sprio
JOBID PRIORITY AGE FAIRSHARE JOBSIZE PARTITION
QOS
65539 62664 0 51664 1000 10000
0
65540 62663 0 51663 1000 10000
0
65541 62662 0 51662 1000 10000
0
Print the list of all pending jobs with their normalized priorities
> sprio -n
JOBID PRIORITY AGE FAIRSHARE JOBSIZE PARTITION QOS
65539 0.00001459 0.0007180 0.5166470 1.0000000 1.0000000
0.0000000
65540 0.00001459 0.0007180 0.5166370 1.0000000 1.0000000
0.0000000
65541 0.00001458 0.0007180 0.5166270 1.0000000 1.0000000
0.0000000
Print the job priorities for specific jobs
> sprio --jobs=65548,65547
JOBID PRIORITY AGE FAIRSHARE JOBSIZE PARTITION
QOS
65547 62078 0 51078 1000 10000
0
65548 62077 0 51077 1000 10000
0
Print the job priorities for jobs of specific users
> sprio --users=fred,sally
JOBID USER PRIORITY AGE FAIRSHARE JOBSIZE PARTITION
QOS
65548 fred 62079 1 51077 1000 10000
0
65549 sally 62080 1 51078 1000 10000
0
Print the configured weights for each priority component
> sprio -w
JOBID PRIORITY AGE FAIRSHARE JOBSIZE PARTITION
QOS
Weights 1000 100000 1000 10000
1
COPYING
Copyright (C) 2009 Lawrence Livermore National Security. Produced at
Lawrence Livermore National Laboratory (cf, DISCLAIMER).
CODE-OCEC-09-009. All rights reserved.
This file is part of SLURM, a resource management program. For
details, see <https://computing.llnl.gov/linux/slurm/>.
SLURM is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.
SLURM is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
SEE ALSO
squeue(1), sshare(1)