Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sshare(1) [debian man page]

SSHARE(1)							  SLURM Commands							 SSHARE(1)

NAME
sshare - Tool for listing the shares of associations to a cluster. SYNOPSIS
sshare [OPTIONS...] DESCRIPTION
sshare is used to view SLURM share information. This command is only viable when running with the priority/multifactor plugin. The sshare information is derived from a database with the interface being provided by slurmdbd (SLURM Database daemon) which is read in from the slurmctld and used to process the shares available to a given association. sshare provides SLURM share information of Account, User, Raw Shares, Normalized Shares, Raw Usage, Normalized Usage, Effective Usage, and the Fair-share factor for each association. OPTIONS
-A, --accounts= Display information for specific accounts (comma separated list). -a, --all Display information for all users. -h, --noheader No header will be added to the beginning of the output. -l, --long Long listing - includes the normalized usage information. -M, --clusters=<string> Clusters to issue commands to. -p, --parsable Output will be '|' delimited with a '|' at the end. -P, --parsable2 Output will be '|' delimited without a '|' at the end. -u, --users= Display information for specific users (comma separated list). -v, --verbose Display more information about the specified options. -V, --version Display the version number of sshare. --help --usage Display a description of sshare options and commands. SSHARE OUTPUT FIELDS
Account The Account. User The User. Raw Shares The raw shares assigned to the user or account. Norm Shares The shares assigned to the user or account normalized to the total number of assigned shares. Raw Usage The number of cpu-seconds of all the jobs that charged the account by the user. This number will decay over time when PriorityDe- cayHalfLife is defined. Norm Usage (only appears with sshare -l option) The Raw Usage normalized to the total number of cpu-seconds of all jobs run on the cluster, subject to the PriorityDecayHalfLife decay when defined. Effectv Usage The Effective Usage augments the normalized usage to account for usage from sibling accounts. FairShare The Fair-Share factor, based on a user or account's assigned shares and the effective usage charged to them or their accounts. EXAMPLES
> sshare -A <Account> > sshare --parsable --users=<User> COPYING
Copyright (C) 2008 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 <http://www.schedmd.com/slurmdocs/>. 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
slurm.conf(5), slurmdbd(8) sshare 2.0 November 2008 SSHARE(1)

Check Out this Related Man Page

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. -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 "%.7i %.10Y %.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. ENVIRONMENT VARIABLES
If no corresponding commandline option is specified, sprio will use the value of the following environment variables. SLURM_CLUSTERS Same as --clusters 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 <http://www.schedmd.com/slurmdocs/>. 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) sprio 2.3 May 2011 SPRIO(1)

Featured Tech Videos