Specifications

156 Version 2.0
Description
This command creates a mapping between a user-defined name and a device. The
most common use of this command is to create a the 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 map command is used without any
parameters, all of the current mappings will be listed. If the -v option is used, the
mappings will be shown with additional information about each device.
The -r option is used to reset all the default mappings in a system; this option is
useful if the system configuration has changed since the last boot.
The –u option will add mappings for newly installed devices and remove mappings for
uninstalled devices but will not change the mappings of existing devices. The user-
defined mappings are also preserved. A mapping history will be 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
will be the same. Use the -c option to list all the consistent mappings in the system.
The mapping consist of digits and characters. Other characters are illegal.
This command support wildcards. You can use the wildcards to delete or show the
mapping . However, when you assign the mapping, wildcards are forbidden.
Status Codes Returned
SHELL_SUCCESS The action was completed as requested.
SHELL_SECURITY_VIOLATION This function was not performed due to a security violation
SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly formatted or
its value was out of bounds.
Standard-Format Output
If –sfo is specified, then the map command will output a single table: Mappings. The
following table describes the table columns for this table: