Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
hp Integrity rx5670 Operation and Maintenance Guide > Chapter 4 Utilities

EFI/POSSE Commands

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

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.

Syntax

  • help [-b] <category>
    help [-b] <cmd>
    help [-b] bch <bchmenu> <bchcmd>

Parameters

  • -b              Enable page breaking
    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

Operation

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

  • Shell> help
    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
    Configuration commands:

  • 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

  • Shell> help cpuconfig

  • CPUCONFIG [cpu] [on|off]

  •    cpu    Specifies which cpu to configure
       on|off Specifies to configure or deconfigure a cpu

  •    Notes:
            1. Cpu status will not change until next boot.

  •    Examples:
           * To deconfigure CPU 0
           fs0:\> cpuconfig 0 off
           CPU will be deconfigured on the next boot.

  •        * To display configuration status of cpus
           fs0:\> cpuconfig
           <CPU configuration data displayed>

Example 4-4 help bch Command

  •     COnfiguration         help bch co
        INformation           help bch in
        PAth               	 	 	 help bch pa
        ScRool               	 	help bch sr
        SEArch               	 	help bch sea
        SERvice              	 help bch ser
    	 	 	 	 BOot              	 	 	 	 help bch bo
    	 	 	 	 HElp              	 	 	 	 help bch he
        RESET                	 help bch reset
     	 	 	 MAin                	 	 help bch ma

  •     For more help on one of the commands above, at the prompt type:
            help bch COMMAND

baud

Sets the baud rate and communication settings for a UART.

Syntax

  • baud <index> <baudrate>

Parameters

  • <index> 0 through the total number of UARTS minus one
    <baudrate>      baud rate.

Operation

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

ParameterValue
RECEIVE_FIFO_DEPTH 1
TIMEOUT 1000000
PARITYNo parity
DATA_BITS8
STOP_BITS1
CONTROL_MASK0

 

boottest

Interacts with the speedy boot variable allowing it to be set appropriately.

Syntax

  • 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

Parameters

  • [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

  • Shell> boottest
       BOOTTEST Settings Default Variable
       Selftest         Setting
       -------------    -------------------------
       booting_valid    On (OS speedy boot aware)
       early_cpu        Run this test
       late_cpu         Run this test
       platform         Run this test
       chipset          Run this test
       io_hw            Run this test
       mem_init         Run this test
       mem_test         Run this test

Example 4-6 boottest early_cpu off Command

  • Shell> boottest early_cpu off
       BOOTTEST Settings Default Variable
       Selftest         Setting
       -------------    -------------------------
       booting_valid    On (OS speedy boot aware)
       early_cpu        Skip this test
       late_cpu         Run this test
       platform         Run this test
       chipset          Run this test
       io_hw            Run this test
       mem_init         Run this test
       mem_test         Run this test

cpuconfig

Displays the config/deconfig state of processors in the system and allows the user to configure or reconfigure processors.

Syntax

  • cpuconfig <cpu> <on|off>

Parameters

  • <cpu>           specify a processor
    <on|off>        state to set the processor to

Operation

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

  • Shell> cpuconfig
    PROCESSOR INFORMATION
    	 	 	 	 	 	 	 	# of	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 		 L3	 	 	 	 	 		L4	 	 	 	 	 Family/
    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

  • Shell> cpuconfig 2 off
    CPU will be deconfigured on next boot.

  • Shell> cpuconfig
    PROCESSOR INFORMATION
    	 	 	 	 	 	 	 	# of	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 		 L3	 	 	 	 	 		L4	 	 	 	 	 	 	 Family/
    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.

Syntax

  • default     [efi|sal]
    default      clear [bmc|efi|sal]

Parameters

  • clear	     clears NVM storage values

Operation

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.

Syntax

  • errdump [mca | cpe | cmc | init | la | clear]

Parameters

  • 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)

Operation

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.

Syntax

  • info [ -b] [target]

Parameters

  • target:         valid targets are:
            all        display everything
            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

  • Shell> info -b all
    PROCESSOR INFORMATION

  •  	 	 	 	 	 	 		# of		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 L3	 	 	 	 	 	 		L4	 	 	 	 	 	 	 Family/
    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

  • MEMORY INFORMATION
    Extender 0:
     	 	 	 	 	 	 	--- 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
    	 1     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----	
    	 2     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----
    	 3     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----
    	 4     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----	
    	 5     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----
    Extender 1:
    	 	 	 	 	 	 	 	--- 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
    	 1     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----
    	 2     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----	
    	 3     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----	
    	 4     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----	
    	 5     ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 		----		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ----	 	 	 	 	 	 	 	 	 	 	 		 	 	 ----

  • 	 	 Active Memory 	 	 	 : 1024 MB	
    	 	 Installed Memory : 1024 MB

  • 	I/O INFORMATION
    BOOTABLE DEVICES
     	Order 		Media Type	 	Path
      ---- 		---------- --------------------------------------------------------------------------------
    	 	 	 	 	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-
    B48C-806D6172696F)
    	 	 	 		 	5  HARDDRIVE	 	 	 	Acpi(HWP0002,100)/Pci(1|0)/Pci(1|1)/Scsi(Pun2,Luno)/HD(Part2,Sig9C82CD80-70D2-4E88-
    A374-B029EBF1D8E4)
    		 Seg  	 	Bus 	 	 Dev   	Fnc 	 	 Vendor 	 	 Device 	 	 	 Slot
    	 	 	# 	 	 	 	 	# 	 	 	 	 # 	 	 	 	 		# 	 	 	 	 	 ID 	 	 	 	 	 	 	ID 	 	 	 	 	 	 		# 	 	 	 	 Path	
    	 	--- 	 	 --- 	 	 --- 	 	 ---	 	 	 	------ 	 	 -------	 	 	 ----  	 		-------------
    	 		 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)

  • BOOT INFORMATION
     	 Monarch CPU :
    	 	 Current Preferred
    	 Monarch 	 	 	 	 	Monarch 	 	 	Possible Warnings	
    	 	------- 	 	 	 	 ------- 	 	 ------------------
    	 	 	 	 	 	0 	 	 	 	 	 	 	 	 	 0

  •  AutoBoot : ON - Timeout is : 7 sev
    	 		Boottest	 	 : 
    	 	OS is not speedy boot aware
    	 Selftest 	 	 	 	 	 	 Setting 	 
    	 	--------- 	 	 	 		 	 --------------------
    	 		early_cpu 	 	 	 	 	 	Skip this test
    	 		late_cpu 	 	 	 	 	 	 	Run this test
    		 	platform 	 	 	 	 	 	 	Run this test
    		 		chipset 	 	 	 	 	 	 	 	Run this test
    		 		io_hw		 	 	 	 	 					 					 					 					 			 	Run this test
     		mem_init	 					 					 	 	 	 	 	Run this test
    		 		mem_test 	 	 	 	 	 	 	Run this test

  • LAN Address Information	:
    Lan Address	 	 	 	 	 	 	 	 	 	 Path	 
    	------------- 	 	 	 		 	 	 	 ---------------------
    *Mac(00306E05B950)	 	 	 Acpi(HWP0002,100)/Pci(1|0)/Pci(4|0)/Mac(00306E05B950

  • AWARE INFORMATION
    	 verscode	 	 	 : 00.00 xxx
    	 datecode 	 	 : 	xxxx
    	 built with : xxxxxxx
    	 	 	 Firmware Revision		 : 2.01 (xxxx)
    	 	 	 PAL_A Revision	 	: 7.31
    	 	 	 PAL_B Revision	 	: 7.41
    	 	 	 SAL Spec Revision	 	: 7.31
    	 	 	 SAL_A Revision	 	: 7.41
    		 		 	 	SAL_B Revision	 	: 7.31
    	 	 	 EFI Spec Revision	 	: 7.41
    	 	 	 EFI INTEL Drop Revision	 	: 7.31
    	 	 	 EFI Build Revision	 	: 7.41
    	 	 	 POSSE Revision	 	: 7.31
    	 	 	 ACPI Revision	 	: 7.41
    	 	 	 BMC Revision	 	: 7.31
    	 	 	 IPMI Revision	 	: 7.41
    	 	 	 SMBIOS Revision	 	: 7.31
    	 	 	 Management Processor Revision	 	: 7.41

  • WARNING AND STOP BOOT INFORMATION
    	 Warning [52] : A ROM revision is inconsistant with FIT or REVBLOCK