psrinfo(1m) - osol9

1psrinfo(1M)             System Administration Commands             psrinfo(1M)
2
3
4

NAME

6       psrinfo - displays information about processors
7

SYNOPSIS

9       psrinfo [-p] [-v] [processor_id]...
10
11
12       psrinfo [-p] -s processor_id
13
14

DESCRIPTION

16       psrinfo  displays information about processors. Each physical processor
17       may support multiple virtual processors. Each virtual processor  is  an
18       entity  with  its  own  interrupt  ID, capable of executing independent
19       threads.
20
21
22       Without the processor_id operand, psrinfo displays one  line  for  each
23       configured  processor, displaying whether it is on-line, non-interrupt‐
24       ible (designated by no-intr), spare, off-line, faulted or powered  off,
25       and when that status last changed. Use the processor_id operand to dis‐
26       play information about a specific processor. See OPERANDS.
27

OPTIONS

29       The following options are supported:
30
31       -s processor_id    Silent mode. Displays 1 if the  specified  processor
32                          is  fully  on-line. Displays 0 if the specified pro‐
33                          cessor  is   non-interruptible,   spare,   off-line,
34                          faulted or powered off.
35
36                          Use silent mode when using psrinfo in shell scripts.
37
38
39       -p                 Display  the number of physical processors in a sys‐
40                          tem.
41
42                          When combined with the -v option, reports additional
43                          information about each physical processor.
44
45
46       -v                 Verbose  mode. Displays additional information about
47                          the specified processors, including: processor type,
48                          floating  point unit type and clock speed. If any of
49                          this information cannot be determined, psrinfo  dis‐
50                          plays unknown.
51
52                          When combined with the -p option, reports additional
53                          information about each physical processor.
54
55

OPERANDS

57       The following operands are supported:
58
59       processor_id    The processor ID of the processor about which  informa‐
60                       tion is to be displayed.
61
62                       Specify  processor_id as an individual processor number
63                       (for example, 3), multiple processor numbers  separated
64                       by spaces (for example, 1 2 3), or a range of processor
65                       numbers (for example, 1-4). It is also possible to com‐
66                       bine  ranges and (individual or multiple) processor_ids
67                       (for example, 1-3 5 7-8 9).
68
69

EXAMPLES

71       Example 1 Displaying Information About  All  Configured  Processors  in
72       Verbose Mode
73
74
75       The following example displays information about all configured proces‐
76       sors in verbose mode.
77
78
79         psrinfo -v
80
81
82
83       Example 2 Determining If a Processor is On-line
84
85
86       The following example uses psrinfo in a shell script to determine if  a
87       processor is on-line.
88
89
90         if [ "`psrinfo -s 3 2> /dev/null`" −eq 1 ]
91         then
92              echo "processor 3 is up"
93         fi
94
95
96
97       Example  3  Displaying Information About the Physical Processors in the
98       System
99
100
101       With no additional arguments, the -p option displays a single  integer:
102       the number of physical processors in the system:
103
104
105         > psrinfo -p
106                         8
107
108
109
110
111       psrinfo also accepts command line arguments (processor IDs):
112
113
114         > psrinfo -p 0 512   # IDs 0 and 512 exist on the
115         1                    # same physical processor
116
117         > psrinfo -p 0 1     # IDs 0 and 1 exist on different
118         2                    # physical processors
119
120
121
122
123       In  this example, virtual processors 0 and 512 exist on the same physi‐
124       cal processor. Virtual processors 0 and 1 do not. This is  specific  to
125       this example and is and not a general rule.
126
127

EXIT STATUS

129       The following exit values are returned:
130
131       0     Successful completion.
132
133
134       >0    An error occurred.
135
136

ATTRIBUTES

138       See attributes(5) for descriptions of the following attributes:
139
140
141
142
143       ┌─────────────────────────────┬─────────────────────────────┐
144       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
145       ├─────────────────────────────┼─────────────────────────────┤
146       │Availability                 │SUNWcsu                      │
147       └─────────────────────────────┴─────────────────────────────┘
148

DIAGNOSTICS

153       psrinfo: processor 9: Invalid argument
154
155           The specified processor does not exist.
156
157
158
159
160SunOS 5.11                        21 Feb 2004                      psrinfo(1M)