SPRIO(1)
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 readonly 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
- 65540 62663 0 51663 1000 10000
- 65541 62662 0 51662 1000 10000
- 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
- 65548 62077 0 51077 1000 10000
- 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
- 65549 sally 62080 1 51078 1000 10000
- 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.