 |
» |
|
|
 |
This section describes the EFI/POSSE commands developed for
the server.  |  |  |  |  | NOTE: EFI and Pre-OS System Environment (POSSE) are similar.
EFI is an Intel specification, whereas POSSE is the HP implementation
that aids HP support. |  |  |  |  |
help |  |
Provides information on the EFI shell commands. It also has
an additional feature to aid those familiar with the BCH menus to
adjust to their equivalent functions in EFI. help [-b] bch <bchmenu> <bchcmd> |
category Category of commands to view help on commands |
cmd Shell command name on which to provide verbose information |
bch Display the list of BCH commands and their corresponding EFI |
bchmenu BCH menu name taken from the top level of the BCH menu |
bchcmd BCH command on which to display information |
If help is invoked with no parameters, it displays a list
of shell command categories. To list all of the commands within
a category, the user should type “help <category>” (see
examples). If invoked with the -b switch, any output longer than
one page pauses after each page is displayed. If a shell command
name is used as a parameter, verbose help is displayed for that
command. If help is invoked with the bch option, it displays a list
of BCH commands and their corresponding EFI/POSSE commands. It instructs
the user to repeat the command line followed by a menu name for
more information on that menu. If help is invoked followed by bch
and a menu name, it displays a list of commands that appear under
that BCH menu. The user may then invoke help followed by bch, the
menu name, and a BCH command name to display information on that
command. This would point the user to the command that has taken
the place of that BCH functionality, or will inform the user that
the functionality no longer exists. As a shortcut, the user may
enter help followed by BCH and a BCH command name to go straight
to that command. Example 4-1 help Command List of classes of commands: |
boot -- Booting options and disk-related commands |
configuration -- Changing and retrieving system information |
devices -- Getting device, driver and handle information |
memory -- Memory related commands |
shell -- Basic shell navigation and customization |
scripts -- EFI shell-script commands |
Type "help" followed by a class name for a list of commands in that class |
Type "help" followed by command name for full documentation |
Example 4-2 help configuration Command Shell> help configuration |
cpuconfig -- Deconfigure or reconfigure cpus |
date -- Display or set date |
err -- Display or set error level |
esiproc -- Make an ESI call |
errdump -- View/Clear logs |
info -- Display hardware information |
monarch -- View or set the monarch processor |
palproc -- Make a PAL call |
salproc -- Make a SAL call |
time -- Display or set time |
ver -- Displays version info |
Type "help" followed by command name for full documentationon that command. |
Type "help -a" to display a list of all commands. |
Example 4-3 help cpuconfig Command cpu Specifies which cpu to configure |
on|off Specifies to configure or deconfigure a cpu |
1. Cpu status will not change until next boot. |
CPU will be deconfigured on the next boot. |
* To display configuration status of cpus |
<CPU configuration data displayed> |
Example 4-4 help
bch Command COnfiguration help bch co |
For more help on one of the commands above, at the prompt type: |
baud |  |
Sets the baud rate and communication settings for a UART. <index> 0 through the total number of UARTS minus one |
This command is used to change the speed for a UART in the
system. This command works for all UARTs visible to EFI/POSSE. If
the UART is part of PDH space and is initialized by the core firmware,
this command communicates the settings to core firmware so the UART
can be initialized with the new settings on the next boot. System
default is 9600 baud. Other Communication parameters are listed in Table 4-2 “Communications Parameters”. Table 4-2 Communications Parameters | Parameter | Value |
|---|
| RECEIVE_FIFO_DEPTH | 1 | | TIMEOUT | 1000000 | | PARITY | No parity | | DATA_BITS | 8 | | STOP_BITS | 1 | | CONTROL_MASK | 0 |
boottest |  |
Interacts with the speedy boot variable allowing it to be
set appropriately. boottest Displays status of all speedy boot bits |
boottest on Run all tests (for a normal boot time) |
boottest off Skip all tests (for a faster boot time) |
boottest [test] Displays status of specific Speedy Boot bit |
boottest [test] [on|off] Sets or clears a specific Speedy Boot bit |
[test] Each test can be set or cleared: |
booting_valid Enable/disable system firmware response to BOOTING |
bit. If OS Speedy Boot aware set to on. |
early_cpu Enable/disable early CPU selftests. |
late_cpu Enable/disable late CPU selftests. |
platform Enable/disable system board hardware tests. |
chipset Enable/disable CEC tests. |
io_hw Enable/disable EFI driver Core I/O tests. |
mem_init Enable/disable memory initialization. |
mem_test Enable/disable full destructive memory tests. |
Example 4-5 boottest Command BOOTTEST Settings Default Variable |
------------- ------------------------- |
booting_valid On (OS speedy boot aware) |
Example 4-6 boottest early_cpu off Command Shell> boottest early_cpu off |
BOOTTEST Settings Default Variable |
------------- ------------------------- |
booting_valid On (OS speedy boot aware) |
cpuconfig |  |
Displays the config/deconfig state of processors in the system
and allows the user to configure or reconfigure processors. <cpu> specify a processor |
<on|off> state to set the processor to |
Issuing cpuconfig with no parameters displays the config/deconfig
status of all processors. A user can reconfigure CPUs by specifying
a CPU number, and a state (on or off). If a valid state is entered
and is different from the current state of a CPU, its status changes
on the next boot. The last remaining configured CPU in a system
can not be deconfigured. Example 4-7 cpuconfig Command CPU Logical Cache Cache Model Processor |
Slot CPUs Speed Size Size (hex.) Rev State |
--- ------- --------- ---- ----- ------ ---- ---------- |
0 1 1 GHz 3 MB None 1F/00 B2 Active |
1 1 1 GHz 3 MB None 1F/00 B2 Active |
2 1 1 GHz 3 MB None 1F/00 B2 Active |
3 1 1 GHz 3 MB None 1F/00 B2 Active |
Example 4-8 cpuconfig 2 Command CPU will be deconfigured on next boot. |
CPU Logical Cache Cache Model Processor |
Slot CPUs Speed Size Size (hex.) Rev State |
--- ------- --------- ---- ----- ------ ---- ---------- |
0 1 1 GHz 3 MB None 1F/00 B2 Active |
1 1 1 GHz 3 MB None 1F/00 B2 Active |
2 1 1 GHz 3 MB None 1F/00 B2 Sched Deconf |
3 1 1 GHz 3 MB None 1F/00 B2 Active |
default |  |
Allows the user to restore NVM to default values and clear
NVM storage values. default clear [bmc|efi|sal] |
clear clears NVM storage values |
Default sets NVM and Stable Store values to predefined default
values. To the normal user only a subset of values are available
for default. Executing “default clear” resets
the system. errdump |  |
Displays the contents of processor internal memory logged
on the first MCA for all processors present in the system. errdump [mca | cpe | cmc | init | la | clear] |
mca dumps the Machine Check Abort error log |
cpe dumps the Corrected Platform Error log |
cmc dumps the Corrected Machine Check log |
init dumps the Initialization log |
la dumps the Logic Analyzer log |
clear erases all of the logs (mca, cpe, cmc, init, la) |
If a user enters no parameters, the usage is displayed. Otherwise,
the specified error log is displayed. Adding -n to the clear parameter
disables the confirmation prompt. (The errdump command can also
be accessed via the System Configuration menu.) info |  |
Allows the user to display most system information. target: valid targets are: |
cpu display information on cpus |
cache display information on cache |
mem display information on memory |
io display information on io |
boot display boot-related information |
chiprev display information on chip revisions |
fw display firmware version information |
sys display system information |
warning display warning and stop boot information |
Example 4-9 info -b all Command CPU Logical Cache Cache Model Processor |
Slot CPUs Speed Size Size (hex.) Rev State |
---- ------- -------- ------ ------ ------- ---- ------- - |
0 1 1 GHz 3 MB None 1F/01 B2 Active |
1 1 1 GHz 3 MB None 1F/01 B2 Active |
2 1 1 GHz 3 MB None 1F/01 B2 Sched Deconf |
3 1 1 GHz 3 MB None 1F/01 B2 Active |
--- DIMM A ----- ---- DIMM B ----- ----DIMM C ----- ---- DIMM D ----- |
DIMM Current DIMM Current DIMM Current DIMM Current |
--- ------ ---------- ------ ----------- ------ ---------- ----- ------------- |
0 256 MB Active 256 MB Active 256 MB Active 256 MB Active |
--- DIMM A ----- ---- DIMM B ----- ----DIMM C ----- ---- DIMM D ----- |
DIMM Current DIMM Current DIMM Current DIMM Current |
--- ------ ---------- ------ ----------- ------ ---------- ----- ------------- |
0 256 MB Active 256 MB Active 256 MB Active 256 MB Active |
Installed Memory : 1024 MB |
---- ---------- -------------------------------------------------------------------------------- |
1 HARDDRIVE Acpi(HWP0002,0)/Pci(2|0)/Scsi(Puno,Luno)/HD(Part1,Sig3D1F1 |
86A-846F-11D1-FB49BB94A768) |
2 HARDDRIVE Acpi(HWP0002,0)/Pci(2|0)/Scsi(Pun2,Luno)/HD(Part1,Sig965900000 |
3 CDROM Acpi(HWP0002,0)/Pci(2|1)/Scsi(Pun4,Luno)/CDROM(Entry0) |
4 HARDDRIVE Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1)Scsi(Pun2,Luno)/HD(Part2,SigA45AC380-2588-11D6- |
5 HARDDRIVE Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1)/Scsi(Pun2,Luno)/HD(Part2,Sig9C82CD80-70D2-4E88- |
Seg Bus Dev Fnc Vendor Device Slot |
--- --- --- --- ------ ------- ---- ------------- |
00 00 01 00 0x103C 0x1290 01 Acpi(HWP0002,0)/Pci(1|0) |
00 00 01 01 0x103C 0x1048 01 Acpi(HWP0002,0)/Pci(1|1) |
00 00 02 00 0x1000 0x000B 01 Acpi(HWP0002,0)/Pci(2|0) |
00 00 02 01 0x1000 0x000B 01 Acpi(HWP0002,0)/Pci(2|1) |
00 00 04 00 0x1011 0x0026 02 Acpi(HWP0002,0)/Pci(4|0) |
00 01 04 00 0x1033 0x0035 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|0) |
00 01 04 01 0x1033 0x0035 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|1) |
00 01 04 02 0x1033 0x00E0 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|2) |
00 01 05 00 0x1002 0x5159 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(5|0) |
00 20 01 00 0x1014 0x01A7 03 Acpi(HWP0002,100)/Pci(1|0) |
00 21 01 00 0x1000 0x0021 03 Acpi(HWP0002,100)/Pci(1|0)/Pci(1|0) |
00 21 01 01 0x1000 0x0021 03 Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1) |
00 21 04 00 0x14E4 0x1645 03 Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0) |
Monarch Monarch Possible Warnings |
------- ------- ------------------ |
AutoBoot : ON - Timeout is : 7 sev |
OS is not speedy boot aware |
--------- -------------------- |
LAN Address Information : |
------------- --------------------- |
*Mac(00306E05B950) Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0)/Mac(00306E05B950 |
Firmware Revision : 2.01 (xxxx) |
EFI INTEL Drop Revision : 7.31 |
EFI Build Revision : 7.41 |
Management Processor Revision : 7.41 |
WARNING AND STOP BOOT INFORMATION |
Warning [52] : A ROM revision is inconsistant with FIT or REVBLOCK |
CHIP REVISION INFORMATION : |
------------- ------- ------- --------- |
Memory Controller 0 122b 0022 |
Host Bridge 0000 122e 0022 |
Host Bridge 0001 122e 0022 |
Host Bridge 0002 122e 0022 |
Host Bridge 0003 122e 0022 |
Host Bridge 0004 122e 0022 |
Hot Plug Controller 0 0 0110 |
Host Bridge 0005 122e 0022 |
Host Bridge 0006 122e 0022 |
Hot Plug Controller 0 0 0110 |
Hot Plug Controller 0 0 0110 |
Example 4-10 info cpu Command CPU Logical Cache Cache Model Processor |
lot CPUs Speed Size Size (hex.) Rev State |
--- ------- --------- ------ ------ ------- ---- ------------ |
0 1 1 GHz 3 MB None 1F/01 B2 Active |
1 1 1 GHz 3 MB None 1F/01 B2 Active |
2 1 1 GHz 3 MB None 1F/01 B2 Sched Deconf |
3 1 1 GHz 3 MB None 1F/01 B2 Active |
Example 4-11 info mem Command --- DIMM A ----- ---- DIMM B ----- ----DIMM C ----- ---- DIMM D ----- |
DIMM Current DIMM Current DIMM Current DIMM Current |
--- ------ ---------- ------ ----------- ------ ---------- ----- ------------- |
0 256 MB Active 256 MB Active 256 MB Active 256 MB Active |
--- DIMM A ----- ---- DIMM B ----- ----DIMM C ----- ---- DIMM D ----- |
DIMM Current DIMM Current DIMM Current DIMM Current |
--- ------ ---------- ------ ----------- ------ ---------- ----- ------------- |
0 256 MB Active 256 MB Active 256 MB Active 256 MB Active |
Installed Memory : 1024 MB |
Example 4-12 info io Command ----- ---------- ------------------------------------------------------------------------- |
1 HARDDRIVE Acpi(HWP0002,0)/Pci(2|0)/Scsi(Pun0,Lun0)/HD(Part1, |
Sig3D1F186A-846F-11D1-8780-FB49BB94A768) |
2 HARDDRIVE Acpi(HWP0002,0)/Pci(2|0)/Scsi(Pun2,Lun0)/HD(Part1,Sig9659000) |
3 CDROM Acpi(HWP0002,0)/Pci(2|1)/Scsi(Pun4,Lun0)/CDROM(Entry0) |
4 HARDDRIVE Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1)/Scsi(Pun2,Lun0)/HD(Part1, |
SigA45AC380-2588-11D6-B48C-806D6172696F) |
5 HARDDRIVE Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1)/Scsi(Pun2,Lun0)/HD(Part1, |
Sig9C82CD80-70D2-4E88-A374-B029EBF1D8E4) |
Seg Bus Dev Fnc Vendor Device Slot |
--- --- --- --- -- ------ ------- --- ---------- |
00 00 01 00 0x103C 0x1290 01 Acpi(HWP0002,0)/Pci(1|0) |
00 00 01 01 0x103C 0x1048 01 Acpi(HWP0002,0)/Pci(1|1) |
00 00 02 00 0x1000 0x000B 01 Acpi(HWP0002,0)/Pci(2|0) |
00 00 02 01 0x1000 0x000B 01 Acpi(HWP0002,0)/Pci(2|1) |
00 00 04 00 0x1011 0x0026 02 Acpi(HWP0002,0)/Pci(4|0) |
00 01 04 00 0x1033 0x0035 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|0) |
00 01 04 01 0x1033 0x0035 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|1) |
00 01 04 02 0x1033 0x00E0 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(4|2) |
00 01 05 00 0x1002 0x5159 02 Acpi(HWP0002,0)/Pci(4|0)/Pci(5|0) |
00 20 01 00 0x1014 0x01A7 03 Acpi(HWP0002,0)/Pci(1|0) |
00 21 01 00 0x1000 0x0021 03 Acpi(HWP0002,100)/Pci(1|0)/Pci(1|0) |
00 21 01 01 0x1000 0x0021 03 Acpi(HWP0002,100)/Pci(1|1)/Pci(1|1) |
00 21 04 00 0x14E4 0x1645 03 Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0) |
Example 4-13 info boot Command Monarch Monarch Possible Warnings |
-------- --------- ------------------ |
AutoBoot: on - Timeout is : 7 SEC |
boottest Settings Default Variable |
OS is not speedy boot aware. |
---------- -------------- |
------------------- -------------- |
*Mac(00306E05B950) Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0)/Mac(00306E05B950B) |
lanaddress |  |
Allows the user to display the core IO MAC address. none Example 4-14 lanaddress Command ------------------ -------------------------- |
*Mac(00306E05B950) Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0)/Mac(00306E05B950) |
monarch |  |
Displays or modifies the ID of the bootstrap processor. The
preferred monarch number is stored in NVM. If specified with no parameters, monarch displays the Monarch
processor for the system. Specifying a processor number alters the
preferred Monarch processor. None of these changes takes affect
until after a reboot. Example 4-15 monarch Command Monarch Monarch Possible Warnings |
------- --------- ----------------- |
To view monarch: fs0 :\ monarch |
-----------------+----------- |
To set the monarch processor to 1: fs0 :\ monarch 1 |
-----------------+----------- |
pdt |  |
Displays or clears the contents of the Page Deallocation Table. With no options specified, the command displays the PDT information
for the system. The PDT is cleared and a reboot is required for
memory reallocation and safe booting. Example 4-16 pdt Command Last Clear time: PDT has not been cleared |
Number of total entries in PDT: 50 |
Number of used entries in PDT: 0 |
Number of free entries in PDT: 50 |
Number of single-bit entries in PDT: 0 |
Number of multi-bit entries in PDT: 0 |
Address of first multi-bit error: x0000000000000000 |
Example 4-17 pdt clear Command Are you sure you want to clear the PDT? [y/N] y |
Last Clear time: 10/21/01 5:00p |
Number of total entries in PDT: 50 |
Number of used entries in PDT: 0 |
Number of free entries in PDT: 50 |
Number of single-bit entries in PDT: 0 |
Number of multi-bit entries in PDT: 0 |
Address of first multi-bit error: 0x0000000000000000 |
sysmode |  |
Display or modify the system mode. sysmode <normal | admin| service> |
<normal> sets system mode to normal |
<admin> sets system mode to admin |
<service> sets system mode to service |
If specified alone, sysmode displays the system mode. If a
mode is specified as a parameter, then the system mode is changed.
This new mode takes effect immediately. The system mode is retained
on successive boots. Interaction with sysmode in a variety of scenarios
is outlined below. Example 4-18 sysmode Command You are now in admin mode. |
You are now in service mode. |
You are now in normal mode |
|