qhost
View host status, resources, and load information in the cluster.
Options
Supported Options
| Option | Requires Value | Range/Value | Purpose | Main Differences |
|---|---|---|---|---|
| (default) | No | None | Show basic status and resource info for all hosts. | No difference |
-F | Optional | Resource list (comma-separated) | Show all or selected resource attributes (25 total). | m_topology and m_topology_inuse are dummy "NONE". |
-h | Yes | Host list (comma-separated) | Show only specified hosts; supports * wildcard. | No difference |
-j | No | None | Show job info running on hosts. | Only running jobs; master column is dummy "MASTER". |
-l | Yes | Resource expression | Show hosts that satisfy resource requirements. | Supports arch=, num_proc=, mem_total=, mem_free=. |
-cb | No | None | Show core binding columns (default behavior). | NSOC/NCOR/NTHR columns shown by default. |
-ncb | No | None | Suppress core binding columns (NSOC, NCOR, NTHR). | No difference |
-q | No | None | Show queue instances on hosts. | Queue type is dummy "BIP"; reserved slots are dummy 0. |
-u | Yes | User name | Show only hosts running jobs for the user. | No difference |
-xml | No | None | Output in XML. | XML schema differs slightly from native SGE. |
-help | No | None | Show help. | Detailed help implemented. |
Default Output Fields
| Field | Description | Main Differences |
|---|---|---|
HOSTNAME | Host name | First line is global and all fields are -. |
ARCH | Host architecture (e.g. lx-amd64) | Offline nodes show -. |
NCPU | CPU count | Offline nodes show -. |
NSOC | Socket count | Offline nodes show - (hidden with -ncb). |
NCOR | Cores per socket | Offline nodes show - (hidden with -ncb). |
NTHR | Threads per core | Offline nodes show - (hidden with -ncb). |
LOAD | Average load | Two decimals; offline nodes show -. |
MEMTOT | Total memory | With unit (G/M); offline nodes show -. |
MEMUSE | Used memory | With unit (G/M); offline nodes show -. |
SWAPTO | Total swap | No unit; offline nodes show -. |
SWAPUS | Used swap | No unit; offline nodes show -. |
Resource Attributes for -F
Supports 25 resource attributes with hl: (host level) prefix:
| Resource | Description | Format | Main Differences |
|---|---|---|---|
arch | Host architecture | String | None |
num_proc | CPU count | Float (6 decimals) | None |
mem_total | Total memory | With unit G | None |
swap_total | Total swap | No unit | None |
virtual_total | Total virtual memory (mem + swap) | With unit G | None |
m_topology | CPU topology string | String | Dummy "NONE" |
m_socket | Socket count | Float (6 decimals) | None |
m_core | Core count | Float (6 decimals) | None |
m_thread | Thread count | Float (6 decimals) | None |
load_avg | Average load | Float (6 decimals) | None |
load_short | Short load (15s) | Float (6 decimals) | From fsched r15s |
load_medium | Medium load (1m) | Float (6 decimals) | From fsched r1m |
load_long | Long load (15m) | Float (6 decimals) | From fsched r15m |
mem_free | Free memory | With unit G | None |
swap_free | Free swap | No unit | None |
virtual_free | Free virtual memory | With unit G | None |
mem_used | Used memory | With unit G | None |
swap_used | Used swap | No unit | None |
virtual_used | Used virtual memory | With unit G | None |
cpu | CPU utilization (%) | Float (6 decimals) | Calculated from load/ncpu |
m_topology_inuse | CPU topology in use | String | Dummy "NONE" |
np_load_avg | Normalized average load | Float (6 decimals) | load/ncpu |
np_load_short | Normalized short load | Float (6 decimals) | r15s/ncpu |
np_load_medium | Normalized medium load | Float (6 decimals) | r1m/ncpu |
np_load_long | Normalized long load | Float (6 decimals) | r15m/ncpu |
Output for -j
Shows jobs running on each host under the host line:
| Field | Description | Main Differences |
|---|---|---|
job-ID | Job ID | None |
prior | Job priority (0–1) | None |
name | Job name | None |
user | Job owner | None |
state | Job state | Only running jobs (r) |
submit/start at | Submit/Start time | Formatted output |
queue | Queue@host | Format: queue@host |
master | Master/Slave indicator | Dummy "MASTER" |
ja-task-ID | Array task ID | Empty for non-array jobs |
Output for -q
Shows queue instances under each host line:
| Field | Description | Main Differences |
|---|---|---|
queuename | Queue name | None |
qtype | Queue type | Dummy "BIP" |
used/reserved/total | Used/Reserved/Total slots | reserved is dummy 0 |
states | Queue state code | Mapped from node states |
Queue state codes:
- (empty) - normal
a- alarm (node DOWN/DRAIN/FAIL)u- unavailable (node unavailable)d- disabled (node DRAIN)E- error (node error state)
Examples
Example 1: Show basic info for all hosts
qhost
Sample output:
HOSTNAME ARCH NCPU NSOC NCOR NTHR LOAD MEMTOT MEMUSE SWAPTO SWAPUS
----------------------------------------------------------------------------------------------
global - - - - - - - - - -
node01 lx-amd64 16 2 8 1 2.35 31.3G 12.5G 8192 1024
node02 lx-amd64 32 2 16 1 4.20 62.5G 28.3G 16384 2048
Example 2: Show resource attributes for a host
qhost -h node01 -F mem_total,num_proc,load_avg
Sample output:
HOSTNAME ARCH NCPU NSOC NCOR NTHR LOAD MEMTOT MEMUSE SWAPTO SWAPUS
----------------------------------------------------------------------------------------------
global - - - - - - - - - -
node01 lx-amd64 16 2 8 1 2.35 31.3G 12.5G 8192 1024
hl:mem_total=31.300000G
hl:num_proc=16.000000
hl:load_avg=2.350000
Example 3: Show jobs running on hosts
qhost -j
Sample output:
HOSTNAME ARCH NCPU NSOC NCOR NTHR LOAD MEMTOT MEMUSE SWAPTO SWAPUS
----------------------------------------------------------------------------------------------
global - - - - - - - - - -
node01 lx-amd64 16 2 8 1 2.35 31.3G 12.5G 8192 1024
12345 0.50 test_job alice r 01/15/2024 10:30:00 compute@node01 MASTER
12346 0.45 analysis bob r 01/15/2024 11:00:00 compute@node01 MASTER
Example 4: Filter hosts by resources
qhost -l arch=lx-amd64,num_proc=16
Effect: Show hosts with architecture lx-amd64 and 16 CPUs.
Example 5: Show queue instances
qhost -q
Sample output:
HOSTNAME ARCH NCPU NSOC NCOR NTHR LOAD MEMTOT MEMUSE SWAPTO SWAPUS
----------------------------------------------------------------------------------------------
global - - - - - - - - - -
node01 lx-amd64 16 2 8 1 2.35 31.3G 12.5G 8192 1024
compute BIP 4/0/16
Example 6: Suppress core binding columns
qhost -ncb
Sample output:
HOSTNAME ARCH NCPU LOAD MEMTOT MEMUSE SWAPTO SWAPUS
----------------------------------------------------------------------------------
global - - - - - - -
node01 lx-amd64 16 2.35 31.3G 12.5G 8192 1024
Example 7: Filter hosts by user jobs
qhost -u alice -j
Effect: Show only hosts running jobs for user alice, with job details.
Example 8: Filter hosts by wildcard
qhost -h "node*"
Effect: Show all hosts that start with node.
Example 9: XML output
qhost -xml
Effect: Output host info in XML for programmatic parsing.