sshare
TLDR
SYNOPSIS
sshare [OPTIONS...]
DESCRIPTION
sshare displays fair-share information for Slurm's priority/multifactor plugin. It shows how accounts and users are allocated shares, their actual usage, and resulting fair-share factors that influence job scheduling priority.The data requires slurmdbd to be configured and operational. Fair-share scheduling ensures equitable resource distribution among users and projects based on their allocated shares and historical usage.
PARAMETERS
-A, --accounts accounts
Show data for specified accounts (comma-separated)-a, --all
Display information for all users-u, --users users
Show data for specified users (comma-separated)-U, --Users
Print only user information (exclude ancestors)-M, --clusters names
Target specific clusters-o, --format format
Custom field selection-l, --long
Extended output with normalized data-n, --noheader
Omit header row-p, --parsable
Pipe-delimited with trailing delimiter-P, --parsable2
Pipe-delimited without trailing delimiter--json
Output as JSON--yaml
Output as YAML-m, --partition
Show partition names-v, --verbose
Verbose output-V, --version
Print version
OUTPUT FIELDS
Account: Association accountUser: User nameRaw Shares: Assigned share countNorm Shares: Normalized shares (0.0-1.0)Raw Usage: Raw usage valueNorm Usage: Normalized usageEffectv Usage: Effective usage considering hierarchyFairShare: Fair-share factor for scheduling
CAVEATS
Requires slurmdbd and the multifactor priority plugin. Share values are relative within the hierarchy. Usage data updates with accounting polling intervals. Historical usage decay depends on PriorityDecayHalfLife configuration.
HISTORY
sshare is part of Slurm, developed at Lawrence Livermore National Laboratory starting in 2002. Fair-share scheduling was added to support equitable resource allocation in multi-user HPC environments. Slurm is now maintained by SchedMD.
