Guía de usuario de HP UEFI Shell para cartuchos de servidor HP

Guía de usuario de HP UEFI Shell para
cartuchos de servidor HP ProLiant m400
Este documento detalla cómo utilizar y acceder al shell de Unified Extensible Firmware Interface (Interfaz de firmware extensible
unificada, UEFI) integrada en la ROM de todos los cartuchos de servidor HP ProLiant m400 basados en UEFI. Este documento
está dirigido a la persona encargada de la instalación, administración y solución de problemas de los servidores y sistemas
de almacenamiento.
Nº de referencia de HP: 833084-071
Publicado: Agosto de 2015
Edición: 1
© Copyright 2015 Hewlett-Packard Development Company, L.P.
Avisos
Software informático confidencial. Para la posesión, uso o copia de su software es necesaria una licencia válida de HP. Cumpliendo con la
normativa FAR 12.211 y 12.212, el software informático comercial, la documentación del software informático comercial y los datos técnicos
sobre elementos comerciales se han concedido al gobierno de EE. UU. bajo la licencia comercial estándar del proveedor.
La información que incluye este documento está sujeta a cambios sin previo aviso. Las únicas garantías de los productos y servicios de HP están
establecidas en las declaraciones expresas de garantía que acompañan a dichos productos y servicios. No se podrá interpretar nada de lo aquí
incluido como parte de una garantía adicional. HP no se hace responsable de los errores u omisiones de carácter técnico o editorial que puedan
figurar en este documento.
Reconocimientos
Intel®, Itanium®, Pentium®, Intel Inside® y el logotipo de Intel Inside son marcas comerciales o registradas de Intel Corporation o sus filiales en
los EE. UU. y en otros países.
Microsoft®, Windows® y Windows Server® son marcas registradas del grupo de empresas Microsoft.
UNIX® es una marca registrada de The Open Group.
® es una marca registrada de UEFI Forum, Inc.
Contenido
1 Uso de UEFI Shell.......................................................................................5
Comandos y capacidades.........................................................................................................5
Acceso a Embedded UEFI Shell..................................................................................................5
Sesiones de Microsoft Windows y Linux..................................................................................5
2 Referencia de comandos de UEFI Shell..........................................................9
Comandos del shell personalizados de HP...................................................................................9
Sintaxis de la línea de comandos...............................................................................................9
Autocompletado de línea de comandos..................................................................................9
Introducción a UEFI Shell.........................................................................................................10
Control del resultado de los comandos.................................................................................10
Limitación de los resultados a una sola pantalla a la vez....................................................10
Activación o desactivación de saltos de página globales...................................................11
Visualización de resultados detallados.............................................................................11
Visualización de un resumen de los resultados..................................................................12
Eliminación de la solicitud de confirmación al usuario........................................................12
Visualización de la ayuda de los comandos..........................................................................13
Visualización de la ayuda de todos los comandos.............................................................13
Visualización de la ayuda de un comando específico........................................................14
Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácter
específico....................................................................................................................15
Conmutación a un sistema de archivos desde el shell.............................................................17
Uso de los comandos de instalación y configuración comunes.................................................17
Comandos de UEFI Shell.........................................................................................................18
alias................................................................................................................................18
attrib................................................................................................................................19
bcfg.................................................................................................................................20
boot.................................................................................................................................20
cd....................................................................................................................................21
cls....................................................................................................................................22
comp...............................................................................................................................23
connect............................................................................................................................23
cp....................................................................................................................................24
date.................................................................................................................................26
dblk.................................................................................................................................27
devices.............................................................................................................................27
devtree.............................................................................................................................28
dh...................................................................................................................................29
disconnect........................................................................................................................31
dmem..............................................................................................................................32
drivers..............................................................................................................................32
echo................................................................................................................................33
edit..................................................................................................................................34
eficompress.......................................................................................................................35
efidecompress...................................................................................................................35
exit..................................................................................................................................35
ftp...................................................................................................................................36
getmtc..............................................................................................................................36
goto.................................................................................................................................37
help.................................................................................................................................37
ifconfig.............................................................................................................................38
load.................................................................................................................................39
Contenido
3
ls/dir...............................................................................................................................39
map.................................................................................................................................42
memmap..........................................................................................................................43
mkdir...............................................................................................................................45
mode...............................................................................................................................46
mv...................................................................................................................................46
openinfo...........................................................................................................................47
parse...............................................................................................................................47
pause...............................................................................................................................48
pci...................................................................................................................................49
ping.................................................................................................................................49
reset.................................................................................................................................50
rm/del.............................................................................................................................50
set...................................................................................................................................52
setsize..............................................................................................................................53
shift.................................................................................................................................53
smbiosview.......................................................................................................................53
stall..................................................................................................................................54
sysinfo..............................................................................................................................54
time.................................................................................................................................55
timezone..........................................................................................................................55
touch................................................................................................................................56
type.................................................................................................................................56
unload.............................................................................................................................57
ver...................................................................................................................................57
vol...................................................................................................................................58
webclient..........................................................................................................................59
3 Ejecución y edición de las secuencias de comandos clave de UEFI Shell..........61
Llamada a las secuencias de comandos....................................................................................61
Configuración del inicio automático de la secuencia de comandos de UEFI Shell en las utilidades
del sistema........................................................................................................................61
Llamada manual a una secuencia de comandos del shell........................................................61
Edición de secuencias de comandos del shell.............................................................................61
Ejemplos de secuencias de comandos de UEFI Shell....................................................................61
Secuencia de comandos con el código fuente de una aplicación.............................................61
4 Uso del modelo de programación de UEFI...................................................64
5 Códigos de estado de comandos de UEFI Shell...........................................67
6 Asistencia y otros recursos.........................................................................68
Contacto con HP....................................................................................................................68
Servicio de subscripción......................................................................................................68
Acceso a los materiales de soporte de HP.................................................................................68
Información relacionada..........................................................................................................68
Páginas web.....................................................................................................................69
Convenciones tipográficas.......................................................................................................69
HP Insight Remote Support.......................................................................................................70
7 Comentarios sobre la documentación..........................................................71
Glosario.....................................................................................................72
Índice........................................................................................................73
4
Contenido
1 Uso de UEFI Shell
El BIOS del sistema de los cartuchos de servidor HP ProLiant m400 compatibles incluye Embedded
UEFI Shell en la ROM. El entorno del shell está basado en la UEFI Shell Specification (Especificación
de UEFI Shell) y proporciona una API y una CLI que permiten ejecutar secuencias de comandos,
manipular archivos y obtener información del sistema. El shell ejecuta también otras aplicaciones
UEFI. Estas características mejoran las capacidades de las utilidades del sistema UEFI. El acceso
a Embedded UEFI Shell está activado de forma predeterminada.
Comandos y capacidades
A continuación se detallan los comandos y las capacidades que están disponibles en UEFI Shell:
•
Configuración del BIOS (sysconfig)
•
Creación de secuencias de comandos:
•
◦
Archivos nsh con estructuras habituales de secuencias de comandos, como if, else,
endif, shift o for/endfor
◦
Comando echo
◦
Archivo de inicio de automático startup.nsh similar al archivo Autoexec.bat
◦
Una opción de resultados en formato estándar (-sfo) para varios comandos que permite
analizar los datos de salida separados por comas mediante un comando de análisis
Manipulación de archivos:
◦
Capacidad para leer cualquier archivo FAT16 y FAT32
◦
Comandos de operaciones de archivo estándar como, por ejemplo, mkdir, cd, cp/copy,
del, dir/ls, alias y touch
◦
Edición (edit) y visualización (type) de archivos
◦
Redireccionamiento de la entrada y la salida desde y hacia las consolas, así como a
archivos
Acceso a Embedded UEFI Shell
Conéctese con el cartucho de servidor HP ProLiant m400 desde la CLI de iLO CM utilizando dos
ventanas TTY, una para una sesión del puerto serie virtual y otra para controlar el encendido del
cartucho de servidor.
Cuando se utiliza Microsoft Windows, se requiere un cliente SSH para acceder al firmware de
Moonshot iLO CM. En los ejemplos de estas instrucciones se usa PuTTY, un cliente SSH gratuito.
Si utiliza Linux, abra una sesión SSH desde una línea de comandos escribiendo ssh
nombre_de_usuario@dirección_IP_de_iLO_CM (por ejemplo, ssh
[email protected]).
Sesiones de Microsoft Windows y Linux
Puede conectarse al Moonshot iLO CM firmware e iniciar una sesión de línea de comandos
mediante el puerto serie de la parte trasera del módulo Moonshot 1500 CM o una sesión SSH a
través de una red LAN. Todos los comandos están disponibles independientemente del método
de conexión utilizado. En estas instrucciones se supone un entorno DHCP.
Comandos y capacidades
5
1.
Realice una de las acciones siguientes:
•
Inicie PuTTY en la máquina remota y escriba el nombre de host del chasis o su dirección IP.
Compruebe el nombre DNS preestablecido en la etiqueta extraíble de la parte frontal
del chasis. En un entorno DHCP, este es el nombre de host/DNS que se registra en el
servidor DNS en el arranque. Junto con el nombre de dominio, se puede usar en PuTTY
en lugar de la dirección IP. Como alternativa, utilice el nombre DNS para determinar la
dirección IP a través de herramientas de red estándar.
•
6
Conecte un extremo de un cable serie al puerto serie de la parte posterior del Moonshot
1500 CM module y el otro a un ordenador portátil o a otro equipo local y, a continuación,
inicie PuTTY y seleccione una conexión serie en la máquina local. Establezca los
parámetros de conexión serie en 115200/8-N-1.
Uso de UEFI Shell
2.
Haga clic en Open (Abrir). Se abre la ventana de sesión con la opción Login as:
(Iniciar sesión como:).
Esta ventana de PuTTY es la ventana A.
3.
4.
5.
6.
Introduzca Administrator como nombre de usuario y pulse Intro.
Aparece un pequeño mensaje de bienvenida, que muestra el nombre del chasis, del host y
la dirección IP. Puede haber un pequeño retardo mientras se procesan las credenciales antes
de que aparezca el mensaje de bienvenida.
Introduzca show network para mostrar la información de red, que incluye la dirección IP.
Anote esta información para más adelante. DHCP está activado de forma predeterminada.
Esto garantiza que todas las direcciones IP, direcciones de puerta de enlace, máscaras y
direcciones DNS se asignen automáticamente cuando el firmware de iLO CM se conecta a
la red. El nombre DNS predeterminado para el firmware de iLO CM es una concatenación
del iLO y el número de serie del chasis. Una vez que se arranque el chasis y el DNS haya
propagado el nombre, podrá acceder al chasis por su nombre (sin necesidad de buscar la
dirección a través del puerto serie).
Escriba los siguientes comandos:
a. SHOW CARTRIDGE LIST: este comando muestra una lista de los cartuchos de servidor
HP ProLiant instalados. Busque el cartucho de servidor ProLiant m400 que desee en esta
lista y anote el número de cartucho (por ejemplo, c19).
b. SHOW NODE OPTIONS cXnY: introduzca este comando para ver las opciones disponibles
y su configuración actual para el nodo.
hpiLO-> show node options c19n1
c19: #Cartridge 19
c19n1: #Node 1
boot: M.2
bootonce: N/A
WOL: DISABLE #default
BootType: UEFI
RestoreUefiDefaults: No #default
c.
Anote el valor de BootType.
SET NODE OPTIONS BOOTTYPE UEFI cXnY: introduzca este comando si es necesario
para configurar el cartucho HP ProLiant m400 para que lleve a cabo un arranque con
UEFI en lugar de un arranque heredado (uboot).
hpiLO-> set node options boottype uefi c19n1
Success: c19n1 option BootType = UEFI
d.
7.
SET NODE POWER OFF FORCE cXnY: introduzca este comando para apagar el nodo
antes de encenderlo de nuevo y abrir las pantallas de UEFI.
Abra una nueva ventana de PuTTY y, a continuación, conéctese e inicie sesión en el Moonshot
iLO CM firmware.
Esta ventana de PuTTY es la ventana B.
8.
[Ventana B] Escriba el comando CONNECT NODE VSP cXnY para abrir una sesión del puerto
serie virtual en el cartucho de servidor HP ProLiant m400.
9. [Ventana A] Escriba el comando SET NODE POWER ON cXnY para encender el nodo.
10. [Ventana B] La pantalla muestra la secuencia de la POST normal hasta que el proceso de
arranque llega a la opción access via BIOS serial console:
(C) Copyright 1982 - 2015 Hewlett-Packard Development Company, L.P.
HP ProLiant m400 Server
BIOS Version: U02 v1.00 (07/09/2015)
Serial Number: CN7451V6DH
System Memory: 64 GB
Acceso a Embedded UEFI Shell
7
1 Processor(s) detected, 8 total cores enabled, Proc 1: X-Gene
HP Power Profile Mode: Balanced Power and Performance
Boot Mode: UEFI
For access via BIOS Serial Console:
Press 'ESC+9' for System Utilities
Press 'ESC+@' for Network Boot
11. [Ventana B] Mantenga pulsada la tecla Esc y, a continuación, pulse 9 para acceder a las
pantallas de UEFI.
Hay una breve pausa hasta que aparecen los menús de UEFI:
> System Configuration
Embedded Applications
System Information
Exit and resume system boot
Reboot the System
12. En la pantalla System Utilities (Utilidades del sistema), seleccione Embedded Applications
(Aplicaciones integradas)→Embedded UEFI Shell y pulse la tecla Intro.
13. Pulse cualquier tecla para indicar que está listo para utilizar el shell.
14. Cuando haya terminado, escriba el comando exit para volver a los menús de UEFI.
8
Uso de UEFI Shell
2 Referencia de comandos de UEFI Shell
Comandos del shell personalizados de HP
Este símbolo indica que un comando es una adición personalizada de HP a los comandos
proporcionados por la UEFI Shell Specification (Especificación de UEFI Shell).
Sintaxis de la línea de comandos
En la tabla siguiente se muestran ejemplos de cómo se debe interpretar la sintaxis de los comandos.
Tabla 1 Ejemplos de sintaxis
Ejemplo de sintaxis
Uso
exit
Escriba exit.
date [mm/dd/ { aa | aaaa }] [-sfo] Realice una de las acciones siguientes para mostrar la fecha actual:
• Escriba el comando date sin parámetros opcionales.
• Escriba el comando date seguido de -sfo para obtener los resultados
en formato estándar.
NOTA: Para establecer una fecha específica en el sistema, escriba
el comando date seguido de los parámetros de fecha en uno de los
formatos siguientes:
◦
mm/dd/aa
◦
mm/dd/aaaa
Esta sintaxis indica que los parámetros de mes (mm) y día (dd) son
opcionales, pero que se necesita el parámetro de año de dos dígitos
(aa) o de cuatro dígitos (aaaa) para configurar una fecha.
eficompress archivo-de-entrada Escriba eficompress seguido del nombre del archivo de entrada sin
archivo-resultante
comprimir como parámetro archivo-de-entrada y especifique el
archivo resultante comprimido como parámetro archivo-resultante.
Autocompletado de línea de comandos
La característica de autocompletado de la línea de comandos simplifica la especificación y
reutilización de comandos. En la tabla siguiente se describen las pulsaciones de teclas de
autocompletado de la línea de comandos.
Tabla 2 Teclas de autocompletado de la línea de comandos
Tecla
Efecto
Flecha arriba
Permite retroceder por la lista de comandos especificados anteriormente.
Flecha abajo
Permite avanzar por la lista de comandos especificados anteriormente.
TAB
Permite completar los nombres de archivo en la línea de comandos. Escriba al menos un carácter y,
a continuación, pulse la tecla TAB para completar el nombre de archivo. Si existe más de una
posibilidad, vuelva a pulsar la tecla TAB para ver todas las posibilidades.
Re Pág
Retrocede una página.
Av Pág
Avanza una página
Comandos del shell personalizados de HP
9
Introducción a UEFI Shell
En esta sección se describe cómo utilizar los comandos básicos de UEFI Shell para lo siguiente:
•
«Control del resultado de los comandos» (página 10)
•
«Visualización de la ayuda de los comandos» (página 13)
•
«Conmutación a un sistema de archivos desde el shell» (página 17)
•
«Uso de los comandos de instalación y configuración comunes» (página 17)
Control del resultado de los comandos
Muchos comandos de UEFI Shell admiten parámetros opcionales para controlar el modo en que
se muestran los resultados en la pantalla. En las secciones siguientes se explican estas opciones
y se muestran ejemplos de su uso.
•
«Limitación de los resultados a una sola pantalla a la vez» (página 10)
•
«Visualización de resultados detallados» (página 11)
•
«Eliminación de la solicitud de confirmación al usuario» (página 12)
Limitación de los resultados a una sola pantalla a la vez
El siguiente ejemplo muestra cómo utilizar la opción –b para limitar el resultado a una sola pantalla
a la vez. Cuando se muestre la primera pantalla, el shell solicitará que realice una de las acciones
siguientes:
10
•
Pulse Intro para continuar con la pantalla siguiente.
•
Pulse la tecla Q para salir de la pantalla.
Referencia de comandos de UEFI Shell
Ejemplo 1 Uso del comando -b para mostrar los resultados en una pantalla a la vez
Shell> devtree -b
Ctrl[03] Fv(6522280D-28F9-4131-ADC4-F40EBFA45864)
Ctrl[04] Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C)
Ctrl[05] Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613)
Ctrl[06] MemoryMapped(0xB,0xFFD40000,0xFFD6FFFF)
Ctrl[07] Fv(5A515240-D1F1-4C58-9590-27B1F0E86827)
Ctrl[08] Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6)
Ctrl[09] Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0)
Ctrl[5F] PciRoot(0x0)
Ctrl[195] PciRoot(0x0)/Pci(0x0,0x0)
Ctrl[196] PciRoot(0x0)/Pci(0x2,0x0)
Ctrl[197] PciRoot(0x0)/Pci(0x2,0x0)/Pci(0x0,0x0)
Ctrl[198] PciRoot(0x0)/Pci(0x2,0x1)
Ctrl[199] PciRoot(0x0)/Pci(0x2,0x2)
Ctrl[19A] PciRoot(0x0)/Pci(0x2,0x3)
Ctrl[19B] PciRoot(0x0)/Pci(0x3,0x0)
Ctrl[19C] PciRoot(0x0)/Pci(0x3,0x1)
Ctrl[19D] PciRoot(0x0)/Pci(0x3,0x2)
Ctrl[19E] PciRoot(0x0)/Pci(0x3,0x3)
Ctrl[19F] PciRoot(0x0)/Pci(0x4,0x0)
Ctrl[1A0] PciRoot(0x0)/Pci(0x4,0x1)
Ctrl[1A1] PciRoot(0x0)/Pci(0x4,0x2)
Ctrl[1A2] PciRoot(0x0)/Pci(0x4,0x3)
Ctrl[1A3] PciRoot(0x0)/Pci(0x4,0x4)
Ctrl[1A4] PciRoot(0x0)/Pci(0x4,0x5)
Ctrl[1A5] PciRoot(0x0)/Pci(0x4,0x6)
Ctrl[1A6] PciRoot(0x0)/Pci(0x4,0x7)
Ctrl[1A7] PciRoot(0x0)/Pci(0x5,0x0)
Ctrl[1A8] PciRoot(0x0)/Pci(0x5,0x1)
Ctrl[1A9] PciRoot(0x0)/Pci(0x5,0x2)
Ctrl[1AA] PciRoot(0x0)/Pci(0x5,0x4)
Press ENTER to continue or 'Q' break:
Para ver un ejemplo de uso de esta opción con el comando help, consulte el Ejemplo 5
(página 14).
Activación o desactivación de saltos de página globales
Utilice el comando pagebreak para activar o desactivar la paginación de los resultados de forma
global Este comando crea una variable de entorno UEFI que se retiene hasta el siguiente reinicio
del servidor.
Ejemplos
Para habilitar los saltos de página globales, haga lo siguiente:
fs0:\> set -v pagebreak 1
Para deshabilitar los saltos de página globales, haga lo siguiente:
fs0:\> set -v pagebreak 0
Visualización de resultados detallados
Utilice la opción –v para mostrar los resultados detallados (modo detallado) de determinados
comandos. Entre los comandos del shell que admiten esta opción se incluyen los siguientes:
•
dh
•
help
•
map
Introducción a UEFI Shell
11
A continuación se ofrece un ejemplo de cómo mostrar los resultados detallados del comando dh
(identificador de dispositivo) en una sola pantalla a la vez.
Ejemplo 2 Uso del comando -v para mostrar resultados detallados
Shell> dh -v -b
01: LoadedImage
02: Decompress
03: UnknownDevice DevicePath Fv(6522280D-28F9-4131-ADC4-F40EBFA45864) UnknownDevice
04: UnknownDevice DevicePath Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C) UnknownDevice
05: UnknownDevice DevicePath Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613) UnknownDevice
06: UnknownDevice DevicePath Fv(29A72E80-7BFE-4101-8459-AB5B3EFA4271) UnknownDevice
07: UnknownDevice DevicePath Fv(5A515240-D1F1-4C58-9590-27B1F0E86827) UnknownDevice
08: UnknownDevice DevicePath Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6) UnknownDevice
09: UnknownDevice DevicePath Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0) UnknownDevice
0A: UnknownDevice UnknownDevice
0B: ImageDevicePath LoadedImage
0C: UnknownDevice Pcd
0D: ImageDevicePath LoadedImage
0E: UnknownDevice UnknownDevice
0F: ImageDevicePath LoadedImage
10: UnknownDevice ImageDevicePath LoadedImage
11: UnknownDevice UnknownDevice UnknownDevice ImageDevicePath LoadedImage
12: ImageDevicePath LoadedImage
13: UnknownDevice
14: UnknownDevice ImageDevicePath LoadedImage
15: UnknownDevice
16: UnknownDevice
17: ImageDevicePath LoadedImage
18: ImageDevicePath LoadedImage
19: UnknownDevice ImageDevicePath LoadedImage
1A: ImageDevicePath LoadedImage
1B: UnknownDevice
1C: ImageDevicePath LoadedImage
1D: UnknownDevice
Press ENTER to continue or 'Q' break:
Visualización de un resumen de los resultados
Utilice la opción –t para mostrar un resumen de los resultados (modo simplificado) de determinados
comandos. Entre los comandos del shell que admiten esta opción se incluyen los siguientes:
•
ver
El ejemplo siguiente muestra cómo utilizar el comando ver para mostrar información detallada
de la versión de UEFI y cómo utilizar la opción -t para mostrar un resumen.
Ejemplo 3 Uso de la opción -t para mostrar un resumen de los resultados
Shell> ver
HP Embedded UEFI Shell v2.1
(C) Copyright 1982 - 2015 Hewlett-Packard Development Company, L.P.
UEFI v2.40 (HP, 0x00010007)
ProLiant System BIOS U02 v1.00 (07/09/2015)
Shell> ver -t
HP Embedded UEFI Shell v2.1
Eliminación de la solicitud de confirmación al usuario
Utilice la opción –q para ejecutar determinados comandos en modo silencioso sin que se muestren
solicitudes de confirmación. Entre los comandos del shell que admiten esta opción se incluyen los
siguientes:
12
•
cp
•
rm/del
Referencia de comandos de UEFI Shell
El ejemplo siguiente muestra cómo utilizar esta opción con el comando rm para eliminar todos
los directorios temp sin que se muestren solicitudes de confirmación.
Ejemplo 4 Uso de la opción -q para eliminar las solicitudes de confirmación
fs0:\> rm -q test\temp*
removing fs0:\test\temp1\temp1.txt
- [ok]
removing fs0:\test\temp1\boot\nshell.efi
- [ok]
removing fs0:\test\temp1\boot
- [ok]
removing fs0:\test\temp1
- [ok]
removing fs0:\test\temp2\temp2.txt
- [ok]
removing fs0:\test\temp2
- [ok]
Visualización de la ayuda de los comandos
Existen varias opciones de comandos con las que se puede mostrar la ayuda detallada y resumida
de uno o varios comandos.
•
«Visualización de la ayuda de todos los comandos» (página 13)
•
«Visualización de la ayuda de un comando específico» (página 14)
•
«Visualización de todo el contenido de ayuda para los comandos que empiezan por un
carácter específico» (página 15)
Visualización de la ayuda de todos los comandos
A continuación se ofrece un ejemplo de cómo mostrar la ayuda de todos los comandos en una
pantalla a la vez:
Introducción a UEFI Shell
13
Ejemplo 5 Visualización de la ayuda de todos los comandos en una pantalla a la vez
Shell> help –b
alias
- Displays, creates, or deletes UEFI Shell aliases.
attrib
- Displays or changes the attributes of files or directories.
boot
- Boots or displays boot options.
cd
- Displays or changes the current directory.
cls
- Clears standard output and optionally changes background color.
comp
- Compares the contents of two files on a byte for byte basis.
compress
- Compresses and decompresses files to and from zip files using MiniZip.
connect
- Binds a driver to a specific device and starts the driver.
cp
- Copies one or more files or directories to another location.
date
- Displays and sets the current date for the system.
devices
- Displays the list of devices managed by UEFI drivers.
devtree
- Displays the UEFI Driver Model compliant device tree.
dh
- Displays the device handles in the UEFI environment.
dmem
- Displays the contents of system or device memory.
drivers
- Displays the UEFI driver list.
echo
- Controls script file command echoing or displays a message.
edit
- Displays a full screen editor for ASCII or UCS-2 files.
eficompress
- Compresses a file using UEFI Compression Algorithm.
efidecompress - Decompresses a file using UEFI Decompression Algorithm.
else
- Identifies the code executed when 'if' is FALSE.
endfor
- Ends a 'for' loop.
endif
- Ends the block of a script controlled by an 'if' statement.
exit
- Exits the UEFI Shell or the current script.
for
- Starts a loop based on 'for' syntax.
fwupdate
- Invokes an HP UEFI Shell utility used to update System BIOS firmware.
Press ENTER to continue or 'Q' break:
Visualización de la ayuda de un comando específico
Utilice cualquiera de las siguientes opciones de sintaxis para mostrar la ayuda de un comando
específico:
•
help nombre-del-comando
•
? nombre-del-comando
•
nombre-del-comando-?
A continuación se ofrece un ejemplo de cómo mostrar la ayuda del comando ls (una pantalla a
la vez).
14
Referencia de comandos de UEFI Shell
Ejemplo 6 Visualización de la ayuda del comando ls
Shell> help ls -b
Lists a directory's contents or file information.
LS [-r] [-a[attrib]][-sfo][file]format:
-r
- Displays recursively (including subdirectories)
-a
- Display only those files with the attributes of type attrib. If no
attributes are listed, all files will be listed. If -a is not
specified, all non-system and non-hidden files will be listed.
-sfo
- Display information in Standard-Format Output.
attrib - File attribute list:
a - Archive
s - System
h - Hidden
r - Read-only
d - Directory
file
- Name of file or directory (wildcards are permitted)
NOTES:
1. This command lists directory contents or file information. If no file
name or directory name is specified, the current working directory
is assumed.
2. The contents of a directory are listed if all of the following are true:
- If option -r is not specified
- If no wildcard characters are specified in the file parameter
- If file represents an existing directory
3. In all other cases, the command functions as follows:
- All files/directories that match the specified name are displayed.
- The -r flag determines whether a recursive search is performed.
- The option flag -a[attrib] tells the command to display only those
files with the attributes that are specified by [attrib].
Para obtener más detalles sobre la utilización del comando help, consulte «help» (página 37).
Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácter
específico
Utilice un carácter comodín (*) para mostrar la ayuda de todos los comandos que empiecen por
un carácter específico. En el ejemplo siguiente se indica cómo mostrar la ayuda de todos los
comandos que empiezan por el carácter a.
Introducción a UEFI Shell
15
Ejemplo 7 Visualización de la ayuda de los comandos que empiezan por la letra a
Shell> help a*
Displays, creates, or deletes UEFI Shell aliases.
ALIAS [-d|-v] [alias-name] [command-name]m all files with extension '.inf':
fs0:\> attrib -r *.inf
-d
- Delete an alias. command-name must not be specified.
-v
- Make the alias volatile.
alias-name
- Alias name
command-name - Original command's name or path.
NOTES:
1. This command displays, creates, or deletes aliases in the UEFI Shell
environment.
2. An alias provides a new name for an existing UEFI Shell
command or UEFI application. Once the alias is created, it can be used
to run the command or launch the UEFI application.
3. There are some aliases that are predefined in the UEFI Shell environment.
These aliases provide the MS-DOS and UNIX equivalent names for the file
manipulation commands.
4. Aliases will be retained even after exiting the shell unless the -v option
is specified. If -v is specified the alias will not be valid after
leaving the shell.
EXAMPLES:
* To display all aliases in the UEFI Shell environment:
Shell> alias
* To create an alias in the UEFI Shell environment:
Shell> alias shutdown "reset -s"
* To delete an alias in the UEFI Shell environment:
Shell> alias -d shutdown
Displays or changes the attributes of files or directories.
ATTRIB [+a|-a] [+s|-s] [+h|-h] [+r|-r] [file...] [directory...]
+a|-a
+s|-s
+h|-h
+r|-r
file
directory
-
Set or clear the 'archive' attribute
Set or clear the 'system' attribute
Set or clear the 'hidden' attribute
Set or clear the 'read-only' attribute
File name (wild cards are permitted)
Directory name (wildcards are permitted)
NOTES:
1. Four attribute types are supported in the UEFI file system:
- Archive [A]
- System [S]
- Hidden [H]
- Read only [R]
2. If a file (in general meaning) is a directory, it is also shown
to have the attribute [D].
3. If any file in the file list that is specified in the command line
does not exist, attrib will continue processing the remaining files
while reporting the error.
4. If no attributes parameters are specified, the current attributes of
the specified files or directories will be displayed.
5. If no files or directories are specified, the command applies to
all files and sub-directories within the current directory.
EXAMPLES:
* To display the attributes of a directory:
Shell> :\> attrib fs0:\
* To display the attributes of all files and sub-directories in the current
directory:
fs0:\> attrib *
* To add the system attribute to all files with extension '.efi':
16
Referencia de comandos de UEFI Shell
fs0:\> attrib +s *.efi
* To remove the read only attribute from all files with extension '.inf':
fs0:\> attrib -r *.inf
Conmutación a un sistema de archivos desde el shell
Conmute a un sistema de archivos desde el shell antes de ejecutar comandos que requieran la
entrada o salida de archivos.
Para conmutar a un sistema de archivos, haga lo siguiente:
1. Si utiliza una unidad de disco duro, una unidad USB o una unidad USB iLO virtual, conecte
un sistema de archivos con formato FAT16 o FAT32.
2. Utilice el comando map –r para actualizar las asignaciones del sistema de archivos. Consulte
«map» (página 42).
3. Escriba el comando de uno de los sistemas de archivos fsx disponibles como, por ejemplo,
fs0 o fs1 y, a continuación, pulse la tecla Intro.
El símbolo del sistema cambia a fsx>, donde la x representa el número del sistema de
archivos seleccionado.
De este modo, podrá tener acceso a los archivos de escritura del sistema de archivos especificado
y modificarlos.
El ejemplo siguiente muestra cómo tener acceso al sistema de archivos fs0 desde el shell.
Ejemplo 8 Acceso al sistema de archivos fs0 desde el shell
Shell> map -r
Shell>fs0:
fs0:\>
NOTA: Los ejemplos de resultados de esta guía utilizan el símbolo del sistema fs0:\> para
mostrar la ubicación de acceso al sistema de archivos desde el shell.
Uso de los comandos de instalación y configuración comunes
Pregunta
Respuesta
¿Cómo entro en Embedded UEFI Shell?
Consulte «Acceso a Embedded UEFI Shell» (página 5).
¿Cómo actualizo el firmware o la memoria ROM del
sistema?
Como parte del sistema HP Moonshot, las actualizaciones
de firmware pueden instalarse de diversas formas,
incluyendo el uso de:
• La interfaz web de HP Moonshot
• La CLI de HP Moonshot CLI
• HP SUM
Para obtener más información, consulte los documentos
siguientes disponibles en la página web de la Biblioteca
de información de HP en http://www.hp.com/go/
moonshot/docs:
• Guía de usuario de la interfaz web de HP Moonshot
iLO Chassis Management
• Guía de usuario de la CLI de HP Moonshot iLO Chassis
Management
• Guía de actualización de HP Moonshot Component
Pack
¿Cómo configuro la zona horaria?
Consulte «timezone» (página 55).
Introducción a UEFI Shell
17
Pregunta
Respuesta
¿Cómo restablezco una o todas las asignaciones entre los Consulte «map» (página 42).
nombres definidos por el usuario y los identificadores de
dispositivos?
¿Cómo puedo mostrar todos los dispositivos compatibles
con el modelo de controlador de UEFI?
Consulte «devtree» (página 28).
¿Cómo salgo de Embedded UEFI Shell y vuelvo a las
Utilidades del sistema?
Consulte «exit» (página 35).
Comandos de UEFI Shell
Esta sección enumera los comandos de UEFI Shell por orden alfabético. En la tabla siguiente se
describen los componentes de la sección donde se explica cada comando.
Tabla 3 Componentes de la lista de comandos del shell
Sección
Descripción
Nombre del comando y línea de resumen
Nombre del comando seguido de una breve descripción
de cómo se utiliza.
Sintaxis
Sintaxis del comando, incluidos los parámetros obligatorios
y opcionales.
Opciones
Descripción de los parámetros de sintaxis y las variables.
Instrucciones de uso
Descripción detallada del uso del comando.
Ejemplos
Uno o varios ejemplos del uso del comando.
NOTA: Los elementos que debe especificar el usuario
se muestran en negrita en los ejemplos de uso de los
comandos.
Detalles de los resultados
Descripciones de los campos mostrados por el comando,
si procede.
alias
Permite mostrar, crear o eliminar alias en el entorno de UEFI Shell.
Sintaxis
alias [ -d | -v ] [nombre-de-alias] [nombre-de-comando]
Instrucciones de uso
Los alias permiten proporcionar un nuevo nombre para una aplicación UEFI o un comando de
UEFI Shell existente. Una vez creado el alias, puede utilizarse para ejecutar el comando o iniciar
la aplicación UEFI.
El entorno de UEFI Shell cuenta con algunos alias predefinidos. Estos alias proporcionan nombres
equivalentes de MS-DOS y UNIX para los comandos de manipulación de archivos.
Los alias se conservan incluso después de salir del shell a menos que se especifique la opción –v.
Si se especifica la opción -v, el alias dejará de ser válido tras salir del shell.
Ejemplos
Para mostrar todos los alias en el entorno de UEFI Shell:
Shell> alias
md : mkdir
rd : rm
myguid : guid
18
Referencia de comandos de UEFI Shell
Para crear un alias en el entorno de UEFI Shell:
Shell> alias myguid guid
Shell> alias
md : mkdir
rd : rm
myguid : guid
Para eliminar un alias del entorno de UEFI Shell:
Shell> alias -d myguid
Shell> alias
md : mkdir
rd : rm
Para agregar un alias volátil al entorno UEFI actual, identificado con un asterisco * al principio
de la línea. Este alias volátil desaparecerá en el siguiente arranque:
Shell> alias -v fs0 floppy
Shell> alias
md : mkdir
rd : rm
* fs0 : floppy
attrib
Permite mostrar, establecer o modificar los atributos de archivos o directorios.
Sintaxis
attrib [ +a | -a ] [ +s | -s ] [ +h | -h ] [ +r | -r ] [archivo...]
[directorio...]
Opciones
[ +a | -a ]
Establece o borra el atributo archivo.
[ +s | -s ]
Establece o borra el atributo system.
[ +h | -h ]
Establece o borra el atributo oculto.
[ +r | -r ]
Establece o borra el atributo solo-lectura.
archivo...
Especifica el nombre del archivo. Este comando admite el uso de caracteres
comodín.
directorio...
Especifica el nombre del directorio. Este comando admite el uso de caracteres
comodín.
Instrucciones de uso
El sistema de archivos UEFI admite los cuatro tipos de atributos siguientes:
•
Archivo: A
•
Sistema: S
•
Oculto: H
•
Solo lectura: R
Si un archivo es un directorio también mostrará el atributo D.
Si no existe alguno de los archivos de la lista especificado en la línea de comandos, attrib
seguirá procesando los archivos restantes e informará del error detectado.
Si no se especifica ningún archivo o directorio, se mostrarán todos los archivos del directorio
actual.
Si no se especifica ningún atributo, se mostrarán los atributos de los archivos.
Comandos de UEFI Shell
19
Ejemplos
Para mostrar los atributos de un directorio:
fs0:\> attrib fs0:\
attrib: D fs0:\
Para mostrar los atributos de todos los archivos y subdirectorios del directorio actual:
fs0:\> attrib *
\attrib: AS fs0:\serial.efi
attrib: DA fs0:\test1
attrib: A HR fs0:\bios.inf
attrib: A fs0:\VerboseHelp.txt
attrib: AS fs0:\IsaBus.efi
Para agregar el atributo system a todos los archivos que tengan la extensión .efi:
fs0:\> attrib +s *.efi
Para quitar el atributo read-only de todos los archivos que tengan la extensión .inf:
fs0:\> attrib -r *.inf
\attrib: A H fs0:\bios.inf
bcfg
Gestiona las opciones de arranque y de controladores.
boot
Arranca o muestra las opciones de arranque de UEFI.
Sintaxis
boot [[-d[-sfo]] | [-n núm] | -all | -pxe ] [r]
Opciones
-d
Muestra las opciones de arranque de UEFI por orden.
-n
Arranca con una opción de arranque de UEFI específica.
núm
Especifica un número de opción para arrancar. Este es un valor hexadecimal de cuatro
dígitos para cada opción.
-all
Intenta arrancar con todas las opciones de arranque de UEFI por orden.
-pxe
Intenta arrancar con todas las opciones de arranque de UEFI PXE por orden.
-r
Actualiza las opciones de arranque de UEFI.
-sfo
Muestra la información de los resultados en formato estándar.
NOTA: Consulte la Guía de usuario de la CLI de HP Moonshot iLO Chassis Management para
obtener más información. El origen y el orden de arranque del cartucho de servidor HP ProLiant
solo se puede establecer mediante el uso de comandos en la línea de comandos de iLO Chassis
Management.
Instrucciones de uso
Este comando no puede mostrar ni arrancar con las opciones de arranque del BIOS heredado.
Puede utilizarlo para configurar una transición sin problemas desde un destino de arranque UEFI
a otro (por ejemplo, una imagen de sistema operativo descargada) sin necesidad de reiniciar el
sistema.
20
Referencia de comandos de UEFI Shell
Ejemplos
Para que se muestren las opciones de arranque de UEFI por orden:
Shell> boot -d
Para actualizar las opciones de arranque en la lista Boot Order (Orden de arranque) y permitir
la activación de los dispositivos agregados o quitados recientemente:
Shell> boot -r
Para actualizar las opciones de arranque y, a continuación, mostrar todas las opciones de arranque
de UEFI por orden:
Shell> boot -r –d
Para arrancar con las opciones de arranque de UEFI por orden:
Shell> boot -all
Para arrancar con las opciones de arranque de UEFI PXE por orden:
Shell> boot -pxe
Para arrancar desde la opción de arranque de UEFI con el número 0004:
Shell> boot -n 0004
cd
Permite mostrar o modificar el directorio actual.
Sintaxis
cd [ruta]
Opciones
ruta
Especifica la ruta del directorio relativa o absoluta.
Instrucciones de uso
Si se especifica una asignación de sistema de archivos, se cambiará el directorio de trabajo actual
para dicho dispositivo. En caso contrario, se cambiará el directorio de trabajo actual para el
dispositivo actual.
Si no se indica la ruta, el directorio de trabajo actual (incluida la asignación de sistema de
archivos) se mostrará como resultado estándar.
En la tabla siguiente se describen las convenciones que se utilizan para hacer referencia a un
directorio, a su directorio principal y al directorio raíz en el entorno de UEFI Shell.
Tabla 4 Convenciones de nombre de directorio
Convención
Descripción
.
Directorio actual.
. .
Directorio principal del directorio actual.
\
Directorio raíz del sistema de archivos actual.
El directorio de trabajo actual se mantiene en la variable de entorno %cwd%.
Ejemplos
Para cambiar el sistema de archivos actual al sistema de archivos fs0 asignado:
Shell> fs0:
Para cambiar del directorio actual al subdirectorio efi:
fs0:\> cd efi
Para cambiar del directorio actual al directorio principal (fs0:\):
Comandos de UEFI Shell
21
fs0:\efi\> cd ..
Para cambiar del directorio actual a fs0:\efi\tools:
fs0:\> cd efi\tools
Para cambiar del directorio actual a la raíz del sistema fs actual (fs0):
fs0:\efi\tools\> cd \
fs0:\>
NOTA:
No es posible cambiar de volumen con el comando cd. Por ejemplo:
fs0:\efi\tools\> cd fs1:\
En primer lugar escriba fs1: y, a continuación, utilice el comando cd para ir al directorio que
desee.
Para desplazarse entre volúmenes y mantener la ruta actual:
fs0:\> cd \efi\tools
fs0:\efi\tools\> fs1:
fs1:\> cd tmp
fs1:\tmp> cp fs0:*.* .
Este comando copia todos los archivos de fs0:\efi\tools en el directorio fs1:\tmp.
cls
Permite borrar el resultado estándar y cambiar el color de fondo.
Sintaxis
cls [color]
Opciones
color
Especifica un nuevo color de fondo mediante las opciones siguientes:
0: negro
1: azul
2: verde
3: cian
4: rojo
5: magenta
6: amarillo
7: gris claro
Instrucciones de uso
Si no se especifica el color, el color de fondo no cambiará.
Ejemplos
Para borrar la pantalla de resultados estándar sin cambiar el color de fondo:
fs0:\> cls
Para borrar la pantalla de resultados estándar y cambiar el color de fondo a cian:
fs0:\> cls 3
Para borrar la pantalla de resultados estándar y cambiar el color de fondo al color predeterminado:
fs0:\> cls 0
22
Referencia de comandos de UEFI Shell
comp
Permite comparar el contenido de dos archivos byte por byte.
Sintaxis
comp [-b] archivo1 archivo2
Opciones
-b
Muestra una pantalla a la vez.
archivo1
Especifica el nombre del primer archivo. No es posible especificar nombres de
directorio ni caracteres comodín.
archivo2
Especifica el nombre del segundo archivo. No es posible especificar nombres de
directorio ni caracteres comodín.
Instrucciones de uso
Este comando muestra hasta 10 diferencias entre los dos archivos. Para cada diferencia, se
volcarán hasta 32 bytes desde la ubicación en la que se inicia la diferencia. UEFI Shell se cerrará
de inmediato si las longitudes de los archivos comparados son distintas.
Ejemplos
Para comparar dos archivos con longitudes diferentes:
fs0:\> comp bios.inf legacy.inf
Compare fs0:\bios.inf to fs0:\legacy.inf
Difference #1: File sizes mismatch
[difference(s) encountered]
Para comparar dos archivos con el mismo contenido:
fs0:\> comp bios.inf rafter.inf
Compare fs0:\bios.inf to fs0:\rafter.inf
[no difference encountered]
Para comparar dos archivos con la misma longitud pero cuyo contenido es diferente:
fs0:\> comp bios.inf bios2.inf
Compare fs0:\bios.inf to fs0:\bios2.inf
Difference #1:
File1: fs0:\bios.inf
00000000: 5F
*_*
File2: fs0:\bios2.inf
00000000: 33
*3*
Difference #2:
File1: fs0:\bios.inf
0000000C: 00 00 00 00
*....*
File2: fs0:\bios2.inf
0000000C: 25 32 03 03
*%2..*
[difference(s) encountered]
connect
Enlaza un controlador a un dispositivo específico e inicia el controlador.
Sintaxis
connect [[identificador-dispositivo] [identificador-controlador] | [-c]
| [-r] ]
Opciones
identificador-dispositivo
Especifica un identificador de dispositivo en formato
hexadecimal.
Comandos de UEFI Shell
23
identificador-controlador
Especifica un identificador de controlador en formato
hexadecimal.
-c
Conecta solo los dispositivos de consola que se describen
en las variables de entorno de UEFI Shell y los dispositivos
relacionados.
-r
Se conectan los dispositivos de consola de forma recursiva.
Instrucciones de uso
Si no se especifica un identificador-dispositivo, todos los identificadores de dispositivos
del sistema actual tendrán los valores predeterminados.
Si no se especifica identificador-controlador, todos los controladores no coincidentes se
enlazan con el dispositivo especificado. Si se especifica identificador-controlador, se
le da la prioridad más alta a la conexión de los dispositivos especificados. Si se especifica la
opción –r, se analizan de forma recursiva todos los identificadores para ver si algún controlador
cargado o integrado coincide con el dispositivo especificado. Asimismo, si se crean más
identificadores de dispositivos durante el enlace, estos también se comprueban para ver si se
puede enlazar un controlador coincidente a los dispositivos especificados. Este proceso se repite
hasta que no queden controladores que se puedan conectar a ningún dispositivo.
Si no se especifica la opción –r, los identificadores de dispositivos recién creados dejan de estar
enlazados a los controladores. Si solo se especifica un identificador único y este tiene un valor
EFI_DRIVER_BINDING_PROTOCOL, se asume que el identificador es un identificador de
controlador. En caso contrario, se da por sentado que se trata de un identificador de dispositivo.
Si no se especifican parámetros, el comando intentará enlazar todos los controladores
correspondientes a todos los dispositivos sin recursión y se muestra el estado de cada conexión.
No se admite el redireccionamiento de salida cuando se usa connect –r.
Ejemplos
Para conectar todos los controladores a todos los dispositivos de forma recursiva:
Shell> connect -r
Para que se muestren todas las conexiones:
Shell> connect
Para conectar los controladores con 0x17 con la máxima prioridad a todos los dispositivos que
pueden gestionar:
Shell> connect 17
Para conectar todos los controladores posibles al dispositivo 0x19:
Shell> connect 19
Para conectar los controladores con 0x17 con la máxima prioridad al dispositivo 0x19:
Shell> connect 19 17
Para conectar los dispositivos de consola descritos en las variables de entorno de UEFI Shell:
Shell> connect -c
cp
Permite copiar uno o varios archivos de origen o directorios en un destino.
Sintaxis
cp [-r] [-q] orig orig... [dest]
Opciones
-r
24
Crea una copia de forma recursiva.
Referencia de comandos de UEFI Shell
-q
Crea una copia de forma silenciosa (sin mostrar solicitudes de confirmación).
orig orig...
Especifica un archivo de origen o nombre de directorio. Este comando admite
el uso de caracteres comodín.
dest
Especifica un nombre de archivo o directorio de destino. Este comando no
admite el uso de caracteres comodín. Si no se especifica, se asumirá que el
directorio de trabajo actual es el de destino. Si se especifica más de un
directorio, se asumirá que el último directorio es el de destino.
Instrucciones de uso
Si el origen es un directorio, deberá especificar el indicador -r. Si se especifica el indicador -r,
el directorio de origen se copiará de forma recursiva al destino (lo que significa que se copiarán
todos los subdirectorios). Si no se especifica ningún destino, se asumirá que el destino es el
directorio de trabajo actual.
Si ya existe alguno de los archivos de destino (no un directorio), se mostrará un mensaje para
confirmar la sustitución de los archivos. Se encuentran disponibles las siguientes opciones:
•
Yes (Sí): sustituye el archivo.
•
No: no sustituye el archivo.
•
All (Todos): sustituye todos los archivos existentes que encuentre.
•
Cancel (Cancelar): no sustituye ninguno de los archivos existentes que encuentre.
Si hay varios archivos o directorios de origen, el destino debe ser un directorio.
Si se produce un error, el proceso de copia se detendrá de inmediato.
Si la ejecución se realiza en una secuencia de comandos, el valor predeterminado es –q.
El directorio debe existir al copiar en otro directorio.
Ejemplos
Para mostrar el contenido del directorio actual:
fs0:\> ls
Directory of: fs0:\
06/18/01 01:02p <DIR> 512
06/18/01 01:02p <DIR> 512
test1
06/18/01 01:02p <DIR> 512
test2
06/13/01 10:00a 28,739
IsaBus.efi
06/13/01 10:00a 32,838
IsaSerial.efi
06/18/01 08:04p 29
temp.txt
06/18/01 08:05p <DIR> 512
test
3 File(s) 61,606 bytes
4 Dir(s)
efi
Para copiar un archivo en el mismo directorio con otro nombre:
fs0:\> cp temp.txt readme.txt
copying fs0:\temp.txt -> fs0:\readme.txt
- [ok]
Para copiar varios archivos en otro directorio:
fs0:\> cp temp.txt isaBus.efi \test
copying fs0:\temp.txt -> fs0:\test\temp.txt
- [ok]
copying fs0:\isaBus.efi -> fs0:\test\IsaBus.efi
- [ok]
Para copiar varios directorios de forma recursiva en otro directorio:
fs0:\> cp -r test1 test2 boot \test
copying fs0:\test1 -> fs0:\test\test1
copying fs0:\test1\test1.txt -> fs0:\test\test1\test1.txt
- [ok]
copying fs0:\test2 -> fs0:\test\test2
Comandos de UEFI Shell
25
copying fs0:\test2\test2.txt -> fs0:\test\test2\test2.txt
- [ok]
copying fs0:\boot -> fs0:\test\boot
copying fs0:\boot\shell.efi -> fs0:\test\boot\shell.efi
- [ok]
Para ver los resultados de las operaciones anteriores:
fs0:\> ls \test
Directory of: fs0:\test 06/18/01 01:01p <DIR>
06/18/01 01:01p <DIR>
0
..
01/28/01 08:21p <DIR>
512
test1
01/28/01 08:21p <DIR>
512
test2
01/28/01 08:21p <DIR>
512
boot
01/28/01 08:23p
29
temp.txt
01/28/01 08:23p
28,739
IsaBus.efi
2 File(s)
28,828 bytes
5 Dir(s)
Shell>
512
.
date
Permite mostrar o establecer la fecha actual del sistema.
Sintaxis
date [mm/dd/ { aa | aaaa }] [-sfo]
Opciones
mm
Especifica el mes de la fecha que se va a establecer (1-12).
dd
Especifica el día de la fecha que se va a establecer (1-31).
aa
Especifica el año de la fecha con dos dígitos.
aaaa
Especifica el año de la fecha con cuatro dígitos.
-sfo
Especifica que los resultados se muestren en formato estándar.
Instrucciones de uso
Si no se especifican parámetros, se muestra la fecha actual. La fecha del sistema se actualizará
si se especifican valores válidos de día, mes y año. Las reglas son las siguientes:
•
A excepción de los caracteres numéricos y de la barra (/), todos los demás caracteres del
argumento no son válidos. El shell mostrará un error si el número se encuentra en el rango
incorrecto de mes/día/año.
•
No se pueden usar espacios antes o después del carácter numérico. No es posible insertar
espacios en el número.
•
El intervalo de años es mayor o igual a 1998. Dos caracteres numéricos indican el año. Los
números menores que 98 se considerarán como 20xx y los números iguales o mayores que
98 se considerarán como 19xx. 00 equivale a 2000. Por ejemplo:
Shell> date 8/4/97
Shell> date
8/04/2097
Shell>
Shell> date 8/4/98
Shell> date
08/04/1998
Shell>
El intervalo de años válidos es de 1998 a 2099.
26
Referencia de comandos de UEFI Shell
Ejemplos
Para mostrar la fecha actual en el sistema:
fs0:\> date
06/18/2001
Para establecer la fecha con formato largo de año y mostrarla:
fs0:\> date 01/01/2050
fs0:\> date
01/01/2050
Para establecer la fecha con formato corto de año y mostrarla:
fs0:\> date 06/18/01
fs0:\> date
06/18/2001
dblk
Permite mostrar uno o varios bloques desde un dispositivo de bloques.
Sintaxis
dblk dispositivo [lba] [bloques] [-b]
Opciones
-b
Permite mostrar una pantalla a la vez.
dispositivo
Nombre del dispositivo de bloques.
lba
Índice del primer bloque que se debe mostrar (número hexadecimal).
bloques
Número de bloques que se deben mostrar (número hexadecimal). El valor
predeterminado es 1. Si es mayor que 0x10, se mostrarán solo 0x10.
Ejemplos
Para mostrar un bloque de blk0 que comience desde el bloque 0:
fs0:\> dblk blk0
Para mostrar un bloque de fs0 que comience desde 0x2:
fs0:\> dblk fs0 2
Para mostrar 0x5 bloques de fs0, comenzando por el bloque 0x12:
fs0:\> dblk fs0 12 5
devices
Permite mostrar una lista de dispositivos gestionados mediante los controladores de UEFI.
Sintaxis
devices [-b] [-lxxx] [-sfo]
Opciones
-b
Muestra una pantalla a la vez.
-lxxx
Muestra los dispositivos en un idioma específico. Para obtener una lista de las opciones
de código posibles, consulte la Especificación de UEFI.
-sfo
Muestra la información de los resultados en formato estándar.
Ejemplo
Para mostrar todos los dispositivos compatibles con el modelo de controlador de UEFI:
Comandos de UEFI Shell
27
Shell>
C
T
T
Y
R
P
L
E
== =
20 R
3D D
3E D
64 B
65 B
66 B
67 B
68 B
69 D
6E D
6F D
70 D
71 D
72 D
devices
D
C I
F A
G G #P
= = ==
- - - - 3
- - 3
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
#D
==
1
6
6
1
1
4
-
#C
==
13
2
2
1
1
2
-
Device Name
=============================================================
VenHw(58C518B1-76F3-11D4-BCEA-0080C73C8881)
Primary Console Input Device
Primary Console Output Device
UGA Window 1
UGA Window 2"
EFI_WIN_NT_SERIAL_PORT=COM1
COM1
PC-ANSI Serial Console
EFI_WIN_NT_SERIAL_PORT=COM2
EFI_WIN_NT_PHYSICAL_DISKS=e:RW;262144;512
EFI_WIN_NT_CPU_MODEL=Intel(R) Processor Model
EFI_WIN_NT_CPU_SPEED=3000
EFI_MEMORY_SIZE=64
EFI_MEMORY_SIZE=64
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 5 Detalles de los resultados del comando devices
Columna
Descripción
CTRL
Número de identificador del dispositivo.
TYPE
Tipo de dispositivo. Las opciones disponibles son las siguientes:
• R: controladora raíz
• B: controladora de bus
• D: controladora de dispositivo
CFG
Estado de soporte del protocolo de configuración:
• Y: sí
• N: no
DIAG
Estado de soporte del protocolo de diagnóstico:
• Y: sí
• N: no
#P
Número de controladoras principales de este dispositivo.
#D
Número de dispositivos de este tipo.
#C
Número de controladoras secundarias generadas por este dispositivo.
Device Name
Nombre del dispositivo según el protocolo de nombres de componentes.
devtree
Permite mostrar el árbol de dispositivos compatibles con el modelo del controlador de UEFI.
Sintaxis
devtree [-b] [-d] [-lxxx] [identificador-de-dispositivo]
Opciones
28
-b
Muestra una pantalla a la vez.
-d
Muestra el árbol de dispositivos con las rutas de dispositivo.
Referencia de comandos de UEFI Shell
Muestra el árbol de dispositivos en un idioma específico.
Para obtener una lista de las opciones de código posibles,
consulte la Especificación de UEFI.
-lxxx
identificador-de-dispositivo Muestra el árbol de dispositivos pertenecientes a un
identificador especificado.
Instrucciones de uso
De forma predeterminada, los nombres de dispositivo se recuperan del protocolo de nombres de
componentes. Si se especifica la opción –d, en su lugar se muestran las rutas de los dispositivos.
Ejemplo
Para mostrar el árbol de todos los dispositivos compatibles con el modelo de controlador de UEFI
en una pantalla a la vez:
Shell> devtree -b
devtree -b fs0:\
Ctrl[04] Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C)
Ctrl[05] Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613)-directories in the current
Ctrl[06] MemoryMapped(0xB,0xFFD40000,0xFFD6FFFF)
Ctrl[07] Fv(5A515240-D1F1-4C58-9590-27B1F0E86827)
Ctrl[08] Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6)
Ctrl[09] Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0)extension '.efi':
Ctrl[5F] PciRoot(0x0).efi
Ctrl[195] PciRoot(0x0)/Pci(0x0,0x0)
Ctrl[196] PciRoot(0x0)/Pci(0x2,0x0)from all files with extension '.inf':
Ctrl[197] PciRoot(0x0)/Pci(0x2,0x0)/Pci(0x0,0x0)
Ctrl[198] PciRoot(0x0)/Pci(0x2,0x1)
Ctrl[199] PciRoot(0x0)/Pci(0x2,0x2)
Ctrl[19A] PciRoot(0x0)/Pci(0x2,0x3)
Ctrl[19B] PciRoot(0x0)/Pci(0x3,0x0)
Ctrl[19C] PciRoot(0x0)/Pci(0x3,0x1)
Ctrl[19D] PciRoot(0x0)/Pci(0x3,0x2)
Ctrl[19E] PciRoot(0x0)/Pci(0x3,0x3)
Ctrl[19F] PciRoot(0x0)/Pci(0x4,0x0)
Ctrl[1A0] PciRoot(0x0)/Pci(0x4,0x1)
Ctrl[1A1] PciRoot(0x0)/Pci(0x4,0x2)
Ctrl[1A2] PciRoot(0x0)/Pci(0x4,0x3)
Ctrl[1A3] PciRoot(0x0)/Pci(0x4,0x4)
Ctrl[1A4] PciRoot(0x0)/Pci(0x4,0x5)
Ctrl[1A5] PciRoot(0x0)/Pci(0x4,0x6)
Ctrl[1A6] PciRoot(0x0)/Pci(0x4,0x7)
Ctrl[1A7] PciRoot(0x0)/Pci(0x5,0x0)
Ctrl[1A8] PciRoot(0x0)/Pci(0x5,0x1)
Ctrl[1A9] PciRoot(0x0)/Pci(0x5,0x2)
Ctrl[1AA] PciRoot(0x0)/Pci(0x5,0x4)
Ctrl[1AB] PciRoot(0x0)/Pci(0x6,0x7)
Press ENTER to continue or 'Q' break:
dh
Muestra los identificadores de dispositivos del entorno UEFI.
Sintaxis
dh [-lxxx] [ identificador | -p id-prot ] [-d] [-b] [-v] [-sfo]
Opciones
-lxxx
Muestra los identificadores de los dispositivos en un idioma específico. Para
obtener una lista de las opciones de código posibles, consulte la Especificación
de UEFI.
handle
Muestra el identificador de un dispositivo específico.
-p id-prot
Muestra la información del protocolo asociada a los identificadores. Si no se
especifica, se mostrarán todos los protocolos.
Comandos de UEFI Shell
29
-d
Muestra la información relacionada con el modelo del controlador de UEFI.
-b
Muestra una pantalla a la vez.
-v
Muestra información detallada.
-sfo
Muestra la información de los resultados en formato estándar. Consulte Tabla 8
(página 41).
Instrucciones de uso
Si se especifica un número de identificador, se mostrarán los detalles de todos los protocolos
asociados a dicho identificador de dispositivo. En caso contrario, es posible utilizar la opción
-p para mostrar una lista de los identificadores de dispositivos que contengan un protocolo
específico. Si no se especifica la opción -p id-prot ni identificador, se mostrarán todos
los identificadores.
Ejemplos
Para mostrar todos los identificadores en una sola pantalla:
Shell> dh -b
Handle dump
1: Image(DXE Core)
2: FwVol FwFileSys FwVolBlk DevPath(MemMap(11:1B500001D4FFC8))
3: Image(Ebc)
4: DevPath(MemMap(11:1CA0000-1CB0000))
5: Image(WinNtThunk)
6: WinNtThunk DevPath(..76F3-11D4-BCEA-0080C73C8881))
7: Image(WinNtBusDriver) DriverBinding
...
Para mostrar información detallada del identificador 0x30:
Shell> dh 30 -v
Handle 30 (01AF5308)
IsaIo
ROM Size......: 00000000
ROM Location..: 00000000
ISA Resource List :
IO : 000003F8-000003FF Attr : 00000000
INT : 00000004-00000000 Attr : 00000000
dpath
PNP Device Path for PnP
HID A0341D0, UID 0x0
Hardware Device Path for PCI
PNP Device Path for PnP
HID 50141D0, UID 0
AsStr: 'Acpi(PNP0A03,0)/Pci(1F|0)/Acpi(PNP0501,0)'
Para mostrar todos los identificadores asociados al protocolo diskio:
Shell> dh -p diskio
Handle dump by protocol 'Diskio'
15: DiskIo BlkIo DevPath(..i(3|1)/Ata(Secondary,Master))
16: DiskIo BlkIo DevPath(..,1)/PCI(0|0)/Scsi(Pun0,Lun0))
44: DiskIo BlkIo Fs DevPath(..ABD0-01C0-507B-9E5F8078F531)
ESP
45: DiskIo BlkIo Fs DevPath(..i(Pun0,Lun0)/HD(Part4,SigG0))
ESP
17: DiskIo BlkIo DevPath(..PCI(3|1)/Ata(Primary,Master))
Para mostrar todos los identificadores asociados al protocolo Image e insertar un salto cuando
la pantalla esté completa:
Shell> dh -p Image -b
Handle dump by protocol 'image'
30
Referencia de comandos de UEFI Shell
1:
5:
7:
8:
A:
B:
Image(DXE Core)
Image(WinNtThunk)
Image(WinNtBusDriver) DriverBinding
Image(Metronome)
Image(IsaBus) DriverBinding
Image(WinNtConsole) DriverBinding
...
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 6 Detalles de los resultados del comando dh
Columna
Descripción
Driver Name
Nombre del controlador que genera el identificador.
Controller Name
Nombre de la controladora que genera el identificador.
Handle number
Número entero del identificador.
Device Path
Ruta del dispositivo asociado al identificador.
Protocol Identifiers
Lista de los identificadores de protocolo o GUID separada por signos de punto y
coma.
disconnect
Desconecta uno o más controladores de los dispositivos especificados.
Sintaxis
disconnect identificador-dispositivo [identificador-controlador
[identificador-secundario]] [-r]
Opciones
identificador-dispositivo
Especifica un identificador de dispositivo en formato
hexadecimal.
identificador-controlador
Especifica un identificador de controlador en formato
hexadecimal. Si no se especifica, el dispositivo especificado
por identificador-dispositivo se desconecta.
identificador-secundario
Especifica un identificador secundario de un dispositivo en
formato hexadecimal. Si no se especifica, todos los
identificadores secundarios del dispositivo especificado por
identificador-dispositivo se desconectan.
-r
Desconecta todos los controladores de todos los dispositivos.
Instrucciones de uso
Este comando no admite el redireccionamiento del resultado.
Ejemplos
Para desconectar todos los controladores de todos los dispositivos:
Shell> disconnect -r
Para desconectar todos los controladores del dispositivo 0x28:
Shell> disconnect 28
Para desconectar el controlador 0x17 del dispositivo 0x28:
Shell> disconnect 28 17
Comandos de UEFI Shell
31
Para desconectar el controlador 0x17 del identificador secundario 0x32 del dispositivo 0x28:
Shell> disconnect 28 17 32
dmem
Permite mostrar el contenido de la memoria del dispositivo o sistema.
Sintaxis
dmem [-b] [dirección] [tamaño] [-MMIO]
Opciones
-b
Muestra una pantalla a la vez.
dirección
Muestra el contenido de la memoria desde una dirección de inicio específica (en
formato hexadecimal).
tamaño
Muestra la cantidad de bytes especificada del contenido de la memoria (en formato
hexadecimal).
-MMIO
Muestra el contenido asignado de la memoria mediante
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
Instrucciones de uso
Si no se especifica la opción dirección, se mostrará el contenido de la tabla del sistema EFI.
De lo contrario, se mostrará el contenido de la memoria a partir de la dirección especificada.
Si no se especifica la opción tamaño, se mostrarán 512 bytes (el valor predeterminado). Si no
se especifica la opción -MMIO, se mostrará el contenido de la memoria del sistema principal. De
lo contrario, se mostrará el contenido de la memoria del dispositivo mediante
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
Ejemplo
Para mostrar el contenido de la memoria desde 1af3088 con un tamaño de 16 bytes:
Shell> dmem 1af3088 16
Memory Address 0000000001AF3088 16 Bytes
01AF3088: 49 42 49 20 53 59 53 54-00 00 02 00 18 00 00 00 *IBI SYST........*
01AF3098: FF 9E D7 9B 00 00
*......*
drivers
Muestra una lista de información de los controladores que siguen el modelo de controlador de UEFI.
Sintaxis
drivers [-lxxx] [-sfo]
Opciones
-lxxx
Muestra los controladores en un idioma específico. Para obtener una lista de las opciones
de código posibles, consulte la Especificación de UEFI.
-sfo
Muestra el contenido en una tabla de resultados en formato estándar. Consulte Tabla 7
(página 33).
Instrucciones de uso
Para obtener una descripción de los elementos mostrados, consulte la Tabla 7 (página 33).
Ejemplo
Para mostrar la lista de controladores:
32
Referencia de comandos de UEFI Shell
Shell> drivers
T
D
Y C
R
P F
V
VERSION E G
=== ======= = =
39 00000010 D 3A 00000010 D 3B 00000010 B 3C 00000010 ? 3D 00000010 B 3E 00000010 ? 42 00000010 D 43 00000010 ? 44 00000010 D 45 00000010 D 48 00000010 ? 49 00000010 ? 4C 00000010 B 55 00000010 D X
56 00000010 ? 57 00000010 ? 58 00000010 D 59 00000010 B 5F 00000010 D -
D
I
A
G
=
X
-
#D
==
1
1
1
1
1
1
1
1
1
1
1
1
#C
==
1
1
1
3
-
DRIVER NAME
=====================================
Platform Console Management Driver
Platform Console Management Driver
Console Splitter Driver
Console Splitter Driver
Console Splitter Driver
Console Splitter Driver
UGA Console Driver
Serial Terminal Driver
Generic Disk I/O Driver
FAT File System Driver
ISA Bus Driver
ISA Serial Driver
PCI Bus Driver
Windows Block I/O Driver
Windows Text Console Driver
Windows Serial I/O Driver
Windows Simple File System Driver
Windows Bus Driver
Windows Universal Graphics Adapter
IMAGE NAME
==========
ConPlatform
ConPlatform
ConSplitter
ConSplitter
ConSplitter
ConSplitter
GraphicsConsole
Terminal
DiskIo
Fat
IsaBus
IsaSerial
PciBus
WinNtBlockIo
WinNtConsole
WinNtSerialIo
WinNtSimpleFileSystem
WinNtBusDriver
WinNtUga
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 7 Detalles de los resultados del comando drivers
Columna
Descripción
DRV
Identificador entero del controlador.
VERSION
Número de versión del controlador.
TYPE
Tipo de controlador. Los valores posibles son:
• B: controlador de bus
• D: controlador de dispositivo
CFG
Estado de soporte del protocolo de configuración:
• Y: sí
• N: no
DIAG
Estado de soporte del protocolo de controlador:
• Y: sí
• N: no
#D
Número de dispositivos que gestiona este controlador.
#C
Número de dispositivos secundarios que produjo este controlador.
DRIVER NAME
Nombre del controlador según el protocolo de nombres de componentes.
IMAGE NAME
Ruta de dispositivo desde la que se cargó el controlador.
echo
Permite controlar si se muestran los comandos de las secuencias de comandos conforme se van
leyendo del archivo de la secuencia de comandos y muestra el mensaje especificado en la pantalla.
Sintaxis
echo [ -on | -off ]
echo mensaje
Comandos de UEFI Shell
33
Opciones
-on
Habilita la visualización al leer los comandos de los archivos de secuencias de
comandos.
-off
Deshabilita la visualización al leer los comandos de los archivos de secuencias de
comandos.
mensaje
Especifica el mensaje que se debe mostrar.
Instrucciones de uso
La primera forma de este comando controla si se muestran los comandos de las secuencias de
comandos conforme se leen de los archivos de secuencias de comandos. Si no se especifica
ningún argumento, se mostrará el estado actual on u off. La segunda forma del comando imprime
el mensaje especificado en la pantalla.
Este comando no modifica el valor de la variable de entorno lasterror.
Ejemplos
Para mostrar la cadena de mensaje Hello World:
fs0:\> echo Hello World
Hello World
Para activar el eco de los comandos:
fs0:\> echo -on
Para ejecutar el archivo HelloWorld.nsh y mostrar el contenido conforme se leen las líneas
del archivo de secuencia de comandos:
fs0:\> HelloWorld.nsh
+HelloWorld.nsh> echo Hello World
Hello World
Para desactivar el eco de los comandos:
fs0:\> echo -off
Para mostrar la configuración actual de eco:
fs0:\> echo
Echo is off
edit
Permite editar un archivo ASCII o UCS-2 en modo de pantalla completa.
Sintaxis
edit [archivo]
Opciones
archivo
Especifica el nombre del archivo que se va a editar. Si no se especifica ninguno, se
creará un archivo vacío con un nombre de archivo predeterminado.
Instrucciones de uso
Este comando admite los tipos de archivo UCS-2 y ASCII.
Ejemplo
Para editar el archivo shell.log:
fs0:\> edit shell.log
34
Referencia de comandos de UEFI Shell
eficompress
Comprime un archivo mediante el algoritmo de compresión EFI y escribe el formato comprimido
en un archivo nuevo.
Sintaxis
eficompress archivo-de-entrada archivo-resultante
Opciones
archivo-de-entrada
Especifica el nombre de archivo de entrada sin comprimir.
archivo-resultante
Especifica el nombre de archivo comprimido resultante.
Ejemplo
Para comprimir un archivo denominado sincomprimir a un archivo denominado comprimido:
fs0:\> eficompress uncompressed compressed
efidecompress
Descomprime un archivo mediante el algoritmo de descompresión EFI y escribe el formato
descomprimido en un archivo nuevo.
Sintaxis
efidecompress archivo-de-entrada archivo-resultante
Opciones
archivo-de-entrada
Especifica el nombre del archivo de entrada comprimido.
archivo-resultante
Especifica el nombre del archivo resultante sin comprimir.
Ejemplo
Para descomprimir un archivo denominado comprimido a un archivo denominado
sincomprimir:
fs0:\> eficompress compressed uncompressed
exit
Permite salir de UEFI Shell o de la secuencia de comandos actual.
Sintaxis
exit [/b] [exit-code]
Opciones
/b
Indica que solo debe finalizar la secuencia de comandos de UEFI Shell actual.
Esta opción se ignorará si no se utiliza en una secuencia de comandos.
exit-code
Si se va a salir de una secuencia de comandos de UEFI Shell, especifica el valor
que se asigna a la variable de entorno lasterror. Si se va a salir de una
instancia de UEFI Shell, especifica el valor devuelto al comando que hizo la
llamada. Si no se especifica, devuelve el valor 0.
Ejemplo
Para salir de UEFI Shell:
Comandos de UEFI Shell
35
fs0:\> exit
ftp
Se conecta con servidores FTP para realizar transferencias de archivos por la red.
Sintaxis
ftp host [puerto] [-b]
Opciones
host
Especifica el nombre de host o la dirección IPv4 de un servidor.
puerto
Especifica el puerto FTP del servidor.
-b
Permite los saltos de página para los subcomandos.
Instrucciones de uso
Este comando inicia un shell interactivo para realizar operaciones de transferencia de archivos
por la red (FTP). Solamente se admiten direcciones IPv4. Pulse ESC o Ctrl-C para cancelar una
transferencia de archivos.
IMPORTANTE: No es necesario utilizar ifconfig en una interfaz de red si va a ejecutar
webclient o ftp sobre la misma interfaz debido a que la configuración de la dirección IP y
de la interfaz se selecciona automáticamente mediante la opción Pre-Boot Network Settings
(Configuración de red previa al arranque) que se configura en las utilidades del sistema.
Si la interfaz utilizada por ftp y webclient se ha configurado mediante ifconfig, dicha
configuración se borra y, en su lugar, cuando se ejecutan los comandos, se aplica a la interfaz
el menú Pre-Boot Network Settings (Configuración de red previa al arranque) de las utilidades del
sistema.
Ejemplos
Para conectar con un servidor FTP en una dirección IP determinada:
fs0:\> ftp 192.168.1.20
Para conectar con un servidor FTP usando un nombre de host:
fs0:\> ftp ftp.hp.com
Para conectar con un servidor FTP utilizando una dirección IP, el nombre de usuario usuario y
la contraseña contr:
fs0:\> ftp 192.168.1.20
User (192.168.1.20):usuario
Password:contr
Login successful.
Para conectar con un servidor FTP en una dirección IP específica y activar los saltos de página
para los subcomandos:
fs0:\> ftp 192.168.1.20 -b
getmtc
Obtiene el valor de MTC de Boot Services y lo muestra.
Sintaxis
getmtc
36
Referencia de comandos de UEFI Shell
Instrucciones de uso
Este comando muestra el valor actual del contador monotónico. El valor de 32 bits inferior aumenta
cada vez que se ejecuta este comando. Cada vez que se reinicia el sistema, aumenta el valor
superior de 32 bits y se restablece a 0 el valor inferior de 32 bits.
goto
Permite ir a una etiqueta de una secuencia de comandos.
Sintaxis
goto etiqueta
help
Muestra la lista de comandos integrados en UEFI Shell.
Sintaxis
help [ cmd | patrón | special ] [-usage] [-v] [-section nombre-de-sección]
[-b]
Opciones
cmd
Especifica el comando para que se va a mostrar la ayuda.
patrón
Especifica el patrón que se va a utilizar para mostrar ayuda
sobre los comandos.
special
Muestra una lista de los caracteres especiales utilizados en
la línea de comandos del shell.
-usage
Muestra información relacionada con el uso del comando.
El resultado obtenido es el mismo que si se especifica
–section:NAME y –section:SYNOPSIS.
-v
Muestra información detallada.
-section nombre-de-sección
Muestra la sección especificada de la información de
ayuda.
-b
Muestra el resultado de la ayuda en una única pantalla.
Instrucciones de uso
Si no se especifica ninguna opción, los comandos se mostrarán con una breve descripción de su
función. Si se especifica la opción –v, se mostrará toda la información de ayuda del comando
especificado. Si se especifica la opción –section, solo se mostrará la sección de ayuda
especificada (véase más adelante). Si se especifica la opción –usage, se mostrarán el comando,
una descripción breve e información sobre el uso del comando.
El texto de ayuda se toma de los archivos de texto UCS-2 que se encuentran en el directorio en
el que se encuentra el shell o el archivo ejecutable del comando del shell. Los archivos tienen el
nombre nombre-del-comando.man donde nombre-del-comando representa el nombre del
comando del shell. Los archivos siguen un subconjunto del formato de página MAN, tal como se
describe a continuación.
Si no se especifica ninguna opción, solo se mostrará la sección NAME de la página.
Ejemplos
Para mostrar la lista de comandos de UEFI Shell e insertar un salto de página tras una pantalla:
Shell> help –b
alias
- Displays, creates, or deletes UEFI Shell aliases.
attrib
- Displays or changes the attributes of files or directories.
Comandos de UEFI Shell
37
cd
cls
comp
- Displays or changes the current directory.
- Clears standard output and optionally changes background color.
- Compares the contents of two files on a byte for byte basis.
Para mostrar información de ayuda sobre el comando del shell ls (puede utilizar cualquiera de
las siguientes opciones de sintaxis):
Shell> help ls
Shell> ? ls
Shell> ls -?
Para mostrar la lista de comandos que comiencen por el carácter p:
Shell> help p*
pause – Prints a message and suspends for keyboard input
ifconfig
Modifica la dirección IP predeterminada de la pila de red UEFI IPv4.
Sintaxis
ifconfig [-c [nombre]] [-l[nombre]]
ifconfig [-s nombre dhcp | [static dirección-IP máscara puerta-enlace]
| permanent ]
Opciones
-c
Borra la configuración.
-l
Muestra la configuración.
-s
Establece la configuración.
nombre
Especifica un nombre de adaptador. Por ejemplo, eth0.
dhcp
Especifica que DHCP4 solicitará dinámicamente direcciones IPv4
para todas las interfaces o para una específica.
static dirección-IP
Especifica una dirección IPv4 estática en valores de cuatro enteros,
entre 0 y 255, separados por puntos.
máscara
Especifica una máscara de subred en valores de cuatro enteros,
entre 0 y 255, separados por puntos.
puerta-enlace
Especifica una puerta de enlace en valores de cuatro enteros, entre
0 y 255, separados por puntos.
permanent
Especifica que la configuración es permanente (no se utiliza solo
una vez).
Instrucciones de uso
Puede utilizar este comando para configurar redes host para el acceso de red previo al arranque
desde el shell. La opción –c borra la configuración de todas las interfaces o de una interfaz
especificada, lo que hace que la pila de red de las interfaces relacionadas recupere el valor
predeterminado, DHCP. Si no se especifica la opción permanent, la configuración será efectiva
solo una vez. Si se especifica la opción permanent, la configuración continuará siendo efectiva
cuando se vuelva a cargar la pila de red.
Ejemplos
Para obtener una lista de la configuración de la interfaz eth0:
fso:\>ifconfig -l eth0
Para utilizar DHCP4 para que solicite dinámicamente la configuración de la dirección IPv4 para
la interfaz eth0:
38
Referencia de comandos de UEFI Shell
fso:\>ifconfig -s eth0 dhcp
Para utilizar la configuración de la dirección IPv4 estática para la interfaz eth0 y para definir
esta configuración de forma que persista al volver a cargar una red:
fso:\>ifconfig -s eth0 static 192.168.0.5 255.255.255.0 192.168.0.1 permanent
load
Carga un controlador UEFI en la memoria.
Sintaxis
load [-nc] archivo [archivo...]
Opciones
-nc
Carga el controlador, pero no lo conecta.
archivo
Especifica el archivo de imagen que contiene el controlador UEFI que se va a cargar.
Este comando admite el uso de caracteres comodín.
Instrucciones de uso
Puede utilizar este comando para cargar varios archivos a la vez y utilizar caracteres comodín
para especificarlos. Si no se especifica -nc, el sistema intenta conectar el controlador a un
dispositivo adecuado. También puede hacer que los controladores cargados previamente se
conecten a los dispositivos correspondientes.
Ejemplos
Para cargar el controlador del archivo Isabus.efi:
FS0:\>load Isabus.efi
Para cargar los controladores de los archivos Isabus.efi y IsaSerial.efi:
FS0:\>load Isabus.efi IsaSerial.efi
Para cargar los controladores incluidos en varios archivos cuyo nombre contiene los caracteres
Isa:
FS0:\>load Isa*.efi
Para cargar el controlador del archivo Isabus.efi sin conectar:
FS0:\>load -nc Isabus.efi
ls/dir
Muestra el contenido de un directorio o la información de un archivo. El comando dir es un alias
interno de este comando.
Sintaxis
ls [-r] [-a[atrib]] [-sfo] [archivo]
Opciones
-r
Muestra el contenido de forma recursiva (incluidos los subdirectorios).
-a atrib
Muestra solo los archivos con los atributos especificados. Si no se especifica ningún
atributo, se mostrarán todos los archivos. Si no se especifica la opción –a, se
mostrarán todos los archivos no ocultos y que no sean del sistema. Los atributos
(atrib) pueden ser uno o varios de los siguientes:
•
a: archivo
•
s: sistema
•
h: oculto
Comandos de UEFI Shell
39
•
r: solo lectura
•
d: directorio
-sfo
Muestra los resultados en formato estándar. Consulte también «Detalles de los
resultados del comando ls (información del volumen)» (página 41) y «Detalles de
los resultados del comando ls (información de archivo)» (página 41).
archivo
Especifica el nombre de un archivo o directorio. Este comando admite el uso de
caracteres comodín.
Instrucciones de uso
Si no se especifica ningún nombre de archivo o de directorio, se tomará el directorio de trabajo
actual. El contenido de un directorio se mostrará si se cumplen todas las condiciones siguientes:
•
No se especifica la opción -r.
•
No se usan caracteres comodín en el parámetro archivo.
•
El valor del parámetro archivo especificado representa un directorio existente.
En todos los demás casos, el comando funcionará del modo siguiente:
◦
Se mostrarán todos los archivos o directorios cuyos nombres coincidan con el nombre
especificado.
◦
El indicador -r determina si se realizará una búsqueda recursiva.
◦
El indicador -a atrib muestra solo los archivos que tengan los atributos especificados.
Si se especifica más de un atributo, solo se mostrarán los archivos que tengan dichos
atributos. Si la opción -a no va seguida de ningún valor, se mostrarán todos los archivos
o directorios, sin tener en cuenta sus atributos. Si no se especifica la opción -a, se
mostrarán todos los archivos, salvo los archivos ocultos y del sistema.
Ejemplos
Para ocultar archivos añadiendo el atributo de archivo oculto o de sistema:
fs0:\> attrib +s +h *.efi
ASH fs0:\IsaBus.efi
ASH fs0:\IsaSerial.efi
Para mostrar todos los archivos y directorios, excepto los que tienen el atributo h o s:
fs0:\> ls
Directory of: fs0:\
06/18/01
09:32p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
08:04p
06/18/01
08:05p
01/28/01
08:24p
3 File(s)
4 Dir(s)
153
for.nsh
512 efi
512 test1
512 test2
29 temp.txt
<DIR>
512 test
r
29 readme.txt
211 bytes
<DIR>
<DIR>
<DIR>
Para mostrar los archivos con todos los atributos en el directorio actual:
fs0:\> ls -a
Directory of: fs0:\
06/18/01
06/18/01
06/18/01
06/18/01
06/18/01
40
09:32p
153
01:02p <DIR>
512
01:02p <DIR>
512
01:02p <DIR>
512
10:59p
28,739
Referencia de comandos de UEFI Shell
for.nsh
efi
test1
test2
IsaBus.efi
06/18/01
10:59p
32,838
IsaSerial.efi
06/18/01
08:04p
29
temp.txt
06/18/01
08:05p <DIR>
512
test
01/28/01
08:24p
r
29
readme.txt
5 File(s)
61,788 bytes
4 Dir(s)
Para mostrar los archivos con atributos de solo lectura en el directorio actual:
fs0:\> ls -ar
Directory of: fs0:\
06/18/01 11:14p
r 29
1 File(s)
29 bytes
0 Dir(s)
readme.txt
Para mostrar los archivos con el atributo s:
fs0:\> ls -as isabus.efi
Directory of: fs0:\
06/18/01 10:59p
1 File(s)
0 Dir(s)
28,739 IsaBus.efi
28,739 bytes
Para mostrar de forma recursiva todo el contenido del directorio fs0:\efi:
fs0:\> ls -r -a efi
Para buscar archivos del tipo especificado en el directorio actual de forma recursiva:
fs0:\> ls -r -a *.efi –b
Detalles de los resultados
En las tablas siguientes se describe la información de volumen (directorio) y archivo que puede
producir este comando.
Tabla 8 Detalles de los resultados del comando ls (información del volumen)
Columna
Descripción
Name
Etiqueta de volumen estándar.
Total Size
Número total de bytes en el volumen.
Read Only status
Estado de solo lectura:
• True
• False
Free Space
Cantidad total de bytes libres en el volumen.
Block Size
Tamaño de bloque nominal, en bytes, que suelen aumentar los archivos.
Tabla 9 Detalles de los resultados del comando ls (información de archivo)
Columna
Descripción
Name
Nombre de archivo completo y directorio, incluido el nombre asignado del sistema de
archivos.
Logical Size
Tamaño del archivo, en bytes.
Physical Size
Tamaño en bytes del archivo en el volumen, incluido el material de relleno.
Attributes
Lista de atributos del archivo. Los valores posibles son:
• a: archivo
• d: directorio
• h: oculto
• r: solo lectura
Comandos de UEFI Shell
41
Tabla 9 Detalles de los resultados del comando ls (información de archivo) (continuación)
Columna
Descripción
• s: sistema
File Creation Time
Hora a la que creó el archivo, con el formato hh:mm:ss.
File Creation Date
Fecha en la que se creó el archivo, con el formato dd:mm:aaaa.
File Access Time
Hora la que se tuvo acceso al archivo por última vez, con el formato hh:mm:ss.
File Access Date
Fecha en la que se tuvo acceso al archivo por última vez, con el formato dd:mm:aaaa.
File Modification Time Hora a la que se modificó el archivo, con el formato: hh:mm:ss.
File Modification Date Fecha en la que se modificó el archivo, con el formato: dd:mm:aaaa.
map
Permite mostrar o configurar una asignación entre un nombre definido por el usuario y un
identificador de dispositivo.
Sintaxis
map [-d mappedname]
map [ -r | -v | -c | -f | -u | -t tipo [,tipo...] | mappedname ] [-sfo]
map [ mappedname | asignación ]
Opciones
-d
Elimina una asignación.
mappedname
Especifica un nombre de asignación.
-r
Restablece una asignación.
-v
Muestra información detallada sobre todas las asignaciones.
-c
Muestra la asignación coherente.
-f
Muestra la asignación normal.
-t
Muestra las asignaciones del dispositivo, filtradas según el tipo de dispositivo.
Los tipos admitidos son los siguientes:
•
fp: unidad de disquete
•
hd: disco duro
•
cd: CD-ROM
Los tipos se pueden combinar si se intercala una coma entre ellos. No es posible
intercalar espacios entre los tipos.
42
-sfo
Muestra los resultados en formato estándar. Consulte Tabla 10 (página 43).
-u
Permite agregar asignaciones para los dispositivos recién instalados. Asimismo,
permite quitar las asignaciones de los dispositivos desinstalados, pero no modifica
las asignaciones de los dispositivos existentes. Mantiene las asignaciones
definidas por el usuario.
handle
Especifica el número del identificador.
asignación
Especifica un nuevo nombre asignado para un dispositivo. La asignación debe
terminar con el signo de dos puntos (:).
Referencia de comandos de UEFI Shell
Instrucciones de uso
Este comando se utiliza con más frecuencia para crear un nombre asignado para los dispositivos
que admiten un protocolo de sistema de archivos. Una vez creadas estas asignaciones, los nombres
se pueden utilizar con todos los comandos de manipulación de archivos.
El entorno de UEFI Shell crea asignaciones predeterminadas para todos los dispositivos que
admiten un sistema de archivos reconocido.
Este comando puede utilizarse para crear asignaciones adicionales o para eliminar una asignación
existente con la opción -d. Si se utiliza el comando sin ningún parámetro, se mostrarán todas las
asignaciones actuales. Si se utiliza la opción - v, se mostrarán las asignaciones con información
adicional sobre cada dispositivo.
La opción - r restablece todas las asignaciones predeterminadas de un sistema. Esta opción
resulta útil si la configuración del sistema ha cambiado desde el último inicio.
La opción –u permite agregar asignaciones para los dispositivos recién instalados. Asimismo,
permite quitar las asignaciones de los dispositivos desinstalados, pero no modifica las asignaciones
de los dispositivos existentes. Esta opción también conserva las asignaciones definidas por el
usuario. Este comando también guarda un historial de asignaciones para que se pueda usar el
nombre de asignación original de un dispositivo con una ruta de dispositivo específica en caso
de que se utilice dicho nombre de asignación para la ruta del dispositivo por última vez. El
directorio actual también se mantendrá si no se modifica el dispositivo actual.
Cada dispositivo del sistema tiene una asignación coherente. Las asignaciones coherentes del
dispositivo no cambiarán si no se modifica la configuración de hardware. Si dos o más equipos
tienen las mismas configuraciones de hardware, la asignación coherente del dispositivo será la
misma. Utilice la opción -c para que se muestren todas las asignaciones coherentes del sistema.
La asignación consta de dígitos y caracteres. No se permite ningún otro carácter.
Este comando permite utilizar caracteres comodín para eliminar o mostrar asignaciones. No
obstante, no es posible usar caracteres comodín para realizar la asignación.
Ejemplo
Para eliminar una asignación:
Shell> map -d nombre-dispositivo
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 10 Detalles de los resultados del comando map
Número de columna
Descripción
1
El nombre de la tabla. El nombre es mappings (asignaciones).
2
El nombre asignado. El nombre del dispositivo asignado.
3
La ruta del dispositivo. La ruta del dispositivo que se corresponde con el nombre del
dispositivo asignado.
4
El nombre coherente. Nombre asignado coherente (si existe) equivalente a mappedname.
Esta columna no contendrá ningún valor si mappedname ya es un nombre asignado
coherente.
memmap
Muestra el mapa de memoria del sistema.
Sintaxis
memmap [-b] [-sfo]
Comandos de UEFI Shell
43
Opciones
-b
Muestra una pantalla a la vez.
-sfo
Muestra los resultados en formato estándar en una tabla de resumen y en una tabla
detallada. Consulte «Detalles de los resultados del comando memmap» (página 44).
Instrucciones de uso
El mapa de memoria realiza un seguimiento de toda la memoria física del sistema y de cómo se
está usando actualmente.
Ejemplo
Para mostrar el mapa de memoria del sistema:
fs0:\> memmap
Type
Start
End
# Pages
available
0000000000750000-0000000001841FFF
LoaderCode 0000000001842000-00000000018A3FFF
available
00000000018A4000-00000000018C1FFF
LoaderData 00000000018C2000-00000000018CAFFF
BS_code
00000000018CB000-0000000001905FFF
BS_data
0000000001906000-00000000019C9FFF
...
RT_data
0000000001B2B000-0000000001B2BFFF
BS_data
0000000001B2C000-0000000001B4FFFF
reserved
0000000001B50000-0000000001D4FFFF
reserved :
LoaderCode:
LoaderData:
BS_code
:
BS_data
:
RT_data
:
available :
Total Memory:
Attributes
00000000000010F2
0000000000000062
000000000000001E
0000000000000009
000000000000003B
00000000000000C4
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000001 8000000000000009
0000000000000024 0000000000000009
0000000000000200 0000000000000009
512 Pages (2,097,152)
98 Pages (401,408)
32 Pages (131,072)
335 Pages (1,372,160)
267 Pages (1,093,632)
19 Pages (77,824)
4,369 Pages (17,895,424)
20 MB (20,971,520) Bytes
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 11 Detalles de los resultados del comando memmap
Columna
Descripción
Type
Tipo de memoria. Las opciones disponibles son las siguientes:
• Available
• LoaderCode
• LoaderData
• BootServiceCode
• BootServiceData
• RuntimeCode
• RuntimeData
• Reserved
• MemoryMappedIO
• MemoryMappedIOPortSpace
• UnusableMemory
• ACPIReclaimMemory
• ACPIMemoryNVS
44
Referencia de comandos de UEFI Shell
Tabla 11 Detalles de los resultados del comando memmap (continuación)
Columna
Descripción
• PalCode
Start
Dirección de inicio.
End
Dirección de finalización.
# Pages
Número de páginas de 4 KB.
reserved
Cantidad total de memoria reservada en bytes.
LoaderCode
Tamaño total de código de cargador en bytes.
LoaderData
Tamaño total de datos de cargador en bytes.
BS_code
Tamaño total de código de servicio de arranque en bytes.
BS_data
Tamaño total de datos de servicio de arranque en bytes.
RT_data
Tamaño total de datos en tiempo de ejecución en bytes.
available
Memoria disponible en bytes.
Total Memory
Memoria total en bytes.
mkdir
Permite crear uno o varios directorios.
Sintaxis
mkdir dir [dir...]
Opción
dir
Especifica uno o varios nombres de directorios. Este comando no admite el uso de caracteres
comodín.
Instrucciones de uso
Si dir incluye directorios anidados, se crearán los directorios principales antes de los secundarios.
Si el directorio ya existe, el comando finalizará con un error.
Ejemplos
Para crear un nuevo directorio y mostrar su contenido:
fs0:\> mkdir rafter
fs0:\> ls
Directory of: fs0:\
06/18/01 08:05p <DIR>
512
06/18/01 11:14p r
29
06/18/01 11:50p <DIR>
512
1 File(s)
211 bytes
2 Dir(s)
test
readme.txt
rafter
Para crear y mostrar varios directorios:
fs0:\> mkdir temp1 temp 2
fs0:\> ls
Directory of: fs0:\
06/18/01
06/18/01
06/18/01
08:05p <DIR>
11:14p r
11:50p <DIR>
512
29
512
test
readme.txt
rafter
Comandos de UEFI Shell
45
06/18/01 11:52p <DIR>
512
06/18/01 11:52p <DIR>
512
1 File(s)
211 bytes
4 Dir(s)
temp1
temp2
mode
Muestra o cambia el modo del dispositivo de salida de la consola.
Sintaxis
modo [col fil]
Opciones
col
Especifica el número de columnas.
fil
Especifica el número de filas.
Instrucciones de uso
Cuando se utiliza sin parámetros, muestra una lista de los modos que admite actualmente el
dispositivo de salida estándar. El comando puede utilizarse con los parámetros row y col para
cambiar el número de filas y columnas en el dispositivo de salida estándar.
NOTA: La pantalla se borra cada vez que se utiliza el comando mode para cambiar el modo
de visualización actualmente seleccionado.
Ejemplos
Para mostrar todos los modos disponibles en el dispositivo de salida estándar, así como el modo
seleccionado actualmente (indicado con un *):
Shell> mode
Available modes on standard output
col 80 row 25 *
col 80 row 50
col 80 row 43
col 100 row 100
Para cambiar la configuración del modo actual a una pantalla de modo de texto de 80 X 50:
Shell> mode 80 50
Available modes on standard output
col 80 row 25
col 80 row 50 *
col 80 row 43
col 100 row 100
mv
Permite mover uno o varios archivos a un destino del sistema de archivos.
Sintaxis
mv orig... [dest]
Opciones
46
orig...
Especifica un archivo de origen o nombre de directorio. Este comando admite el uso
de caracteres comodín.
dest
Especifica un nombre de archivo o archivo de destino. Este comando admite el uso
de caracteres comodín. Si no se especifica, se asumirá que el directorio de trabajo
actual es el de destino. Si hay más de un argumento en la línea de comandos, siempre
se considerará el último como destino.
Referencia de comandos de UEFI Shell
Instrucciones de uso
Este comando no admite el traslado entre volúmenes del sistema de archivos. Si el destino es un
directorio existente, los orígenes se moverán a dicho directorio. De lo contrario, los orígenes se
moverán al destino como si se hubiese cambiado el nombre del directorio. Si no se especifica
ningún destino, se asumirá que el directorio actual es el destino.
Se producirá un error si se intenta mover un directorio o archivo de solo lectura. Este comando
permite mover un directorio que contiene archivos de solo lectura. No es posible mover un directorio
a sí mismo o a sus subdirectorios. No se podrá mover un directorio si este es el directorio de
trabajo actual o alguno de sus subdirectorios.
Los demás archivos o directorios se moverán pese a que se produzca un error.
Ejemplo
Para cambiar el nombre de un archivo:
fs0:\> mv IsaBus.efi Bus.efi
moving fs0:\IsaBus.efi -> \Bus.efi
- [ok]
openinfo
Muestra los protocolos y agentes asociados a un identificador.
Sintaxis
openinfo identificador [-b]
Opciones
-b
Muestra una pantalla a la vez.
identificador
Muestra la información de los protocolos abiertos para el identificador
especificado.
parse
Permite recuperar un valor de un registro especificado que se generó en los resultados con formato
estándar.
Sintaxis
parse nombre-de-archivo nombre-de-tabla columna [-i instancia] [-s
instancia]
Opciones
nombre-de-archivo
Especifica el nombre del archivo de origen.
nombre-de-tabla
Especifica el nombre de la tabla que se debe analizar.
columna
Especifica el índice de columna para determinar el valor específico
del registro que se debe analizar.
-i instancia
Inicia el análisis de la instancia nth de la opción tablename
especificada, después de la instancia especificada de ShellCommand.
Si no se encuentra, se devolverán todas las instancias.
-s instancia
Inicia el análisis de la instancia nth de la tabla ShellCommand
especificada. Si no se encuentra, el parámetro tomará el valor 1.
Instrucciones de uso
Este comando permite analizar los datos de un archivo que contiene el resultado de un comando
con el que se ha utilizado el parámetro –sfo. Puesto que el formato estándar de resultados tiene
Comandos de UEFI Shell
47
métodos de análisis conocidos, este comando debe utilizarse como método simplificado para
hacer que las secuencias de comandos usen los archivos de resultados creados y los datos
recuperados en la lógica de las secuencias de comandos programadas para UEFI Shell.
Ejemplos
A continuación se muestran los datos incluidos en un archivo temporal (temp.txt):
ShellCommand, "LS"
VolumeInfo, "MikesVolume","400000000","32000000","16000000"
FileInfo, "fs0:/efi/boot/winloader.efi","45670","arsh"
FileInfo, "fs0:/efi/boot/mikesfile.txt","1250","a"
FileInfo, "fs0:/efi/boot/readme.txt","795","a"
Para utilizar el parámetro de índice para analizar el archivo temp.txt:
fs0:\> parse temp.txt FileInfo 3 –i 3
795
pause
Permite poner en pausa la ejecución del archivo de la secuencia de comandos.
Sintaxis
pause [-q]
Instrucciones de uso
Este comando solo está disponible para las secuencias de comandos. Muestra un mensaje en la
pantalla, suspende la ejecución del archivo de la secuencia de comandos y espera a que se pulse
una tecla del teclado. La ejecución se reanudará al pulsar cualquier tecla, excepto las teclas q o
Q. Si se pulsan las teclas q o Q, finalizará el procesamiento de la secuencia de comandos. En
caso contrario, la ejecución continuará con la siguiente línea tras el comando de pausa.
Opción
–q
Oculta el mensaje mostrado.
Ejemplos
Esta secuencia de comandos muestra un ejemplo del comando pause:
fs0:\> type pause.nsh
#
# Example script for 'pause' command
#
echo pause.nsh begin..
date
hour
pause
echo pause.nsh done.
Para ejecutar la secuencia de comandos con el eco activado:
fs0:\> pause.nsh
+pause.nsh> echo pause.nsh begin..
pause.nsh begin..
+pause.nsh> date
06/19/2001
+pause.nsh> time
00:51:45
+pause.nsh> pause
Enter 'q' to quit, any other key to continue:
+pause.nsh> echo pause.nsh done.
pause.nsh done.
Para ejecutar la secuencia de comandos con el eco desactivado:
48
Referencia de comandos de UEFI Shell
fs0:\> echo —off
fs0:\> pause.nsh
pause.nsh begin..
pause.nsh begin..
06/19/2001
00:52:50
Enter 'q' to quit, any other key to continue: q
fs0:\>
pci
Muestra una lista de dispositivos PCI o información acerca del espacio de configuración de la
función PCI.
Sintaxis
pci [Bus Dev [Func] [-s Seg] [-i]]
Opciones
-s
Especifica un número de segmento.
mappedname
Especifica un nombre de asignación.
-i
Información interpretada.
-Bus
Número de bus.
Dev
Número de dispositivo.
Func
Número de función.
Instrucciones de uso
Este comando muestra todos los dispositivos PCI del sistema. La información mostrada para el
espacio de configuración de un dispositivo PCI se basa en las direcciones especificadas de bus
(Bus), dispositivo (Dev) y función (Func). Si no se especifica ninguna dirección de función, se
tomará el valor 0 de forma predeterminada.
La opción -i muestra información detallada sobre el dispositivo PCI especificado. El espacio de
configuración de PCI del dispositivo se vuelca con una interpretación detallada.
Si no se especifica ningún parámetro, se volcarán todos los dispositivos PCI con una interpretación
detallada.
Si se especifican los parámetros –Bus y Dev (número de dispositivo), pero no se especifican los
parámetros Func o Seg, Func o Seg tomarán el valor 0, (valor predeterminado).
Ejemplos
Para mostrar todos los dispositivos PCI del sistema:
fs0:\> pci
Para mostrar el espacio de configuración del bus 0, el dispositivo 0 y la función 0:
fs0:\> pci 00 00 00 -1
ping
Envía un ping al host de destino con una pila IPv4.
Sintaxis
ping [-s_ IP_origen] [-n número] [-l tamaño] IP_destino
Opciones
-s
Especifica que el adaptador de origen es una dirección IPv4.
Comandos de UEFI Shell
49
IP de origen
Especifica la dirección IPv4 de la máquina de origen.
-n número
Especifica el número de datagramas de solicitud de eco que han de enviarse.
-l tamaño
Especifica el tamaño del búfer de datos en el datagrama de solicitud de eco.
IP_destino
Especifica la dirección IPv4 de la máquina de destino.
Instrucciones de uso
Este comando utiliza el datagrama ICMPv4 ECHO_REGUEST para obtener un ECHO_REPLY de
un host.
Ejemplos
Para hacer ping al host de destino en 192.168.0.1 con 64 bytes de datos:
FS0:\>ping -1 64 192.168.0.1
Para hacer ping al host de destino en 202.120.120.100 mediante el envío de un datagrama de
solicitud de eco de 20 bytes:
FS0:\>ping -n 20 202.120.120.100
reset
Permite restablecer el sistema.
Sintaxis
reset [ -w | [-s] | -c ] [cadena]
Opciones
-w
Realiza un arranque en caliente.
-s
Apaga el sistema.
-c
Realiza un arranque en frío.
cadena
Especifica la cadena que se debe transmitir para restablecer el servicio.
Instrucciones de uso
El uso predeterminado de este comando lleva a cabo un reinicio en frío. Si se especifica la opción
cadena, se transmitirá el valor de esta opción a la función SystemTable ResetSystem()
para informar al sistema de la razón para el reinicio del sistema.
Ejemplo
Para restablecer el sistema:
Shell> reset
rm/del
Permite eliminar uno o varios archivos o directorios. El comando del es un alias interno de este
comando.
Sintaxis
rm [-q] archivo/directorio [archivo/directorio...]
Opciones
50
-q
Realiza la eliminación de forma silenciosa, sin mostrar ningún mensaje de
confirmación.
archivo
Especifica el nombre del archivo que se va a eliminar. Este comando admite el
uso de caracteres comodín.
Referencia de comandos de UEFI Shell
directorio
Especifica el directorio que se va a eliminar. Este comando admite el uso de
caracteres comodín.
Instrucciones de uso
Si el destino es un directorio, este comando lo eliminará, incluidos todos sus subdirectorios. Este
comando no puede redirigir archivos cuyos directorios principales (o incluso los propios archivos)
se vayan a eliminar.
Se producirá un error si se eliminan directorios o archivos de solo lectura. También se producirá
un error si se elimina un directorio que contenga uno o varios archivos de solo lectura. En caso
de error, el comando rm se cerrará inmediatamente y no se eliminarán los archivo o directorios
restantes.
No es posible eliminar un directorio si el directorio actual es el directorio que se trata de eliminar
o alguno de sus subdirectorios. Si el archivo especificado para la eliminación contiene caracteres
comodín, el sistema no solicitará confirmación alguna.
Asimismo, no es posible eliminar el directorio raíz, el directorio actual ni sus antecesores.
Ejemplos
Intento de eliminación de varios directorios a la vez cuando no se pueden encontrar los directorios
(lo que provoca la finalización del comando):
fs0:\> ls test
Directory of: fs0:\test
06/18/01 01:01p <DIR>
06/18/01 01:01p <DIR>
06/19/01 12:59a <DIR>
06/19/01 12:59a <DIR>
0 File(s) 0 bytes
4 Dir(s)
512 .
0 ..
512 temp1
512 temp2
fs0:\> rm test\temp11 temp2
rm/del: Cannot find 'fs0:\test\temp11' - Not Found
Para eliminar varios directorios con caracteres comodín:
fs0:\> rm test\temp*
rm/del: Remove subtree 'fs0:\test\temp1' [y/n]? y
removing fs0:\test\temp1\temp1.txt
- [ok]
removing fs0:\test\temp1\boot\nshell.efi
- [ok]
removing fs0:\test\temp1\boot
- [ok]
removing fs0:\test\temp1
- [ok]
rm/del: Remove subtree 'fs0:\test\temp2' [y/n]? y
removing fs0:\test\temp2\temp2.txt
- [ok]
removing fs0:\test\temp2
- [ok]
Intento de eliminación de un directorio que contiene un archivo de solo lectura, lo que provoca
un mensaje de error:
fs0:\> attrib +r test\temp1\readme.txt
A R fs0:\test\temp1\readme.txt
fs0:\> rm test\temp1
rm/del: Cannot open 'readme.txt' under 'fs0:\test\temp1' in
writable mode
- [error] - Access Denied
Exit status code: Access Denied
Comandos de UEFI Shell
51
set
Permite crear, mostrar, cambiar o eliminar una variable de entorno de UEFI Shell.
Sintaxis
set [-v] [nombre [valor]]
set [-d nombre]
Opciones
-v
Establece una variable volátil que desaparece en el siguiente inicio.
-d
Elimina una variable.
nombre
Especifica un nombre para la variable.
valor
Especifica un valor para la variable.
Instrucciones de uso
Este comando establece la variable de entorno especificada con la opción nombre con los
parámetros opcionales valor. Si no se utiliza ningún parámetro, se mostrarán todas las variables
de entorno. Si se utiliza con la opción -d, se eliminará la variable de entorno especificada con
la opción nombre.
Este comando no modifica el valor de la variable de entorno lasterror.
Ejemplos
Para agregar una variable de entorno:
Shell> set DiagnosticPath fs0:\efi\diag;fs1:\efi\diag
Para mostrar las variables de entorno:
Shell> set
* path
: .
diagnosticPath
: fs0:\efi1.1\diag;fs1:\efi1.1\diag
Para eliminar una variable de entorno:
Shell> set -d diagnosticpath
Shell> set
* path
: .
“
Para modificar una variable de entorno:
fs0:\> set src efi
fs0:\> set
]* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
src : efi
fs0:\> set src efi1.1
fs0:\> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
src : efi1.1
Para agregar una variable de entorno:
Shell> set
* path
: .
Shell> set path %path%;fs0:\efi\tools;fs0:\efi\boot;fs0:\
Shell> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
Para establecer una variable volátil que desaparezca la próxima vez que se reinicie:
Shell> set -v EFI_SOURCE c:\project\EFI1.1
Shell> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
* EFI_SOURCE
: c:\project\EFI1.1
52
Referencia de comandos de UEFI Shell
setsize
Permite ajustar el tamaño de un archivo de destino.
Sintaxis
setsize tamaño [-d] archivo [archivo...]
Opciones
tamaño
Especifica el tamaño del archivo una vez que se ajusta.
-d
Elimina una variable.
archivo
Especifica el archivo cuyo tamaño debe ajustarse.
Instrucciones de uso
Al ajustar el tamaño de un archivo, este comando trunca o amplía automáticamente el tamaño
en función de los parámetros utilizados. El archivo se creará en caso de que no exista ninguno.
Al establecer un tamaño inferior al de los datos reales del archivo, se truncan los datos.
Ejemplo
Para establecer el tamaño de un archivo:
fs0:\> setsize size file [file...]
shift
Permite desplazar el contenido de los parámetros posicionales de una secuencia de comandos
de UEFI Shell para que las secuencias de comandos puedan procesarlos de izquierda a derecha.
Sintaxis
shift
Instrucciones de uso
Este comando permite desplazar el contenido de los parámetros de las secuencias de comandos
de UEFI Shell para descartar %1, copiar %2 en %1, %3 en %2, %4 en %3 y así sucesivamente. Esto
permite a las secuencias de comandos de UEFI Shell procesar los parámetros de izquierda a
derecha.
Este comando no modifica la variable de entorno de UEFI Shell lasterror.
Ejemplos
Para ejecutar la secuencia de comandos con el eco activado:
fs0:\> shift.nsh welcome EFI world
shift.nsh> echo welcome EFI world
welcome EFI world
shift
echo EFI world
EFI world
Para ejecutar la secuencia de comandos con el eco desactivado:
fs0:\> echo -off
shift.nsh> shift.nsh welcome EFI world
welcome EFI world
EFI world
smbiosview
Muestra la información de SMBIOS.
Comandos de UEFI Shell
53
Sintaxis
smbiosview [-t SmbiosType] | [-h SmbiosHandle] | [-s] | [-a]
Opciones
-t
Muestra todas las estructuras de SmbiosType.
SmbiosType
Especifica el tipo de estructura de SMBIOS. Es un número del 0 al 42. Para
ver los valores admitidos y sus descripciones, utilice el comando help
smbios.
-h
Muestra las estructuras de SmbiosHandle.
SmbiosHandle
Especifica un identificador único de 16 bits de una estructura SMBIOS.
-s
Muestra una tabla de estadísticas.
—a
Muestra toda la información.
Ejemplo
Para mostrar todas las estructuras de SmbiosType 7 (información de la caché):
fs0:\> smbiosview -t 7
stall
Establece una detención temporizada de las operaciones, en microsegundos, durante la ejecución
de una secuencia de comandos.
Sintaxis
stall tiempo
Opción
Especifica el número de microsegundos que debe detenerse el procesador.
tiempo
Ejemplo
Para detener el procesador durante 20 microsegundos:
Shell> stall 20
sysinfo
Muestra información del sistema, que incluye nombre del sistema, número de serie, ID del
producto, versión del BIOS, versión de la copia de seguridad del BIOS, versión del firmware del
controlador de gestión de la alimentación, modo de arranque, memoria del sistema, procesadores,
direcciones IP de iLO y dispositivos de red.
Sintaxis
sysinfo [-sfo]
Opción
-sfo
Muestra la información de los resultados en formato estándar.
Instrucciones de uso
Este comando muestra la misma información que se muestra en la pantalla System Information
(Información del sistema) de las System Utilities (Utilidades del sistema).
54
Referencia de comandos de UEFI Shell
Ejemplo
Para ver la información del sistema:
Shell> sysinfo
time
Muestra o permite establecer la hora actual del sistema.
Sintaxis
time [hh:mm [:ss]] [-tz tz] [-d dl]
Opciones
hh
Establece un nuevo valor para la hora (0–23).
mm
Establece un nuevo valor para los minutos (0–59).
ss
Establece un nuevo valor para los segundos (0–59). Si no se especifica, se utilizará el
valor cero.
-tztz
Establece un ajuste de zona horaria, en minutos con respecto a la hora GMT. Los valores
válidos pueden estar entre -1440 y 1440 o bien el valor 2047. Si no se encuentra el
valor o se establece como 2047, se establecerá en la hora local.
-d dl
Establece un valor de horario de verano. Los valores válidos son:
•
0: la hora no se ve afectada por el horario de verano.
•
1: la hora se ve afectada por el horario de verano, pero no se ha ajustado.
•
3: la hora se ve afectada por el horario de verano y se ha ajustado.
Si no se especifica ningún valor después de –d, se mostrará el horario de verano actual.
Instrucciones de uso
Si no se especifica ningún parámetro, este comando muestra la hora actual. La hora del sistema
se actualizará si se especifican valores de horas, minutos y segundos válidos.
A excepción de los caracteres numéricos y del carácter : (dos puntos), todos los caracteres restantes
del argumento no serán válidos. El shell mostrará de un error si el número se encuentra en el
intervalo incorrecto de horas/minutos/segundos. No se permiten espacios antes o después del
carácter numérico. Tampoco se permiten espacios insertados en la secuencia numérica.
Si no se especifica el parámetro ss, los segundos se establecerán en cero de forma predeterminada.
Ejemplos
Para mostrar la hora actual del sistema:
fs0:\> time
16:51:03 (GMT+08:00)
Para establecer la hora actual del sistema:
fs0:\> time 9:51:30
fs0:\> time
9:51:31 (GMT+08:00)
Para establecer la hora del sistema y, a continuación, mostrar el valor del horario de verano:
fs0:\> time 9:51:30
fs0:\> time —d
09:51:31 (GMT+08:00) DST: Not Affected
timezone
Muestra o permite establecer la información de zona horaria.
Comandos de UEFI Shell
55
Sintaxis
timezone [-s:hh:mm] [-l-b-f]
Opciones
-s
Establece la zona horaria asociada con un ajuste de hh:mm con respecto a la hora UTC.
-l
Muestra una lista con todas las zonas horarias.
-b
Muestra una pantalla a la vez.
-f
Muestra información completa de la zona horaria especificada.
Instrucciones de uso
Si no se especifica ningún parámetro, este comando muestra la zona horaria actual. Si se especifica
un parámetro hh:mm válido, se actualizará la información de zona horaria del sistema.
Ejemplos
Para mostrar todas las zonas horarias disponibles:
fs0:\> timezone -l
Para establecer la zona horaria:
fs0:\> timezone -s 7:00
Para mostrar información detallada de la zona horaria actual:
fs0:\> timezone -f
touch
Permite actualizar la fecha y la hora de un archivo con la fecha y la hora actuales.
Sintaxis
touch [-r] archivo [archivo...]
Opciones
-r
Hace que la actualización se realice de forma recursiva en los subdirectorios.
archivo
Especifica el nombre o el patrón del archivo o directorio que se va a actualizar. Es
posible actualizar varios archivos a la vez.
Instrucciones de uso
Cuando se especifican varios archivos, el sistema procesa los archivos de uno en uno y hace caso
omiso de los errores.
Este comando no puede cambiar la hora y la fecha de los archivos y directorios de solo lectura.
Ejemplo
Para actualizar la fecha y hora de un archivo:
fs0:\> touch myfile.txt
type
Permite enviar el contenido de un archivo al dispositivo de salida estándar.
Sintaxis
type archivo [archivo...]
Opción
archivo
56
Especifica el nombre del archivo cuyo contenido se va a mostrar.
Referencia de comandos de UEFI Shell
Instrucciones de uso
Si no se especifica ninguna opción, este comando intentará detectar el tipo de archivo. Si el
comando falla, se asumirá que el tipo de archivo es UCS-2.
Ejemplos
Para mostrar un archivo de formato:
fs0:\> type pause.nsh
#
# Example script for 'pause' command
#
echo pause.nsh begin..
\date
time
pause
echo pause.nsh done.
Para mostrar varios archivos:
fs0:\> type test.*
How to Install?
time
stall 3000000
time
unload
Descarga una imagen del controlador UEFI de la memoria.
Sintaxis
unload [-n] [ -v | verbose ] indentificador
Opciones
-n
Omite todos los mensajes que se muestran durante la descarga, de manera
que se puede utilizar la salida en un archivo de secuencia de comandos.
-v
Muestra información detallada de la imagen antes de descargarla.
verbose
Vuelca información detallada de la imagen antes de descargarla.
indentificador
Especifica el identificador del controlador que se va a descargar en formato
hexadecimal.
Instrucciones de uso
Solo se pueden descargar los controladores que admiten la descarga.
Ejemplos
Para buscar el identificador para la imagen del controlador UEFI que se va a descargar:
Shell> dh -b
Para descargar la imagen del controlador UEFI con identificador 27:
Shell> unload 27
ver
Muestra la información de versión de UEFI Shell y del firmware UEFI subyacente.
Sintaxis
ver [ -s | -t ]
Comandos de UEFI Shell
57
Opciones
-s
Muestra solo la versión de UEFI Shell.
-t
Muestra el contenido resumido (abreviado).
Instrucciones de uso
Este comando recupera información de la tabla del sistema UEFI o la imagen del shell.
Ejemplo
Para mostrar solo la versión de UEFI Shell:
fs0:\> ver —s
2.0
Para mostrar la información completa acerca de la versión de firmware de UEFI Shell:
fs0:\> ver
UEFI Interactive Shell v2.0
Copyright 1982, 2014 Hewlett-Packard Development Company, L.P.
UEFI v2.31 (HP, 0x00010000)
ProLiant System BIOS - P79 (01/14/2014)
vol
Muestra la información del volumen de un sistema de archivos.
Sintaxis
vol [fs] [-n etiqueta-de-volumen]
vol [fs] [-d]
Opciones
fs
Especifica el nombre del sistema de archivos para mostrar.
-n etiqueta-de-volumen
Especifica el nombre de la etiqueta del volumen. No es posible
utilizar los caracteres siguientes: % ^ * + = [ ] | : ;
" < > ? / . No se permite el uso de espacios en la etiqueta
de volumen.
-d
Especifica una etiqueta de volumen vacía.
Instrucciones de uso
Si no se especifica la opción fs, el sistema tomará el sistema de archivos actual. Si se especifica
-n, la etiqueta del volumen de fs se configura para el parámetro etiqueta-de-volumen. La
longitud máxima del parámetro etiqueta-de-volumen es de 11 caracteres.
Ejemplos
Para mostrar el volumen del sistema de archivos actual:
fs0:\> vol
Volume has no label (rw)
1,457,664 bytes total disk space
1,149,440 bytes available on disk
512 bytes in each allocation unit
Para cambiar la etiqueta de fs0:
shell> vol fs0 –n help_test
Volume HELP_TEST (rw)
1,457,664 bytes total disk space
1,149,440 bytes available on disk
512 bytes in each allocation unit
Para eliminar la etiqueta de volumen de fs0:
58
Referencia de comandos de UEFI Shell
fs0:\> vol fs0 -d
Volume has no label (rw)
1,457,664 bytes total disk space
220,160 bytes available on disk
512 bytes in each allocation unit
webclient
Descarga archivos de HTTP o FTP y monta un sistema de archivos ISO.
Sintaxis
webclient [-g URL] [[-o archivo] | [-m]] [-l]
IMPORTANTE: No es necesario utilizar ifconfig en una interfaz de red si va a ejecutar
webclient o ftp sobre la misma interfaz debido a que la configuración de la dirección IP y
de la interfaz se selecciona automáticamente mediante la opción Pre-Boot Network Settings
(Configuración de red previa al arranque) que se configura en las utilidades del sistema.
Si la interfaz utilizada por ftp y webclient se ha configurado mediante ifconfig, dicha
configuración se borra y, en su lugar, cuando se ejecutan los comandos, se aplica a la interfaz
el menú Pre-Boot Network Settings (Configuración de red previa al arranque) de las utilidades del
sistema.
Opciones
-g
Recupera un documento especificado por la dirección URL.
URL
Especifica la dirección de hipertexto del documento que se debe recuperar. Puede
ser una dirección IPv4 o un nombre de host.
-o
Redirige el resultado al archivo especificado.
archivo
Especifica el nombre del archivo al que se redirige el resultado.
-m
Descarga y monta un archivo ISO como un sistema de archivos.
-l
Muestra información sobre la configuración de red utilizada.
Instrucciones de uso
Este comando permite realizar transferencias de red mediante secuencias de comandos. Una
ventaja importante del uso de este comando es que se puede especificar una URL con una dirección
HTTP para recuperar un documento, enviarlo a un archivo en dicha dirección y descargar un
archivo o montar un archivo ISO. Pulse ESC o Ctrl-C para cancelar una transferencia de archivos.
Para las URL de FTP, se admite la autenticación especificando un nombre de usuario y una
contraseña en texto sin cifrar en la dirección URL. El tamaño máximo de un archivo que se puede
guardar en una partición FAT32 es de 4 GB. Debe utilizar una dirección IPv4.
Ejemplos
Para descargar un archivo ISO de un servidor HTTP o FTP y montar un sistema de archivos ISO:
fs0:\> webclient -g http:\/\/192.168.1.20/filename.iso -m
o bien
fs0:\> webclient -g http:\/\/www.hp.com/filename.iso -m
o bien
fs0:\> webclient -g ftp:\/\/192.168.1.20/filename.iso -m
Para descargar un archivo desde un servidor FTP o HTTP y guardarlo en el sistema de archivos
actual:
fs0:\> webclient -g http:\/\/192.168.1.20/file.html -o file.html
Comandos de UEFI Shell
59
o bien
fs0:\> webclient -g ftp:\/\/192.168.1.20/file.html -o file.html
o bien
fs0:\> webclient -g ftp:\/\/ftp.hp.com/file.html
-o file.html
Para descargar un archivo desde un servidor FTP con el nombre de usuario usuario y la
contraseña contr:
fs0:\> webclient -g ftp:\/\/usuario:[email protected]/file.html -o file.html
Para mostrar la configuración de la red:
fs0:\> webclient -l
60
Referencia de comandos de UEFI Shell
3 Ejecución y edición de las secuencias de comandos clave
de UEFI Shell
En este capítulo se describe cómo ejecutar y modificar las funciones de secuencias de comandos
de UEFI Shell. También se facilita una aplicación de ejemplo que muestra el texto "Hello World".
Llamada a las secuencias de comandos
Es posible llamar a las secuencias de comandos de UEFI Shell con cualquiera de los dos métodos
siguientes:
•
«Configuración del inicio automático de la secuencia de comandos de UEFI Shell en las
utilidades del sistema» (página 61)
•
«Llamada manual a una secuencia de comandos del shell» (página 61)
Configuración del inicio automático de la secuencia de comandos de UEFI Shell en
las utilidades del sistema
La secuencia de comandos de inicio permite crear un disco de RAM, descargar archivos de la
red, recopilar datos, volver a cargar resultados en la red y, a continuación, arrancar el sistema
operativo sin necesidad de reiniciar el sistema. Puede almacenar el archivo de secuencias de
comandos en un soporte local o acceder a él desde una ubicación de red.
De forma predeterminada, la opción UEFI Shell Script Auto-Start (Inicio automático de la secuencia
de comandos de UEFI Shell) está activada en las utilidades del sistema y está configurada para
que el shell busque el archivo startup.nsh en cualquier sistema de archivos FAT16 o FAT32
disponible. Puede modificar esta configuración para que el shell busque la secuencia de comandos
de inicio en un sistema de archivos específico en los soportes conectados o en una ubicación de
red determinada. Cuando se configura para una ubicación de red, se puede especificar la dirección
URL del archivo startup.nsh en formato HTTP o FTP. Para obtener más información, consulte
“Inicio automático de la secuencia de comandos de UEFI Shell” en la Guía de usuario de las
utilidades del sistema HP UEFI para cartuchos de servidor HP ProLiant m400.
Llamada manual a una secuencia de comandos del shell
Para llamar manualmente a una secuencia de comandos del shell:
1. Vaya a la ubicación del archivo de secuencia de comandos .nsh.
2. Haga doble clic en el archivo o haga clic con el botón secundario en el archivo y, a
continuación, seleccione Open (Abrir).
Edición de secuencias de comandos del shell
Puede editar los archivos de secuencias de comandos sin conexión o en el shell mediante el
comando edit. También puede utilizar el comando type para mostrar la secuencia de comandos
en la pantalla.
Ejemplos de secuencias de comandos de UEFI Shell
Secuencia de comandos con el código fuente de una aplicación
El siguiente código fuente de ejemplo muestra cómo implementar una aplicación de UEFI Shell
para imprimir "Hello World" en la pantalla y mostrar la versión y las variables de entorno de
UEFI Shell.
Ejemplo de exportación:
fs0:\>
Llamada a las secuencias de comandos
61
@echo -off
cls
set -v myfs 0
if exist FS0:\* then
FS0:
echo "FS0:\ Found!"
goto FSFOUND
endif
echo "FS0:\ not found in system"
echo "Going to search first available file system from FS1, FS2,..., FS100"
pause
for %a run (1 100)
set -v myfs %a
if exist FS%myfs%:\* then
FS%myfs%:
echo "FS%myfs%:\ Found!"
goto FSFOUND
endif
endfor
## No valid FS found in system, so exit now
echo "No valid File System (FS0, FS1,..., FS100) found in system"
goto END
:FSFOUND
if exist sysconfig_backup.txt then
echo ===========================================================================
echo "%cwd%sysconfig_backup.txt already exists! Continuing the execution of the"
echo "script will remove existing sysconfig_backup.txt file and create a new"
echo "latest system configuration sysconfig_backup.txt file."
echo ===========================================================================
pause
rm sysconfig_backup.txt
endif
echo "Saving latest system configuration in sysconfig_backup.txt file."
sysconfig -export sysconfig_backup.txt
:END
set -d myfs
Ejemplo de importación:
fs0:\>
@echo -off
cls
set -v myfs 0
if exist FS0:\sysconfig_backup.txt then
FS0:
echo "FS0:\sysconfig_backup.txt Found!"
goto FSFOUND
endif
echo ===========================================================================
echo "FS0:\sysconfig_backup.txt not found in system"
echo "Going to search sysconfig_backup.txt from all available file system"
echo "from FS1, FS2,..., FS100"
echo ===========================================================================
pause
for %a run (1 100)
set -v myfs %a
if exist FS%myfs%:\sysconfig_backup.txt then
FS%myfs%:
echo "FS%myfs%:\sysconfig_backup.txt Found!"
goto FSFOUND
endif
endfor
## No valid sysconfig_backup.txt found in system, so exit now
echo "No valid sysconfig_backup.txt found from File System (FS0, FS1,..., FS100)"
goto END
:FSFOUND
if exist sysconfig_backup.txt then
echo ===========================================================================
echo "%cwd%sysconfig_backup.txt Found! Continuing the execution of the script"
echo "will cause system to override previous configuration and use the"
echo "configuration settings stored in sysconfig_backup.txt file."
62
Ejecución y edición de las secuencias de comandos clave de UEFI Shell
echo ===========================================================================
pause
sysconfig -import sysconfig_backup.txt
endif
:END
set -d myfs
Ejemplos de secuencias de comandos de UEFI Shell
63
4 Uso del modelo de programación de UEFI
UEFI Shell ofrece una API de programación. Puede utilizar dicha API para escribir sus propias
aplicaciones UEFI para llamar a determinadas API o protocolos de programación del shell. Para
obtener más información, consulte la Especificación de UEFI Shell y EDK2. Tal como se muestra
en la tabla siguiente, UEFI Shell dispone de una API de programación. La función
EFI_SHELL_PROTOCOL proporciona servicios de shell a las aplicaciones de UEFI. Esta función
proporciona a las aplicaciones de UEFI Shell acceso a las funciones de bajo nivel del shell como,
por ejemplo, los archivos, las canalizaciones, las variables de entorno, el directorio de trabajo
actual, las asignaciones, el texto de ayuda, los alias o las secuencias de comandos y aplicaciones
del shell de inicio.
Tabla 12 API de aplicaciones UEFI
64
Tipo de función
Nombre de función
Descripción
EFI_SHELL_EXECUTE
Execute
Hace que el shell analice y
ejecute la línea de comandos.
EFI_SHELL_GET_ENV
GetEnv
Obtiene la variable de entorno.
EFI_SHELL_SET_ENV
SetEnv
Modifica una variable de
entorno específica.
EFI_SHELL_GET_ALIAS
GetAlias
Recupera el alias de un
comando del shell específico.
EFI_SHELL_SET_ALIAS
SetAlias
Añade o quita el alias de un
comando del shell específico.
EFI_SHELL_GET_HELP_TEXT
GetHelpText
Devuelve información de ayuda
sobre un comando específico.
EFI_SHELL_GET_DEVICE_PATH_FROM_MAP
GetDevicePathFromMap
Devuelve la ruta del dispositivo
correspondiente a una
asignación.
EFI_SHELL_GET_MAP_FROM_DEVICE_PATH
GetMapFromDevicePath
Devuelve la asignación que
corresponde a una ruta de
dispositivo determinada.
EFI_SHELL_GET_DEVICE_PATH_FROM_FILE_PATH
GetDevicePathFromFilePath
Convierte una ruta de archivo
en una ruta de dispositivo,
donde se han sustituido todas
las asignaciones por las rutas
de dispositivo correspondientes.
EFI_SHELL_GET_FILE_PATH_FROM_DEVICE_PATH
GetFilePathFromDevicePath
Convierte una ruta de
dispositivo en una ruta de
archivo, la parte de la ruta del
dispositivo correspondiente a
una de las asignaciones se
sustituye por dicha asignación.
EFI_SHELL_SET_MAP
SetMap
Crea, actualiza o elimina una
asignación entre un dispositivo
y una ruta de dispositivo.
EFI_SHELL_GET_CUR_DIR
GetCurDir
Devuelve el directorio actual de
un dispositivo.
EFI_SHELL_SET_CUR_DIR
SetCurDir
Cambia el directorio actual de
un dispositivo.
EFI_SHELL_OPEN_FILE_LIST
OpenFileList
Abre los archivos que coinciden
con el patrón de ruta
especificado.
Uso del modelo de programación de UEFI
Tabla 12 API de aplicaciones UEFI (continuación)
Tipo de función
Nombre de función
Descripción
EFI_SHELL_FREE_FILE_LIST
FreeFileList
Libera la lista de archivos que
se creó mediante OpenFileList().
EFI_SHELL_REMOVE_DUP_IN_FILE_LIST
RemoveDupInFileList
Elimina los archivos duplicados
de la lista de archivos
especificada.
EFI_SHELL_BATCH_IS_ACTIVE
BatchIsActive
Muestra si se está procesando
algún archivo de secuencia de
comandos.
EFI_SHELL_IS_ROOT_SHELL
IsRootShell
Comprueba si el shell activo es
el shell raíz.
EFI_SHELL_ENABLE_PAGE_BREAK
EnablePageBreak
Habilita el modo de
visualización de resultados con
saltos de página.
EFI_SHELL_DISABLE_PAGE_BREAK
DisablePageBreak
Deshabilita el modo de
visualización de resultados con
saltos de página.
EFI_SHELL_GET_PAGE_BREAK
GetPageBreak
Obtiene el estado de
habilitación del modo de
visualización de resultados con
saltos de página.
EFI_SHELL_GET_DEVICE_NAME
GetDeviceName
Obtiene el nombre del
dispositivo especificado por el
identificador del dispositivo.
EFI_SHELL_GET_FILE_INFO
GetFileInfo
Muestra información sobre un
identificador de archivo
específico.
EFI_SHELL_SET_FILE_INFO
SetFileInfo
Modifica información sobre un
identificador de archivo
específico.
EFI_SHELL_OPEN_FILE_BY_NAME
OpenFileByName
Abre un archivo especificado
por el nombre y devuelve un
identificador del archivo.
EFI_SHELL_CLOSE_FILE
CloseFile
Cierra un archivo abierto.
EFI_SHELL_CREATE_FILE
CreateFile
Crea un nuevo archivo.
EFI_SHELL_READ_FILE
ReadFile
Lee los datos de un archivo.
EFI_SHELL_WRITE_FILE
WriteFile
Escribe datos en un archivo.
EFI_SHELL_DELETE_FILE
DeleteFile
Elimina un archivo.
EFI_SHELL_DELETE_FILE_BY_NAME
DeleteFileByName
Permite eliminar un archivo por
su nombre.
EFI_SHELL_GET_FILE_POSITION
GetFilePosition
Muestra la posición de
lectura/escritura actual dentro
de un archivo.
EFI_SHELL_SET_FILE_POSITION
SetFilePosition
Modifica la posición de
lectura/escritura actual dentro
de un archivo.
EFI_SHELL_FLUSH_FILE
FlushFile
Escribe todos los datos
almacenados en búfer en un
archivo.
65
Tabla 12 API de aplicaciones UEFI (continuación)
66
Tipo de función
Nombre de función
Descripción
EFI_SHELL_FIND_FILES
FindFiles
Muestra todos los archivos que
coincidan con un patrón en una
lista de archivos.
EFI_SHELL_FIND_FILES_IN_DIR
FindFilesInDir
Muestra todos los archivos de
un directorio especificado en
una lista de archivos.
EFI_SHELL_GET_FILE_SIZE
GetFileSize
Muestra el tamaño de un
archivo.
EFI_SHELL_OPEN_ROOT
OpenRoot
Muestra el directorio raíz de un
sistema de archivos.
EFI_SHELL_OPEN_ROOT_BY_HANDLE
OpenRootByHandle
Muestra el directorio raíz de un
sistema de archivos en un
identificador determinado.
EFI_EVENT
ExecutionBreak
Evento que muestra UEFI Shell
cuando el usuario pulsa CTRL-C
para indicar que la ejecución
del comando de UEFI Shell
actual debe interrumpirse.
UINT32
MajorVersion
Versión principal del entorno del
shell.
UINT32
MinorVersion
Versión secundaria del entorno
del shell.
Uso del modelo de programación de UEFI
5 Códigos de estado de comandos de UEFI Shell
En la tabla siguiente se enumeran los códigos de estado que puede mostrar UEFI Shell cuando se
ejecuta un comando. Los códigos varían según el comando.
Tabla 13 Códigos de estado de los comandos clave de UEFI Shell
Código de estado
Descripción
SHELL_SUCCESS
La acción se completó tal como se solicitó.
SHELL_NOT_FOUND
No se pudo encontrar el archivo o conjunto de archivos de destino.
SHELL_SECURITY_VIOLATION
La función no se puede realizar debido a una infracción de seguridad.
Cuando esté habilitado el arranque seguro, las aplicaciones UEFI que no
estén firmadas digitalmente con uno de los certificados de arranque seguro
integrados no podrán ejecutarse y el sistema mostrará el código de estado
SECURITY_VIOLATION.
SHELL_INVALID_PARAMETER
Uno de los parámetros pasados tiene un formato incorrecto o tiene un
valor que está fuera de los límites.
SHELL_OUT_OF_RESOURCES
No se pudo completar una solicitud para establecer una variable de forma
no volátil. La solicitud no volátil resultante se convierte en una solicitud
volátil.
SHELL_WRITE_PROTECTED
El soporte en el que se llevará a cabo la acción está protegido contra
escritura.
SHELL_DEVICE_ERROR
Error de hardware que impide la finalización de este comando.
67
6 Asistencia y otros recursos
Contacto con HP
Para obtener información de soporte técnico sobre todos los países, visite la página del Centro
de soporte de HP:
http://www.hp.com/go/hpsc
Antes de ponerse en contacto con HP, recopile la información siguiente:
•
Nombre y número del modelo del producto
•
Número de registro de asistencia técnica (si corresponde)
•
Números de serie del producto
•
Mensajes de error
•
Tipo y revisión del sistema operativo
•
Preguntas detalladas
Servicio de subscripción
Inicie sesión en http://www.hp.com/go/myadvisory para recibir por correo electrónico, avisos
sobre comunicaciones de soporte de productos, actualizaciones de controladores, revisiones de
software, actualizaciones de firmware o información sobre consumibles.
Para cambiar las opciones de alertas de soporte que recibe actualmente, haga clic en el enlace
Sign in (Iniciar sesión) de la derecha.
Acceso a los materiales de soporte de HP
El acceso a algunas actualizaciones puede requerir la concesión del producto cuando se acceda
a través del Centro de soporte de HP. Debe disponer de una cuenta HP Passport configurada con
las concesiones correspondientes. Para obtener más información, consulte la página web:
www.hp.com/support/AccessToSupportMaterials
Información relacionada
La documentación más reciente para las utilidades del sistema HP UEFI y Embedded Shell está
disponible en: http://www.hp.com/go/ProLiantUEFI/docs o en http://www.hp.com/go/moonshot/
docs. Los documentos disponibles incluyen:
68
•
Guía de usuario de las utilidades del sistema HP UEFI para cartuchos de servidor HP ProLiant
m400
•
Guía de usuario de HP UEFI Shell para cartuchos de servidor HP ProLiant m400
•
Tarjeta de referencia rápida de HP UEFI Shell para cartuchos de servidor HP ProLiant m400
•
Notas de la versión del shell y las utilidades del sistema HP UEFI para cartuchos de servidor
HP ProLiant m400
•
Guía de usuario de implementación del sistema operativo en los cartuchos de servidor
HP ProLiant Moonshot
•
Guía de mantenimiento y del usuario del cartucho del servidor HP ProLiant m400
•
Guía de usuario de la CLI de HP Moonshot iLO Chassis Management
•
Guía de usuario de la interfaz web de HP Moonshot iLO Chassis Management
Asistencia y otros recursos
Páginas web
•
Especificación de UEFI: http://www.uefi.org/specifications
•
Recursos de aprendizaje de UEFI: http://www.uefi.org/learning_center
•
Proyecto UEFI EDK2 en SourceForge (descarga de especificaciones y código): http://
sourceforge.net/apps/mediawiki/tianocore
Convenciones tipográficas
Tabla 14 Convenciones del documento
Convención
Elemento
Texto azul: Tabla 14, «Convenciones del
documento»
• Vínculos de referencia cruzada y direcciones de correo
electrónico
• Referencia cruzada a la definición del glosario del
término en texto azul
Texto azul subrayado en negrita
Direcciones de correo electrónico
Azul, texto subrayado: http://www.hp.com
Direcciones de páginas web
Texto en Negrita
• Teclas que se pulsan
• Texto escrito en un elemento de la interfaz gráfica del
usuario, como por ejemplo un cuadro
• Elementos de la interfaz gráfica del usuario que se
seleccionan o sobre los que se hace clic, como los
elementos de menú y de listas, los botones, las fichas y
las casillas de verificación
Texto en cursiva
Énfasis del texto
Texto monoespaciado
• Nombres de archivos y directorios
• Salida del sistema
• Código
• Comandos, sus argumentos y valores de argumentos
Texto monoespaciado, en cursiva
• Variables de código
• Variables de comando
Texto monoespaciado, en negrita
Texto con fuente monoespaciada resaltado
¡ADVERTENCIA! Indica que si no se siguen las instrucciones podrían producirse daños personales
o incluso la muerte.
ATENCIÓN:
IMPORTANTE:
NOTA:
Indica que si no se siguen las instrucciones se pueden dañar los equipos o los datos.
Proporciona información aclaratoria o instrucciones específicas.
Proporciona información adicional.
SUGERENCIA:
Proporciona sugerencias y accesos directos.
Convenciones tipográficas
69
HP Insight Remote Support
HP recomienda registrar el dispositivo para obtener asistencia remota y habilitar la distribución
mejorada de su garantía de HP, del servicio HP Care Pack o del acuerdo de asistencia contractual
de HP. HP Insight Remote Support complementa su supervisión de manera continua para garantizar
la máxima disponibilidad de sistema proporcionando diagnósticos de eventos inteligentes y
presentaciones automáticas y seguras de notificaciones de eventos de hardware a HP, que iniciará
una resolución rápida y adecuada basándose en su nivel de servicio de producto. Las notificaciones
se pueden enviar a su distribuidor del canal autorizado de HP para un servicio in situ, si está
configurado y disponible en su país.
HP Insight Remote Support está disponible como parte de la garantía de HP, del servicio HP Care
Pack o del acuerdo de soporte contractual de HP. Para obtener más información, consulte la
documentación del producto en la página web de HP (http://www.hp.com/go/
insightremotesupport/docs).
70
Asistencia y otros recursos
7 Comentarios sobre la documentación
HP se compromete a proporcionar documentación que se adapte a sus necesidades. Para
ayudarnos a mejorar la documentación, envíe cualquier error, sugerencia o comentario a
Comentarios sobre la documentación ([email protected]). Incluya en el mensaje el título del
documento y el número de referencia, el número de versión o la URL.
71
Glosario
EFI
Extensible Firmware Interface (Interfaz de firmware extensible)
iLO
Integrated Lights-Out
POST
Power-On Self-Test (Autocomprobación al arrancar)
PXE
Preboot Execution Environment (Entorno de ejecución previo al arranque)
SMBIOS
System Management BIOS (BIOS de gestión del sistema)
UEFI
Unified Extensible Firmware Interface (Interfaz de firmware extensible unificada)
VSP
Virtual Serial Port (Puerto serie virtual)
72
Glosario
Índice
A
acceso a un sistema de archivos, 17
alias, 18
análisis, 47
aplicación, API, 64
árbol de dispositivos, 28
archivos
actualización de la fecha y la hora, 56
comparación, 23
configuración del tamaño, 53
copia, 24
EFI, descompresión, 35
eliminación, 50
envío del contenido a un dispositivo de salida, 56
información del volumen, 58
listado, 39
manipulación, 5
transferencia a través de FTP, 36
asignación de nombres e identificadores de dispositivos,
42
atributos, 19
atributos de archivo y directorio , 19
ayuda, 13, 14, 37
obtención, 68
B
bloques de dispositivo, 27
boot, 20
C
cambio de directorio, 21
color de fondo, 22
comandos de UEFI Shell, 18
alias, 18
attrib, 19
bcfg, 20
boot, 20
cd, 21
cls, 22
comp, 23
connect, 23
cp, 24
date, 26
dblk, 27
devices, 27
devtree, 28
dh, 29
disconnect, 31
dmem, 32
drivers, 32
echo, 33
edit, 34
eficompress, 35
efidecompress, 35
exit, 35
ftp, 36
getmtc, 36
goto, 37
help, 37
ifconfig, 38
load, 39
ls, 39
map, 42
memmap, 43
mkdir, 45
mode, 46
mv, 46
openinfo, 47
parse, 47
pause, 48
pci, 49
ping, 49
reset, 50
rm/del, 50
set, 52
setsize, 53
shift, 53
smbiosview, 53
stall, 54
sysinfo, 54
time, 55
timezone, 55
touch, 56
type, 56
unload, 57
ver, 57
vol, 58
webclient, 59
comandos del shell de HP, 9
comandos y capacidades, 5
comandos, descripciones
componentes de la sección, 18
comparación de archivos, 23
configuración de red previa al arranque, 38
configuración del tamaño de archivos, 53
confirmación, solicitud, 12
contacto con HP, 68
contador monotónico, 36
control del resultado de los comandos, 10
controladores, 32
carga, 39
descarga, 57
enlace, 23
convenciones
documento, 69
símbolos en el texto, 69
convenciones tipográficas, 69
copia de archivos y directorios, 24
D
del, alias, 50
73
descarga de archivos desde HTTP o FTP, 59
descarga de una imagen de controlador, 57
descompresión de EFI, 35
desconexión de controladores de dispositivos, 31
detalles de los resultados
comando devices, 28
comando dh, 31
comando drivers, 33
comando ls (información de archivo), 42
comando ls (información del volumen), 41
comando memmap, 45
detención de la ejecución de secuencias de comandos,
54
dir, alias, 39
directorios
cambio, 21
creación, 45
eliminación, 50
listado, 39
dispositivos, 27
documentación
envío de comentarios sobre, 71
documentación relacionada, 68
documento
convenciones, 69
información relacionada, 68
E
echo, 33
edición de archivos, 34
edición, secuencias de comandos del shell, 61
ejemplo, secuencias de comandos del shell, 61
ejemplos de sintaxis, 9
ejemplos de sintaxis de comandos del shell, 9
eliminación de la solicitud de confirmación al usuario, 12
enlace de controladores, 23
F
fecha, 26
fecha del sistema, 26
firmware
visualización de la versión de UEFI, 57
G
goto, 37
H
hora del sistema, 55
horario de verano, 55
HP
soporte técnico, 68
suscripción, servicio, 68
HP ProLiant, pantalla de la POST, 5
HTTP
descarga de archivos, 59
I
identificadores de dispositivos, 29
ifconfig, 38
74
Índice
información de la versión, 57
información de SMBIOS, 53
información del sistema, 54
información sobre archivos o directorios, 39
información sobre PCI, 49
Insight Remote Support, 70
introducción, 5
ISO
montaje de un sistema de archivos, 59
L
línea de comandos, autocompletado, 9
línea de comandos, ayuda, 13, 14
llamada, secuencias de comandos, 61
load, 39
LL
llamada, secuencias de comandos, 61
M
manual, llamada a secuencia de comandos del shell, 61
map, 42
memoria
asignación, 43
visualización, 32
mkdir, 45
modificación de la dirección de la pila de red IPv4, 38
modo
salida de la consola, 46
modo de salida de la consola, 46
montaje de un sistema de archivos ISO, 59
MTC, 36
O
opciones
arranque, 20
openinfo, 47
P
páginas web, 69
pausa, 48
ping, 49
primeros pasos, 10
protocolos y agentes de un identificador, 47
R
referencia de comandos de UEFI Shell, 9
reinicio del sistema, 50
restablecimiento del sistema, 50
resultado
control, 10
detallado, 11
resumido, 12
una sola pantalla a la vez, 10
S
salida del shell o de una secuencia de comandos, 35
saltos de página globales, 11
secuencias de comandos, 5
búsqueda de una etiqueta, 37
desplazamiento de contenido, 53
detención de la ejecución, 54
pausa, 48
salida, 35
visualización, 33
servicio de suscripción, HP, 68
shell, llamada manual a una secuencia de comandos, 61
shell, secuencias de comandos
edición, 61
ejemplos, 61
llamada manual, 61
símbolos en el texto, 69
sintaxis de la línea de comandos, 9
sistema de archivos, 17
sitios web
HP, servicio de suscripción, 68
soporte remoto, 70
soporte técnico, 69
HP, 68
T
tareas comunes, 17
teclas de autocompletado de la línea de comandos, 9
texto, símbolos, 69
touch, 56
transferencia FTP, 36, 59
traslado de archivos, 46
type, 56
U
UEFI Shell, códigos de estado de comandos
códigos de estado, 67
UEFI Shell, estado de los comandos
códigos de estado, significado, 67
UEFI, API de aplicación, 64
UEFI, modelo de programación, 64
URL
recuperación de archivos, 59
utilidades del sistema
acceso, 5
V
variables
entorno, 52
visualización de ayuda sobre los comandos, 37
visualización de la ayuda de los comandos, 13
comandos que empiezan por un carácter específico,
15
para un comando específico, 14
todos los comandos, 13
volumen, 58
W
webclient, 59
Z
zona horaria, 55
75