vparefiutil.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vpareﬁutil(1M) vpareﬁutil(1M)

(Itanium-Based Systems)

NAME

vpareﬁutil - display, update, or delete HP-UX hardware path to EFI path mappings of bootable disks in

the virtual partition database

SYNOPSIS

vparefiutil [-D db_ﬁle ][

-u|-M|-d][-H hw_path ]

Platform Support Remarks

vparefiutil is not supported on systems with Onboard Administrator (OA) based partition

management.

DESCRIPTION

The

vparefiutil command displays the HP-UX hardware path to EFI path mappings that are stored

in the virtual partition database. Legacy and agile hardware paths will be displayed, if available, as pro-

vided by HP-UX. If the virtual partition database is not speciﬁed, then the live database or by default

/stand/vpdb is used. It can also be used to update the hw_path to EFI_path mappings from

ioscan

to the database. The behavior without any options is to display the HP-UX hardware path to EFI path

mappings.

This command is not supported on PA-RISC systems.

Options and Arguments

vparefiutil recognizes the following command line options and arguments:

-D db_file

Speciﬁes the alternate database from which the HP-UX hardware path to EFI path mappings need

to be displayed, updated, or deleted. /stand/vpdb or live vpdb is default if this is not speciﬁed.

-u Updates the database from the info available (from ioscan).

-M Displays the HP-UX hardware path to EFI path mapping in machine readable format. Each map-

ping is displayed in a separate line as follows:

legacy_hw_path1

:EFI_path1

::agile_hw_path1

legacy_hw_path2:EFI_path2

legacy_hw_path3

EFI_path3 ::agile_hw_path3

legacy_hw_path4:EFI_path4

:sas_addr4 :

...

-d Deletes the HP-UX hardware path to EFI path mappings in the database.

Note: In live database, this deletes only the HP-UX hardware paths owned by the vpar on which

this command is executed.

-H hw_path

If this is speciﬁed, only the HP-UX hardware paths at or below the given hw_path are displayed,

updated, or deleted.

SECURITY RESTRICTIONS

This command is restricted to processes owned by superuser.

RETURN VALUE

vparefiutil returns the following values:

0 Successful completion.

1 Error condition occurred.

EXAMPLES

Display the hw_path to EFI_path mappings from the live database.

# vparefiutil

Hardware path - EFI path mapping

================================

Hardware path : 2.0.0.2.0.6.0

: 2.0.0.2.0.6.0

EFI path : Acpi(HWP0002,200)/Pci(2|0)/Scsi(Pun6,Lun0)/\EFI\HPUX\HPUX.EFI

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
vparefiutil(1M) vparefiutil(1M) (Itanium-Based Systems) NAME vparefiutil - display, update, or delete HP-UX hardware path to EFI path mappings of bootable disks in the virtual partition database SYNOPSIS vparefiutil [-D db_file ] [-u|-M|-d] [-H hw_path ] Platform Support Remarks vparefiutil is not supported on systems with Onboard Administrator (OA) based partition management.
PAGE 2
vparefiutil(1M) vparefiutil(1M) (Itanium -Based Systems) Hardware path : 2.0.0.3.0.6.0 : 2.0.0.3.0.6.0 EFI path : Acpi(HWP0002,200)/Pci(3|0)/Scsi(Pun6,Lun0)/\ HD(Part1,Sig471031FC-6A12-11D9-8002-D6217B60E588)/\EFI\HPUX\HPUX.EFI Hardware path : 2.0.0.3.1.2.0 : 2.0.0.3.1.2.0 EFI path : Acpi(HWP0002,200)/Pci(3|1)/Scsi(Pun2,Lun0)/\EFI\HPUX\HPUX.EFI Hardware path : 2.0.8.1.0.3.4.0.0.1.6 : 2.0.8.1.0.0x50001fe1500339ed.
PAGE 3
vparefiutil(1M) vparefiutil(1M) (Itanium -Based Systems) Hardware path : 2.0.12.1.0.4.1.12.0 : EFI path : Acpi(HWP0002,2C6)/Pci(1|0)/Pci(4|1)/Scsi(PunC,Lun0)/\ HD(Part1,Sig4D70B9D6-6AD5-11D9-8002-D6217B60E588)/\EFI\HPUX\HPUX.EFI Display the hw_path to EFI_path mappings from the alternate database vpdb_foo in machine readable format. # vparefiutil -M -D vpdb_foo 2.0.0.2.0.6.0:Acpi(HWP0002,200)/Pci(2|0)/Scsi(Pun6,Lun0)/\EFI\HPUX\HPUX.EFI::2.0.0.2.0 2.0.0.3.0.6.
PAGE 4
vparefiutil(1M) vparefiutil(1M) (Itanium -Based Systems) Hardware path : 2.0.0.2.0.6.0 : EFI path : Acpi(HWP0002,200)/Pci(2|0)/Scsi(Pun6,Lun0)/\EFI\HPUX\HPUX.EFI Hardware path : 2.0.8.1.0.3.4.0.0.1.6 : 2.0.8.1.0.0x50001fe1500339ed.0x1000000000000 EFI path : Acpi(HWP0002,28C)/Pci(1|0)/Pci(4|0)/\ Fibre(WWN50001FE1500339ED,Lun1000000000000)/\ HD(Part1,Sig9FEF4B40-6AC7-11D9-8002-D6217B60E588)/\EFI\HPUX\HPUX.EFI Hardware path : 2.0.12.1.0.4.1.8.
PAGE 5
vparefiutil(1M) vparefiutil(1M) (Itanium -Based Systems) EFI\HPUX\HPUX.EFI SAS Address : 0x500000e01200d3f2 The SAS hardware path can potentially change from one OS instance to another, but the SAS address will remain the same. To locate SAS devices in different OS instances (for example, an nPar OS instance and a vPar OS instance), use the SAS address instead of the hardware path. WARNING The -d option is provided only to remove the stale HP-UX hardware path to EFI path mappings.
PAGE 6
(Notes) A (Notes) vA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010