Login or Register to Ask a Question and Join Our Community

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

sview(1)							  SLURM Commands							  sview(1)

NAME

       sview - graphical user interface to view and modify SLURM state.

SYNOPSIS

       sview

DESCRIPTION

       sview  can  be used to view SLURM configuration, job, step, node and partitions state information.  Authorized users can also modify select
       information.

       The primary display modes are Jobs and Partitions, each with a selection tab.  There is also an optional map of the nodes on the left  side
       of the window which will show the nodes associated with each job or partition.  Left-click on the tab of the display you would like to see.
       Right-click on the tab in order to control which fields will be displayed.

       Within the display window, left-click on the header to control the sort order of entries (e.g. increasing or decreasing)  in  the  display.
       You  can also left-click and drag the headers to move them right or left in the display.  If a JobID has an arrow next to it, click on that
       arrow to display or hide information about that job's steps.  Right-click on a line of the  display  to	get  more  information	about  the
       record.

       There is an Admin Mode option which permits the user root to modify many of the fields displayed, such as node state or job time limit.	In
       the mode, a SLURM Reconfigure Action is also available.	It is recommended that Admin Mode be used only while  modifications  are  actively
       being made.  Disable Admin Mode immediately after the changes to avoid possibly making unintended changes.

NOTES

       The  sview command can only be build if gtk+-2.0 is installed.  Systems lacking these libraries will have SLURM installed without the sview
       command.

       At least some gtk themes are unable to display large numbers of lines (jobs, nodes, etc). The information is still in gtk's  internal  data
       structures, but not visible by scrolling down the window.

COPYING

       Copyright  (C)  2006-2007 The Regents of the University of California.  Copyright (C) 2008-2011 Lawrence Livermore National Security.  Pro-
       duced 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

       sinfo(1), squeue(1), scontrol(1), slurm.conf(5), sched_setaffinity (2), numa (3)

February 2011							     SLURM 2.3								  sview(1)
Man Page