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
—floppyhd
—hard diskcd
—CD-ROM
-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.
Column Number |
Description |
---|---|
1 |
The name of the table. The name is mappings. |
2 |
Mapped name. The mapped device name. |
3 |
Device Path. The device path that corresponds to the mapped device name. |
4 |
Consistent Name. The consistent mapped name (if any) that is equivalent to
|