Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
sprio(1)			Slurm Commands			      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	 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. Since  this	option's  argument  is	optional,  for
	      proper parsing the single	letter option must be followed immedi-
	      ately with the value and not include a space between  them.  For
	      example "-j1008,1009" and	not "-j	1008,1009".

       -l, --long
	      Report more of the available information for the selected	jobs.

       -M, --clusters=<string>
	      The  cluster  to issue commands to. Only one cluster name	may be
	      specified.

       -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 when all factors
	      have been	assigned non-zero weights are

	      default	     "%.15i %.10Y %.10A	%.10F %.10J %.10P %.10Q	%20T"

	      -l, --long     "%.15i %.8u %.10Y %.10A %.10F %.10J  %.10P	 %.10Q
			     %.6N %20T"

	      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 de-
		      fault, 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

	      %t  Normalized TRES priorities

	      %T  Weighted TRES	priorities

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

ENVIRONMENT VARIABLES
       If no corresponding commandline option is specified, sprio will use the
       value of	the following environment variables.

       SLURM_CLUSTERS	   Same	as --clusters

       SLURM_CONF	   The location	of the Slurm configuration file.

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).
       Copyright (C) 2010-2013 SchedMD LLC.

       This  file  is  part  of	Slurm, a resource management program.  For de-
       tails, see <https://slurm.schedmd.com/>.

       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  op-
       tion) 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)

April 2015			Slurm Commands			      sprio(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | EXAMPLES | COPYING | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sprio&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help