map

Syntax

map[-d mappedname]

map[-r|-v|-c|-f|-u|-t type[,type]|mappedname][-sfo]

map[mappedname|mapping]

Description

Displays or configures a mapping between a user-defined name and a device handle.

Options

-d

Deletes a mapping.

mappedname

Specifies a mapping name.

-r

Resets a mapping.

-v

Displays verbose information about all mappings.

-c

Shows the consistent mapping.

-f

Shows the normal mapping.

-t

Shows the device mappings, filtered according to the device type. Supported types are:

• fp—floppy
• hd—hard disk
• cd—CD-ROM

Types can be combined by putting a comma between two types. Spaces are not allowed between types.

-sfo

Displays in standard formatted output.

-u

Adds mappings for newly-installed devices and removes mappings for uninstalled devices, but does not change the mappings of existing devices. Preserves user-defined mappings.

handle

Specifies the number of the handle.

mapping

Specifies a new mapped name to assign to a device. The mapping must end with a colon (:).

Usage

The most common use of this command is to create a mapped name for devices that support a file system protocol. Once these mappings are created, the names can be used with all the file manipulation commands.

The UEFI Shell environment creates default mappings for all of the devices that support a recognized file system.

This command can be used to create additional mappings, or it can be used to delete an existing mapping with the -d option. If the command is used without any parameters, all of the current mappings are listed. If the -v option is used, the mappings are shown with additional information about each device.

The -r option resets all the default mappings in a system. This is useful if the system configuration has changed since the last boot.

The –u option adds mappings for newly installed devices and remove mappings for uninstalled devices, but does not change the mappings of existing devices. The user-defined mappings are also preserved. A mapping history is saved so that the original mapping name is used for a device with a specific device path if that mapping name was used for that device path last time. The current directory is also preserved if the current device is not changed.

Each device in the system has a consistent mapping. If the hardware configuration has not changed, the device’s consistent mappings do not change. If two or more machines have the same hardware configurations, the device’s consistent mapping is the same. Use the -c option to list all of the consistent mappings in the system.

The mapping consists of digits and characters. Other characters are not allowed.

This command supports wildcards to delete or show mappings. However, when assigning the mapping, wildcards are forbidden.

Example

To delete a mapping:

Shell> map -d devicename
      

Output details

The following table describes possible output for this command.