lshosts
Overview
lshosts displays static resource information for hosts in the cluster, including host names, architecture types, CPU information, and memory configuration.
Parameters
| Option | Description | Key Differences |
|---|---|---|
-w | Wide format (no field truncation) | No difference |
-l | Long format (multi-line output) with additional fields and topology info | See long format section |
-T | Show CPU topology information for hosts | NUMA hierarchy information is omitted |
-R | Show only hosts that satisfy a resource requirement expression | Supports select clauses (ncpus/mem/type, supports defined(), supports &&/` |
-s | Show static shared resource information | Always outputs "No shared resources" |
-a | Show all hosts | Default is already all hosts; this option is a no-op |
-cname | Include cluster name in output | Outputs "The -cname option is only supported on LSF/XL submission clusters" |
-V | Print version | No difference |
-h | Print command usage | Provides more detailed help information |
Default Output Fields
| Field | Description | Key Differences |
|---|---|---|
HOST_NAME | Host name | No difference |
type | Host type (architecture) | Architecture is converted to uppercase (for example X86_64) |
model | Host model (CPU model) | Hardcoded to "Intel" |
cpuf | Relative CPU performance factor | Hardcoded to "2.5" |
ncpus | Number of processors on the host | No difference |
maxmem | Maximum physical memory available to user processes (with unit, such as 15.6G) | No difference |
maxswp | Total swap space | Hardcoded to "-" (not configured) |
server | Whether the host is a server host (Yes/No) | Hardcoded to "Yes" |
RESOURCES | Boolean resources and external static resource values defined for the host | Hardcoded to "()" (no resources) |
Output Fields for -l
| Field | Description | Key Differences |
|---|---|---|
ndisks | Number of local disk drives directly attached to the host | Hardcoded to 1 |
maxtmp | Maximum configured /tmp space (MB) | No difference |
rexpri | Execution priority for remote jobs run by RES (-20 to 20) | Hardcoded to 0 |
nprocs | Number of physical processors (sockets) | No difference |
ncores | Cores per processor | No difference |
nthreads | Threads per core | No difference |
RUN_WINDOWS | Time window when LIM considers the host available for remote jobs | Hardcoded to "(always open)" |
LOAD_THRESHOLDS | Thresholds for scheduling interactive jobs | All fields hardcoded to "-" (not configured) |
RESOURCES | Host static resources (long format) | Shows "Not defined" |
Filters
| Filter | Description | Key Differences |
|---|---|---|
| None (default) | Show all host information | No difference |
| host_name... | Show information for specified hosts; multiple host names are space-separated | No difference |
| cluster_name | Show hosts for the specified cluster | Multi-cluster is not supported; only the current cluster is shown |
Examples
-
Show basic information for all hosts (default format)
lshosts -
Show all hosts in wide format
lshosts -w -
Show detailed information for all hosts in long format
lshosts -l -
Show CPU topology information for hosts
lshosts -T -
Show information for specific hosts
lshosts compute1
lshosts compute1 compute2 compute3 -
Filter hosts with CPU count >= 16
lshosts -R 'select[ncpus>=16]' -
Filter hosts with memory > 64GB (unit is MB)
lshosts -R 'select[mem>65536]' -
Filter hosts by architecture
lshosts -R 'select[type==X86_64]' -
Filter with combined conditions
lshosts -R 'select[ncpus>=16 && mem>32768]'