System Administration Commands psrinfo(1M)
NAME
psrinfo - displays information about processors
SYNOPSIS
psrinfo [-p] [-v] [processorid]...
psrinfo [-p] -s processorid
DESCRIPTION
psrinfo displays information about processors. Each physical
processor may support multiple virtual processors. Each vir-
tual processor is an entity with its own interrupt ID, capa-
ble of executing independent threads.
Without the processorid operand, psrinfo displays one line
for each configured processor, displaying whether it is on-
line, non-interruptible (designated by no-intr), spare,
off-line, faulted or powered off, and when that status last
changed. Use the processorid operand to display information
about a specific processor. See OPERANDS.
OPTIONS
The following options are supported:
-s processorid Silent mode. Displays 1 if the specified
processor is fully on-line. Displays 0 if
the specified processor is non-
interruptible, spare, off-line, faulted
or powered off.
Use silent mode when using psrinfo in
shell scripts.
-p Display the number of physical processors
in a system.
When combined with the -v option, reports
additional information about each physi-
cal processor.
-v Verbose mode. Displays additional infor-
mation about the specified processors,
including: processor type, floating point
unit type and clock speed. If any of this
information cannot be determined, psrinfo
displays unknown.
SunOS 5.11 Last change: 21 Feb 2004 1
System Administration Commands psrinfo(1M)
When combined with the -p option, reports
additional information about each physi-
cal processor.
OPERANDS
The following operands are supported:
processorid The processor ID of the processor about
which information is to be displayed.
Specify processorid as an individual pro-
cessor number (for example, 3), multiple
processor numbers separated by spaces (for
example, 1 2 3), or a range of processor
numbers (for example, 1-4). It is also pos-
sible to combine ranges and (individual or
multiple) processorids (for example, 1-3 5
7-8 9).
EXAMPLES
Example 1 Displaying Information About All Configured Pro-
cessors in Verbose Mode
The following example displays information about all config-
ured processors in verbose mode.
psrinfo -v
Example 2 Determining If a Processor is On-line
The following example uses psrinfo in a shell script to
determine if a processor is on-line.
if [ "`psrinfo -s 3 2> /dev/null`" -eq 1 ]
then
echo "processor 3 is up"
fi
Example 3 Displaying Information About the Physical Proces-
sors in the System
SunOS 5.11 Last change: 21 Feb 2004 2
System Administration Commands psrinfo(1M)
With no additional arguments, the -p option displays a sin-
gle integer: the number of physical processors in the sys-
tem:
> psrinfo -p
8
psrinfo also accepts command line arguments (processor IDs):
> psrinfo -p 0 512 # IDs 0 and 512 exist on the
1 # same physical processor
> psrinfo -p 0 1 # IDs 0 and 1 exist on different
2 # physical processors
In this example, virtual processors 0 and 512 exist on the
same physical processor. Virtual processors 0 and 1 do not.
This is specific to this example and is and not a general
rule.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SunOS 5.11 Last change: 21 Feb 2004 3
System Administration Commands psrinfo(1M)
SEE ALSO
psradm(1M), ponline(2), processorinfo(2), attributes(5)
DIAGNOSTICS
psrinfo: processor 9: Invalid argument
The specified processor does not exist.
SunOS 5.11 Last change: 21 Feb 2004 4
|
