projects / mirror_edk2.git / blame
| Commit | Line | Data |
|---|---|---|
| e329f98b JJ |
1 | // /**\r |
| 2 | //\r | |
| 03a5572b | 3 | // (C) Copyright 2016-2017 Hewlett Packard Enterprise Development LP<BR>\r |
| e329f98b | 4 | // (C) Copyright 2012-2015 Hewlett-Packard Development Company, L.P.<BR>\r |
| ba0014b9 | 5 | // Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>\r |
| e329f98b JJ |
6 | // This program and the accompanying materials\r |
| 7 | // are licensed and made available under the terms and conditions of the BSD License\r | |
| 8 | // which accompanies this distribution. The full text of the license may be found at\r | |
| 9 | // http://opensource.org/licenses/bsd-license.php.\r | |
| 10 | //\r | |
| 11 | // THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
| 12 | // WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
| 13 | //\r | |
| 14 | // Module Name:\r | |
| 15 | //\r | |
| 16 | // UefiShellDriver1CommandsLib.uni\r | |
| 17 | //\r | |
| 18 | // Abstract:\r | |
| 19 | //\r | |
| 20 | // String definitions for UEFI Shell 2.0 driver1 profile commands\r | |
| 21 | //\r | |
| 22 | //\r | |
| 23 | // **/\r | |
| 24 | \r | |
| 25 | /=#\r | |
| 26 | \r | |
| 27 | #langdef en-US "english"\r | |
| 28 | \r | |
| 29 | #string STR_GEN_PROBLEM #language en-US "%H%s%N: Unknown flag - '%H%s%N'\r\n"\r | |
| 30 | #string STR_GEN_PROBLEM_VAL #language en-US "%H%s%N: Bad value - '%H%s%N' for flag - '%H%s%N'\r\n"\r | |
| 31 | #string STR_GEN_PARAM_INV #language en-US "%H%s%N: Invalid argument - '%H%s%N'\r\n"\r | |
| 32 | #string STR_GEN_TOO_FEW #language en-US "%H%s%N: Too few arguments\r\n"\r | |
| 33 | #string STR_GEN_TOO_MANY #language en-US "%H%s%N: Too many arguments\r\n"\r | |
| 34 | #string STR_GEN_INV_HANDLE #language en-US "%H%s%N: Handle - '%H%s%N' not found\r\n"\r | |
| 35 | #string STR_GEN_PARAM_CONFLICT #language en-US "%H%s%N: Flags conflict with - '%H%s%N' and '%H%s%N'\r\n"\r | |
| 36 | #string STR_GEN_NO_VALUE #language en-US "%H%s%N: Missing argument for flag - '%H%s%N'\r\n"\r | |
| 37 | #string STR_GEN_HANDLE_NOT #language en-US "%H%s%N: Handle [%H%02x%N] is not a valid %s\r\n"\r | |
| 38 | #string STR_GEN_HANDLE_REQ #language en-US "%H%s%N: Handle required with the specified options\r\n"\r | |
| 39 | #string STR_GEN_PROTOCOL_NF #language en-US "%H%s%N: The protocol '%H%s%N' is required and not found (%g)\r\n"\r | |
| 40 | #string STR_GEN_FIND_FAIL #language en-US "%H%s%N: File not found - '%H%s%N'\r\n"\r | |
| 41 | #string STR_GEN_FILE_EXIST #language en-US "%H%s%N: File already exists - '%H%s%N'\r\n"\r | |
| 42 | #string STR_GEN_FILE_OPEN_FAIL #language en-US "%H%s%N: Cannot open file - '%H%s%N'\r\n"\r | |
| 43 | #string STR_FILE_WRITE_FAIL #language en-US "%H%s%N: Write file error - '%H%s%N'\r\n"\r | |
| 44 | #string STR_FILE_READ_FAIL #language en-US "%H%s%N: Read file error - '%H%s%N'\r\n"\r | |
| 45 | #string STR_GEN_OUT_MEM #language en-US "%H%s%N: Memory allocation was not successful\r\n"\r | |
| 46 | #string STR_GEN_UEFI_FUNC_ERROR #language en-US "%H%s%N: UEFI function '%H%s%N' returned an incorrect value for: %s (%x)\r\n"\r | |
| 47 | #string STR_GEN_UEFI_FUNC_WARN #language en-US "%H%s%N: UEFI function '%H%s%N' returned: %r\r\n"\r | |
| 48 | #string STR_GEN_SFO_HEADER #language en-US "ShellCommand,"%s"\r\n"\r | |
| 49 | \r | |
| 50 | #string STR_DRVDIAG_HEADER #language en-US "%EAvailable Diagnostics%N.\r\n"\r | |
| 51 | #string STR_DRVDIAG_DRIVER_HEADER #language en-US "Driver [%H%02x%N]: "\r | |
| 52 | #string STR_DRVDIAG_DRIVER_NO_HANDLES #language en-US "No controller handles found.\r\n"\r | |
| 53 | \r | |
| 54 | #string STR_HANDLE_RESULT #language en-US "%H%s%N - Handle [%H%02x%N] Result %r.\r\n"\r | |
| 55 | #string STR_3P_RESULT #language en-US "%H%s%N - (%H%02x%N,%H%02x%N,%H%02x%N) Result %r.\r\n"\r | |
| 56 | #string STR_CONNECT_NONE #language en-US "%HConnect%N No drivers could be connected.\r\n"\r | |
| 57 | \r | |
| 58 | #string STR_DRVCFG_NONE_FOUND #language en-US "%HDrvCfg%N No configurable devices were found.\r\n"\r | |
| 59 | #string STR_DRVCFG_COMP #language en-US "%HDrvCfg%N - operation complete.\r\n"\r | |
| 60 | #string STR_DRVCFG_DONE_HII #language en-US "Handle[%H%02x%N] successfully updated from file.\r\n"\r | |
| 61 | #string STR_DRVCFG_LINE_HII #language en-US "Handle[%H%02x%N] HII Config Access\r\n"\r | |
| 62 | #string STR_DRVCFG_ALL_LANG #language en-US "Driver[%H%02x%N] Ctrl[--] Lang[%H%a%N] Driver Configuration"\r | |
| 63 | #string STR_DRVCFG_CTRL_LANG #language en-US "Driver[%H%02x%N] Ctrl[%H%02x%N] Lang[%H%a%N] Driver Configuration"\r | |
| 64 | #string STR_DRVCFG_CHILD_LANG #language en-US "Driver[%H%02x%N] Ctrl[%H%02x%N] Child[%H%02x%N] Lang[%H%a%N] Driver Configuration"\r | |
| 65 | #string STR_DRVCFG_RESTART_S #language en-US "Restart %s\r\n"\r | |
| 66 | #string STR_DRVCFG_STOP #language en-US "Stop Controller\n"\r | |
| 67 | #string STR_DRVCFG_ENTER_S #language en-US "\nPress [ENTER] to %s"\r | |
| 68 | #string STR_DRVCFG_NONE #language en-US "None\n"\r | |
| 69 | #string STR_DRVCFG_CTLR_S #language en-US "Controller %s\n"\r | |
| 70 | #string STR_DRVCFG_FORCE_D #language en-US "Force Default Configuration to DefaultType %08x\n"\r | |
| 71 | #string STR_DRVCFG_VALIDATE #language en-US "Validate Configuration Options\n"\r | |
| 72 | #string STR_DRVCFG_SET #language en-US "Set Configuration Options\n"\r | |
| 73 | #string STR_DRVCFG_NOT_SUPPORT #language en-US "Handle [%H%02x%N] does not support configuration.\n"\r | |
| 74 | #string STR_DRVCFG_OPTIONS_SET #language en-US " - Options set. Action Required is "\r | |
| 75 | #string STR_DRVCFG_NOT_SET #language en-US " - Options not set. Status = %r\n"\r | |
| 76 | #string STR_DRVCFG_DEF_FORCED #language en-US " - Defaults forced. Action Required is "\r | |
| 77 | #string STR_DRVCFG_FORCE_FAILED #language en-US " - Force of defaults failed. Status = %r\n"\r | |
| 78 | #string STR_DRVCFG_OPTIONS_VALID #language en-US " - Options valid\n"\r | |
| 79 | #string STR_DRVCFG_OPTIONS_INV #language en-US " - Options not valid. Status = %r\n"\r | |
| 80 | #string STR_DRVCFG_IN_FILE_NF #language en-US "DevicePath '%B%s%N' from file not found in HII DB. Skipped.\r\n"\r | |
| 81 | \r | |
| 82 | \r | |
| 83 | #string STR_DEVICES_HEADER_LINES #language en-US "%N"\r | |
| 84 | " T D\r\n"\r | |
| 85 | " Y C I\r\n"\r | |
| 86 | " P F A\r\n"\r | |
| 87 | "CTRL E G G #P #D #C Device Name\r\n"\r | |
| 88 | "==== = = = == == === =========================================================\r\n"\r | |
| 89 | #string STR_DEVICES_ITEM_LINE #language en-US "%H%4x%N %1c %1c %1c %2d %2d %3d %s\r\n"\r | |
| 90 | #string STR_DEVICES_ITEM_LINE_SFO #language en-US "DevicesInfo,"%x","%c","%c","%c","%d","%d","%d","%s"\r\n"\r | |
| 91 | \r | |
| 92 | #string STR_DRIVERS_HEADER_LINES #language en-US "%N"\r | |
| d506d8db HL |
93 | "%H T D%N\r\n"\r |
| 94 | "%HD Y C I%N\r\n"\r | |
| 95 | "%HR P F A%N\r\n"\r | |
| 96 | "%HV VERSION E G G #D #C DRIVER NAME IMAGE NAME%N\r\n"\r | |
| 97 | "== ======== = = = == == =================================== ==========\r\n"\r | |
| 98 | #string STR_DRIVERS_ITEM_LINE #language en-US "%H%2x%N %08x %1c %1c %1c %2s %2s %-35s %s\r\n"\r | |
| e329f98b JJ |
99 | #string STR_DRIVERS_ITEM_LINE_SFO #language en-US "DriversInfo,"%x","%x","%c","%c","%c","%d","%d","%s","%s"\r\n"\r |
| 100 | \r | |
| de8cea6f RN |
101 | #string STR_DH_OUTPUT_DECODE #language en-US "%s: %g\r\n"\r |
| 102 | #string STR_DH_NO_NAME_FOUND #language en-US "Protocol Name '%s' could not be identified.\r\n"\r | |
| 103 | #string STR_DH_NO_GUID_FOUND #language en-US "Protocol GUID '%g' could not be identified.\r\n"\r | |
| e329f98b JJ |
104 | #string STR_DH_SFO_OUTPUT #language en-US "%s, %s, %H%02x%N, %s, &s\r\n"\r |
| 105 | #string STR_DH_OUTPUT #language en-US "%H%02x%N: %s\r\n"\r | |
| de8cea6f RN |
106 | #string STR_DH_OUTPUT_ALL_HEADER #language en-US "Handle dump\r\n"\r |
| 107 | #string STR_DH_OUTPUT_GUID_HEADER #language en-US "Handle dump by protocol '%g'\r\n"\r | |
| 108 | #string STR_DH_OUTPUT_NAME_HEADER #language en-US "Handle dump by protocol '%s'\r\n"\r | |
| 590351cf | 109 | #string STR_DH_OUTPUT_SINGLE_D #language en-US "%H%02x%N: %s\r\n"\r |
| e329f98b JJ |
110 | #string STR_DH_OUTPUT_SINGLE #language en-US "%H%02x%N: %x\r\n%s"\r |
| 111 | #string STR_DH_OUTPUT_SFO #language en-US "%s, %s, %s, %H%02x%N, %s, %s\r\n"\r | |
| abfecbdb HL |
112 | #string STR_DH_OUTPUT_DRIVER1 #language en-US " Controller Name : %H%s%N\r\n"\r |
| 113 | #string STR_DH_OUTPUT_DRIVER2 #language en-US " Device Path : %H%s%N\r\n"\r | |
| 114 | " Controller Type : %H%s%N\r\n"\r | |
| 115 | " Configuration : %H%s%N\r\n"\r | |
| 116 | " Diagnostics : %H%s%N\r\n"\r | |
| 117 | #string STR_DH_OUTPUT_DRIVER3 #language en-US " Managed by : %H%s%N\r\n"\r | |
| 118 | #string STR_DH_OUTPUT_DRIVER4A #language en-US " Drv[%H%02x%N] : Image(%H%s%N)r\n"\r | |
| 119 | #string STR_DH_OUTPUT_DRIVER4B #language en-US " Drv[%H%02x%N] : %H%s%N\r\n"\r | |
| 120 | #string STR_DH_OUTPUT_DRIVER5 #language en-US " Parent Controllers : %H%s%N\r\n"\r | |
| 121 | #string STR_DH_OUTPUT_DRIVER5B #language en-US " Parent[%H%02x%N] : %H%s%N\r\n"\r | |
| 122 | #string STR_DH_OUTPUT_DRIVER6 #language en-US " Child Controllers : %H%s%N\r\n"\r | |
| 123 | #string STR_DH_OUTPUT_DRIVER6B #language en-US " Child[%H%02x%N] : %H%s%N\r\n"\r | |
| 5bfd23eb | 124 | #string STR_DH_OUTPUT_DRIVER6C #language en-US " Child[%H%02x%N] : %H%s%N\r\n"\r |
| abfecbdb HL |
125 | #string STR_DH_OUTPUT_DRIVER7 #language en-US " Driver Name [%H%02x%N] : %H%s%N\r\n"\r |
| 126 | #string STR_DH_OUTPUT_DRIVER7B #language en-US " Driver Image Name : %H%s%N\r\n"\r | |
| 127 | #string STR_DH_OUTPUT_DRIVER8 #language en-US " Driver Version : %H%08x%N\r\n"\r | |
| 128 | " Driver Type : %H%s%N\r\n"\r | |
| 129 | " Configuration : %H%s%N\r\n"\r | |
| 130 | " Diagnostics : %H%s%N\r\n"\r | |
| 131 | #string STR_DH_OUTPUT_DRIVER9 #language en-US " Managing : %H%s%N\r\n"\r | |
| 132 | #string STR_DH_OUTPUT_DRIVER9B #language en-US " Ctrl[%H%02x%N] : %H%s%N\r\n"\r | |
| e329f98b JJ |
133 | \r |
| 134 | #string STR_DEV_TREE_OUTPUT #language en-US "Ctrl[%H%02x%N] %s\r\n"\r | |
| 135 | \r | |
| 136 | #string STR_UNLOAD_CONF #language en-US "%HUnload%N - Handle [%H%02x%N]. [y/n]?\r\n"\r | |
| 137 | #string STR_UNLOAD_VERBOSE #language en-US ""\r | |
| 138 | "Handle [%H%02x%N] (%08x)\r\n"\r | |
| 139 | " Image (%08x)\r\n"\r | |
| 140 | " ParentHandle..: %08x\r\n"\r | |
| 141 | " SystemTable...: %08x\r\n"\r | |
| 142 | " DeviceHandle..: %08x\r\n"\r | |
| 143 | " FilePath......: %s\r\n"\r | |
| 144 | " PDBFileName...: %a\r\n"\r | |
| 145 | " ImageBase.....: %08x\r\n"\r | |
| 146 | " ImageSize.....: %Ld\r\n"\r | |
| 147 | " CodeType......: %s\r\n"\r | |
| 148 | " DataType......: %s\r\n"\r | |
| 149 | \r | |
| 150 | #string STR_OPENINFO_HEADER_LINE #language en-US "Handle %H%02x%N (%H%0p%N)\r\n"\r | |
| 151 | #string STR_OPENINFO_LINE #language en-US " Drv[%H%02x%N] Ctrl[%H%02x%N] Cnt(%H%02x%N) %H%s Image%N(%s)\r\n"\r | |
| 152 | #string STR_OPENINFO_MIN_LINE #language en-US " Drv[%H%02x%N] Ctrl[ ] Cnt(%H%02x%N) %H%s Image%N(%s)\r\n"\r | |
| 153 | \r | |
| 154 | #string STR_DRV_DIAG_ITEM_LINE #language en-US " Drv[%H%02x%N] Ctrl[%H%02x%N] Child[%H%02x%N]\r\n"\r | |
| 155 | \r | |
| 156 | #string STR_GET_HELP_DRVCFG #language en-US ""\r | |
| 157 | ".TH drvcfg 0 "configure a UEFI driver."\r\n"\r | |
| 158 | ".SH NAME\r\n"\r | |
| 159 | "Invokes the driver configuration.\r\n"\r | |
| 160 | ".SH SYNOPSIS\r\n"\r | |
| 161 | " \r\n"\r | |
| 162 | "DRVCFG [-l XXX] [-c] [-f <Type>|-v|-s] \r\n"\r | |
| 163 | " [DriverHandle [DeviceHandle [ChildHandle]]] [-i filename] [-o filename]\r\n"\r | |
| 164 | ".SH OPTIONS\r\n"\r | |
| 165 | " \r\n"\r | |
| 166 | " -c - Configures all child devices.\r\n"\r | |
| 167 | " -l - Configures using the ISO 3066 language specified by XXX.\r\n"\r | |
| 168 | " -f - Forces defaults.\r\n"\r | |
| 169 | " -v - Validates options.\r\n"\r | |
| 170 | " -s - Sets options.\r\n"\r | |
| 171 | " -i - Receives configuration updates from an input file.\r\n"\r | |
| 172 | " -o - Exports the settings of the specified driver instance to a\r\n"\r | |
| 173 | " file.\r\n"\r | |
| 174 | " Type - Specifies the type of default configuration options to force on the\r\n"\r | |
| 175 | " controller.\r\n"\r | |
| 176 | " 0 - Standard Defaults.\r\n"\r | |
| 177 | " 1 - Manufacturing Defaults.\r\n"\r | |
| 178 | " 2 - Safe Defaults.\r\n"\r | |
| 179 | " 4000-FFFF - Custom Defaults.\r\n"\r | |
| 180 | " DriverHandle - Specifies the the handle of the driver to configure.\r\n"\r | |
| 181 | " DeviceHandle - Specifies the handle of a device that the DriverHandle is managing.\r\n"\r | |
| 182 | " ChildHandle - Specifies the handle of a device that is a child of the DeviceHandle. \r\n"\r | |
| 183 | ".SH DESCRIPTION\r\n"\r | |
| 184 | " \r\n"\r | |
| 185 | "NOTES:\r\n"\r | |
| 186 | " 1. Default Type:\r\n"\r | |
| 187 | " 0 - Safe Defaults. Places a controller in a safe configuration with\r\n"\r | |
| 188 | " the greatest probability of functioning correctly in a platform.\r\n"\r | |
| 189 | " 1 - Manufacturing Defaults. Optional type that places the controller in\r\n"\r | |
| 190 | " a configuration suitable for a manufacturing and test environment.\r\n"\r | |
| 191 | " 2 - Custom Defaults. Optional type that places the controller in a\r\n"\r | |
| 192 | " custom configuration.\r\n"\r | |
| 193 | " 3 - Performance Defaults. Optional type that places the controller in a\r\n"\r | |
| 194 | " configuration that maximizes the controller's performance in a \r\n"\r | |
| 195 | " platform. \r\n"\r | |
| 196 | " Other Value - Depends on the driver's implementation.\r\n"\r | |
| 197 | ".SH EXAMPLES\r\n"\r | |
| 198 | " \r\n"\r | |
| 199 | "EXAMPLES:\r\n"\r | |
| 200 | " * To display the list of devices that are available for configuration:\r\n"\r | |
| 201 | " Shell> drvcfg\r\n"\r | |
| 202 | " \r\n"\r | |
| 203 | " * To display the list of devices and child devices that are available for\r\n"\r | |
| 204 | " configuration:\r\n"\r | |
| 205 | " Shell> drvcfg -c\r\n"\r | |
| 206 | " \r\n"\r | |
| 207 | " * To force defaults on all devices:\r\n"\r | |
| 208 | " Shell> drvcfg -f 0\r\n"\r | |
| 209 | " \r\n"\r | |
| 210 | " * To force defaults on all devices that are managed by driver 0x17:\r\n"\r | |
| 211 | " Shell> drvcfg -f 0 17\r\n"\r | |
| 212 | " \r\n"\r | |
| 213 | " * To force defaults on device 0x28 that is managed by driver 0x17:\r\n"\r | |
| 214 | " Shell> drvcfg -f 0 17 28\r\n"\r | |
| 215 | " \r\n"\r | |
| 216 | " * To force defaults on all child devices of device 0x28 that is managed by\r\n"\r | |
| 217 | " driver 0x17:\r\n"\r | |
| 218 | " Shell> drvcfg -f 0 17 28 -c\r\n"\r | |
| 219 | " \r\n"\r | |
| 220 | " * To force defaults on child device 0x30 of device 0x28 that is managed by\r\n"\r | |
| 221 | " driver 0x17:\r\n"\r | |
| 222 | " Shell> drvcfg -f 0 17 28 30\r\n"\r | |
| 223 | " \r\n"\r | |
| 224 | " * To validate options on all devices:\r\n"\r | |
| 225 | " Shell> drvcfg -v\r\n"\r | |
| 226 | " \r\n"\r | |
| 227 | " * To validate options on all devices that are managed by driver 0x17:\r\n"\r | |
| 228 | " Shell> drvcfg -v 17\r\n"\r | |
| 229 | " \r\n"\r | |
| 230 | " * To validate options on device 0x28 that is managed by driver 0x17:\r\n"\r | |
| 231 | " Shell> drvcfg -v 17 28\r\n"\r | |
| 232 | " \r\n"\r | |
| 233 | " * To validate options on all child devices of device 0x28 that is managed by\r\n"\r | |
| 234 | " driver 0x17:\r\n"\r | |
| 235 | " Shell> drvcfg -v 17 28 -c\r\n"\r | |
| 236 | " \r\n"\r | |
| 237 | " * To validate options on child device 0x30 of device 0x28 that is managed by\r\n"\r | |
| 238 | " driver 0x17:\r\n"\r | |
| 239 | " Shell> drvcfg -v 17 28 30\r\n"\r | |
| 240 | " \r\n"\r | |
| 241 | " * To set options on device 0x28 that is managed by driver 0x17: \r\n"\r | |
| 242 | " Shell> drvcfg -s 17 28\r\n"\r | |
| 243 | " \r\n"\r | |
| 244 | " * To set options on child device 0x30 of device 0x28 that is managed by\r\n"\r | |
| 245 | " driver 0x17:\r\n"\r | |
| 246 | " Shell> drvcfg -s 17 28 30\r\n"\r | |
| 247 | " \r\n"\r | |
| 248 | " * To set options on device 0x28 that is managed by driver 0x17 in English:\r\n"\r | |
| 249 | " Shell> drvcfg -s 17 28 -l eng\r\n"\r | |
| 250 | " \r\n"\r | |
| 251 | " * To set options on device 0x28 that is managed by driver 0x17 in Spanish:\r\n"\r | |
| 252 | " Shell> drvcfg -s 17 28 -l spa\r\n"\r | |
| 253 | ".SH RETURNVALUES\r\n"\r | |
| 254 | " \r\n"\r | |
| 255 | "RETURN VALUES:\r\n"\r | |
| 256 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 257 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 258 | " violation.\r\n"\r | |
| 259 | " SHELL_UNSUPPORTED The action as requested was unsupported.\r\n"\r | |
| 260 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 261 | " formatted or its value was out of bounds.\r\n"\r | |
| 262 | \r | |
| 263 | #string STR_GET_HELP_DRIVERS #language en-US ""\r | |
| 264 | ".TH drivers 0 "display a list of drivers"\r\n"\r | |
| 265 | ".SH NAME\r\n"\r | |
| 266 | "Displays the UEFI driver list.\r\n"\r | |
| 267 | ".SH SYNOPSIS\r\n"\r | |
| 268 | " \r\n"\r | |
| 269 | "DRIVERS [-l XXX] [-sfo] \r\n"\r | |
| 270 | ".SH OPTIONS\r\n"\r | |
| 271 | " \r\n"\r | |
| 272 | " -l - Displays drivers using the specified language (e.g. ISO 639-2) \r\n"\r | |
| 273 | " -sfo - Displays information as described in Standard-Format Output.\r\n"\r | |
| 274 | ".SH DESCRIPTION\r\n"\r | |
| 275 | " \r\n"\r | |
| 276 | "NOTES:\r\n"\r | |
| 277 | " 1. This command displays a list of information for drivers that follow the\r\n"\r | |
| 278 | " UEFI Driver Model in the UEFI environment. The list includes:\r\n"\r | |
| 279 | " DRV - The handle number of the UEFI driver.\r\n"\r | |
| 280 | " VERSION - The version number of the UEFI driver.\r\n"\r | |
| 281 | " TYPE - The driver type:\r\n"\r | |
| 282 | " [B] - Bus Driver\r\n"\r | |
| 283 | " [D] - Device Driver\r\n"\r | |
| 284 | " CFG - Driver supports the Driver Configuration Protocol.\r\n"\r | |
| 285 | " DIAG - Driver supports the Driver Diagnostics Protocol.\r\n"\r | |
| 286 | " #D - The number of devices that this driver is managing.\r\n"\r | |
| 287 | " #C - The number of child devices that this driver has produced.\r\n"\r | |
| 288 | " DRIVER NAME - The name of the driver from the Component Name Protocol.\r\n"\r | |
| 289 | " IMAGE PATH - The file path from which the driver was loaded.\r\n"\r | |
| 290 | ".SH EXAMPLES\r\n"\r | |
| 291 | " \r\n"\r | |
| 292 | "EXAMPLES:\r\n"\r | |
| 293 | " * To display the list:\r\n"\r | |
| 294 | " Shell> drivers\r\n"\r | |
| 295 | ".SH RETURNVALUES\r\n"\r | |
| 296 | " \r\n"\r | |
| 297 | "RETURN VALUES:\r\n"\r | |
| 298 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 299 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 300 | " violation.\r\n"\r | |
| 301 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 302 | " formatted or its value was out of bounds.\r\n"\r | |
| 303 | \r | |
| 304 | #string STR_GET_HELP_DISCONNECT #language en-US ""\r | |
| 305 | ".TH disconnect 0 "disconnect a driver"\r\n"\r | |
| 306 | ".SH NAME\r\n"\r | |
| 307 | "Disconnects one or more drivers from the specified devices. \r\n"\r | |
| 308 | ".SH SYNOPSIS\r\n"\r | |
| 309 | " \r\n"\r | |
| 339a2b93 | 310 | "DISCONNECT DeviceHandle [DriverHandle [ChildHandle]] \r\n"\r |
| b23592a8 | 311 | "DISCONNECT -r [-nc] \r\n"\r |
| e329f98b JJ |
312 | ".SH OPTIONS\r\n"\r |
| 313 | " \r\n"\r | |
| 314 | "NOTES:\r\n"\r | |
| 339a2b93 TS |
315 | " -r - Disconnects all drivers from all devices, then reconnect\r\n"\r |
| 316 | " consoles.\r\n"\r | |
| 317 | " -nc - Do not reconnect the console devices.\r\n"\r | |
| ea317c06 TS |
318 | " DeviceHandle - Specifies a device handle (a hexadecimal number). If not\r\n"\r |
| 319 | " specified, then disconnect DriverHandle.\r\n"\r | |
| e329f98b | 320 | " DriverHandle - Specifies a driver handle (a hexadecimal number).\r\n"\r |
| ea317c06 TS |
321 | " ChildHandle - Specifies a child handle of a device (a hexadecimal number).\r\n"\r |
| 322 | " If not specified, then all child handles of DeviceHandle are\r\n"\r | |
| e329f98b JJ |
323 | " disconnected.\r\n"\r |
| 324 | ".SH DESCRIPTION\r\n"\r | |
| 325 | " \r\n"\r | |
| 326 | "NOTES:\r\n"\r | |
| 327 | " 1. If the 'DriverHandle' parameter is not specified, the default is to\r\n"\r | |
| 328 | " disconnect 'DeviceHandle'.\r\n"\r | |
| 329 | " 2. If the 'ChildHandle' parameter is not specified, the default is to\r\n"\r | |
| 330 | " disconnect all child handles of the 'DeviceHandle'.\r\n"\r | |
| 331 | " 3. If the '-r' option is specified, all consoles and drivers will be\r\n"\r | |
| ea317c06 TS |
332 | " disconnected from all devices in the system, then consoles are\r\n"\r |
| 333 | " reconnected. If the '-nc' option is also spcified, then console devices\r\n"\r | |
| 334 | " are not reconnected.\r\n"\r | |
| e329f98b JJ |
335 | " 4. This command does not support output redirection.\r\n"\r |
| 336 | ".SH EXAMPLES\r\n"\r | |
| 337 | " \r\n"\r | |
| 338 | "EXAMPLES:\r\n"\r | |
| 339a2b93 TS |
339 | " * To disconnect all drivers from all devices, then reconnect console\r\n"\r |
| 340 | " devices:\r\n"\r | |
| e329f98b JJ |
341 | " Shell> disconnect -r\r\n"\r |
| 342 | " \r\n"\r | |
| 339a2b93 TS |
343 | " * To disconnect all drivers from all devices, including console devices:\r\n"\r |
| 344 | " Shell> disconnect -r -nc\r\n"\r | |
| 345 | " \r\n"\r | |
| e329f98b JJ |
346 | " * To disconnect all drivers from device 0x28:\r\n"\r |
| 347 | " fs0:\> disconnect 28\r\n"\r | |
| 348 | " \r\n"\r | |
| 349 | " * To disconnect driver 0x17 from device 0x28:\r\n"\r | |
| 350 | " fs0:\> disconnect 28 17\r\n"\r | |
| 351 | " \r\n"\r | |
| 352 | " * To disconnect driver 0x17 from controlling the child 0x32 of device 0x28:\r\n"\r | |
| 353 | " fs0:\> disconnect 28 17 32\r\n"\r | |
| 354 | ".SH RETURNVALUES\r\n"\r | |
| 355 | " \r\n"\r | |
| 356 | "RETURN VALUES:\r\n"\r | |
| 357 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 358 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 359 | " violation.\r\n"\r | |
| 360 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 361 | " formatted or its value was out of bounds.\r\n"\r | |
| 362 | \r | |
| 363 | #string STR_GET_HELP_DH #language en-US ""\r | |
| 364 | ".TH dh 0 "displays list of handles"\r\n"\r | |
| 365 | ".SH NAME\r\n"\r | |
| 366 | "Displays the device handles in the UEFI environment. \r\n"\r | |
| 367 | ".SH SYNOPSIS\r\n"\r | |
| 368 | " \r\n"\r | |
| 369 | "DH [-l <lang>] [handle | -p <prot_id>] [-d] [-v] \r\n"\r | |
| 370 | ".SH OPTIONS\r\n"\r | |
| 371 | " \r\n"\r | |
| 372 | " -p - Dumps all handles of a protocol specified by the GUID.\r\n"\r | |
| 373 | " -d - Dumps UEFI Driver Model-related information.\r\n"\r | |
| 374 | " -l - Dumps information using the language codes (e.g. ISO 639-2).\r\n"\r | |
| 375 | " -sfo - Displays information as described in Standard-Format Output.\r\n"\r | |
| 376 | " -v - Dumps verbose information about a specific handle.\r\n"\r | |
| 377 | " handle - Specifies a handle to dump information about (a hexadecimal number).\r\n"\r | |
| 378 | " If not present, then all information will be dumped.\r\n"\r | |
| 379 | ".SH DESCRIPTION\r\n"\r | |
| 380 | " \r\n"\r | |
| 381 | "NOTES:\r\n"\r | |
| 382 | " 1. When neither 'handle' nor 'prot_id' is specified, a list of all the\r\n"\r | |
| 383 | " device handles in the UEFI environment is displayed. \r\n"\r | |
| 384 | " 2. The '-d' option displays UEFI Driver Model related information including\r\n"\r | |
| 385 | " parent handles, child handles, all drivers installed on the handle, etc.\r\n"\r | |
| 386 | " 3. The '-v' option displays verbose information for the specified handle\r\n"\r | |
| 387 | " including all the protocols on the handle and their details.\r\n"\r | |
| 388 | " 4. If the '-p' option is specified, all handles containing the specified\r\n"\r | |
| 389 | " protocol will be displayed. Otherwise, the 'handle' parameter has to be\r\n"\r | |
| 390 | " specified for display. In this case, the '-d' option will be enabled\r\n"\r | |
| 391 | " automatically if the '-v' option is not specified.\r\n"\r | |
| 392 | ".SH EXAMPLES\r\n"\r | |
| 393 | " \r\n"\r | |
| 394 | "EXAMPLES:\r\n"\r | |
| 395 | " * To display all handles and display one screen at a time:\r\n"\r | |
| 396 | " Shell> dh -b\r\n"\r | |
| 397 | " \r\n"\r | |
| 398 | " * To display the detailed information on handle 0x30:\r\n"\r | |
| 399 | " Shell> dh 30\r\n"\r | |
| 400 | " \r\n"\r | |
| 401 | " * To display all handles with 'diskio' protocol:\r\n"\r | |
| 402 | " Shell> dh -p diskio\r\n"\r | |
| 403 | " \r\n"\r | |
| 52f2b02c | 404 | " * To display all handles with 'LoadedImage' protocol and break when the screen is\r\n"\r |
| e329f98b | 405 | " full:\r\n"\r |
| 52f2b02c | 406 | " Shell> dh -p LoadedImage -b\r\n"\r |
| e329f98b JJ |
407 | ".SH RETURNVALUES\r\n"\r |
| 408 | " \r\n"\r | |
| 409 | "RETURN VALUES:\r\n"\r | |
| 410 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 411 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 412 | " violation.\r\n"\r | |
| 413 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 414 | " formatted or its value was out of bounds.\r\n"\r | |
| 415 | \r | |
| 416 | #string STR_GET_HELP_DEVTREE #language en-US ""\r | |
| 417 | ".TH devtree 0 "display device tree"\r\n"\r | |
| 418 | ".SH NAME\r\n"\r | |
| 419 | "Displays the UEFI Driver Model compliant device tree.\r\n"\r | |
| 420 | ".SH SYNOPSIS\r\n"\r | |
| 421 | " \r\n"\r | |
| 422 | "DEVTREE [-b] [-d] [-l XXX] [DeviceHandle] \r\n"\r | |
| 423 | ".SH OPTIONS\r\n"\r | |
| 424 | " \r\n"\r | |
| 425 | " -b - Displays one screen at a time.\r\n"\r | |
| 426 | " -d - Displays the device tree using device paths.\r\n"\r | |
| 427 | " -l - Displays the device tree using the specified language.\r\n"\r | |
| 428 | " DeviceHandle - Displays the device tree below a certain handle.\r\n"\r | |
| 429 | ".SH DESCRIPTION\r\n"\r | |
| 430 | " \r\n"\r | |
| 431 | "NOTES:\r\n"\r | |
| 432 | " 1. This command prints a tree of devices that are being managed by drivers\r\n"\r | |
| 433 | " that follow the UEFI Driver Model. By default, the devices are printed in\r\n"\r | |
| 434 | " device names that are retrieved from the Component Name Protocol.\r\n"\r | |
| 435 | " 2. If the option -d is specified, the device paths will be printed instead.\r\n"\r | |
| 436 | ".SH EXAMPLES\r\n"\r | |
| 437 | " \r\n"\r | |
| 438 | "EXAMPLES:\r\n"\r | |
| 439 | " * To display the tree of all devices compliant with the UEFI Driver Model:\r\n"\r | |
| 440 | " Shell> devtree\r\n"\r | |
| 441 | " \r\n"\r | |
| 442 | " * To display the tree of all devices below device 28 compliant with the UEFI\r\n"\r | |
| 443 | " Driver Model:\r\n"\r | |
| 444 | " Shell> devtree 28\r\n"\r | |
| 445 | " \r\n"\r | |
| 446 | " * To display the tree of all devices compliant with the UEFI Driver Model\r\n"\r | |
| 447 | " one screen at a time:\r\n"\r | |
| 448 | " Shell> devtree -b\r\n"\r | |
| 449 | " \r\n"\r | |
| 450 | \r | |
| 451 | #string STR_GET_HELP_DEVICES #language en-US ""\r | |
| 452 | ".TH devices 0 "display a list of devices"\r\n"\r | |
| 453 | ".SH NAME\r\n"\r | |
| 454 | "Displays the list of devices managed by UEFI drivers. \r\n"\r | |
| 455 | ".SH SYNOPSIS\r\n"\r | |
| 456 | " \r\n"\r | |
| 457 | "DEVICES [-b] [-l XXX] [-sfo] \r\n"\r | |
| 458 | ".SH OPTIONS\r\n"\r | |
| 459 | " \r\n"\r | |
| 460 | " -b - Display one screen at a time\r\n"\r | |
| 461 | " -l XXX - Display devices using the specified ISO 639-2 language\r\n"\r | |
| 462 | " -sfo - Displays information as described in Standard-Format Output.\r\n"\r | |
| 463 | ".SH DESCRIPTION\r\n"\r | |
| 464 | " \r\n"\r | |
| 465 | "NOTES:\r\n"\r | |
| 466 | " 1. The command prints a list of devices that are being managed by drivers\r\n"\r | |
| 467 | " that follow the UEFI Driver Model.\r\n"\r | |
| 468 | " 2. Display Format:\r\n"\r | |
| 469 | " CTRL - The handle number of the UEFI device\r\n"\r | |
| 470 | " TYPE - The device type:\r\n"\r | |
| 471 | " [R] - Root Controller\r\n"\r | |
| ba0014b9 | 472 | " [B] - Bus Controller\r\n"\r |
| e329f98b JJ |
473 | " [D] - Device Controller\r\n"\r |
| 474 | " CFG - A managing driver supports the Driver Configuration\r\n"\r | |
| 475 | " Protocol. Yes if 'Y' or 'X'; No if 'N' or '-'.\r\n"\r | |
| 476 | " DIAG - A managing driver supports the Driver Diagnostics\r\n"\r | |
| 477 | " Protocol. Yes if 'Y' or 'X'; No if 'N' or '-'.\r\n"\r | |
| 478 | " #P - The number of parent controllers for this device\r\n"\r | |
| 479 | " #D - The number of drivers managing the device\r\n"\r | |
| 480 | " #C - The number of child controllers produced by this device\r\n"\r | |
| 481 | " DEVICE NAME - The name of the device from the Component Name Protocol\r\n"\r | |
| 482 | ".SH EXAMPLES\r\n"\r | |
| 483 | " \r\n"\r | |
| 484 | "EXAMPLES:\r\n"\r | |
| 485 | " * To display all devices compliant with the UEFI Driver Model:\r\n"\r | |
| 486 | " Shell> devices\r\n"\r | |
| 487 | " \r\n"\r | |
| 488 | \r | |
| 489 | #string STR_GET_HELP_CONNECT #language en-US ""\r | |
| 490 | ".TH connect 0 "connect a driver"\r\n"\r | |
| 491 | ".SH NAME\r\n"\r | |
| 492 | "Binds a driver to a specific device and starts the driver. \r\n"\r | |
| 493 | ".SH SYNOPSIS\r\n"\r | |
| 494 | " \r\n"\r | |
| 495 | "CONNECT [[DeviceHandle] [DriverHandle] | [-c] | [-r]] \r\n"\r | |
| 496 | ".SH OPTIONS\r\n"\r | |
| 497 | " \r\n"\r | |
| 498 | " -c - Connects console devices\r\n"\r | |
| 499 | " -r - Connects recursively\r\n"\r | |
| 500 | " DeviceHandle - Specifies a device handle in hexadecimal format.\r\n"\r | |
| 501 | " DriverHandle - Specifies a driver handle in hexadecimal format.\r\n"\r | |
| 502 | ".SH DESCRIPTION\r\n"\r | |
| 503 | " \r\n"\r | |
| 504 | "NOTES:\r\n"\r | |
| 505 | " 1. If no 'DeviceHandle' parameter is specified, all device handles in the\r\n"\r | |
| 506 | " current system will be the default.\r\n"\r | |
| 507 | " 2. If no 'DriverHandle' parameter is specified, all matched drivers will be\r\n"\r | |
| 508 | " bound to the specified device.\r\n"\r | |
| 509 | " 3. If 'DriverHandle' parameter is provided, the specified driver will have\r\n"\r | |
| 510 | " highest priority on connecting the device(s).\r\n"\r | |
| 511 | " 4. If the '-c' option is specified, only console devices described in the\r\n"\r | |
| 512 | " UEFI Shell environment variables and related devices will be connected.\r\n"\r | |
| 513 | " 5. If the '-r' option is specified, the command will recursively scan all\r\n"\r | |
| 514 | " handles and check to see if any loaded or embedded driver can match the\r\n"\r | |
| 515 | " specified device. If so, the driver will be bound to the device.\r\n"\r | |
| 516 | " Additionally, if more device handles are created during the binding, \r\n"\r | |
| 517 | " these handles will also be checked to see if a matching driver can bind\r\n"\r | |
| 518 | " to these devices as well. The process is repeated until no more drivers\r\n"\r | |
| 519 | " are able to connect to any devices. However, without the option, the\r\n"\r | |
| 520 | " newly created device handles will not be further bound to any\r\n"\r | |
| 521 | " drivers.\r\n"\r | |
| 522 | " 6. If only a single handle is specified and the handle has an\r\n"\r | |
| 523 | " EFI_DRIVER_BINDING_PROTOCOL on it, then the handle is assumed to be a\r\n"\r | |
| 524 | " driver handle. Otherwise, it is assumed to be a device handle.\r\n"\r | |
| ba0014b9 | 525 | " 7. If no parameters are specified, then the command will attempt to bind\r\n"\r |
| e329f98b JJ |
526 | " all proper drivers to all devices without recursion. Each connection\r\n"\r |
| 527 | " status will be displayed.\r\n"\r | |
| 528 | " 8. Output redirection is not supported for 'connect -r' usage.\r\n"\r | |
| 529 | ".SH EXAMPLES\r\n"\r | |
| 530 | " \r\n"\r | |
| 531 | "EXAMPLES:\r\n"\r | |
| 532 | " * To connect all drivers to all devices recursively:\r\n"\r | |
| 533 | " Shell> connect -r\r\n"\r | |
| 534 | " \r\n"\r | |
| 535 | " * To display all connections:\r\n"\r | |
| 536 | " Shell> connect\r\n"\r | |
| 537 | " \r\n"\r | |
| 538 | " * To connect drivers with 0x17 as highest priority to all the devices they\r\n"\r | |
| 539 | " can manage:\r\n"\r | |
| 540 | " Shell> connect 17\r\n"\r | |
| 541 | " \r\n"\r | |
| 542 | " * To connect all possible drivers to device 0x19:\r\n"\r | |
| 543 | " Shell> connect 19\r\n"\r | |
| 544 | " \r\n"\r | |
| 545 | " * To connect drivers with 0x17 as highest priority to device 0x19 they can\r\n"\r | |
| 546 | " manage:\r\n"\r | |
| 547 | " Shell> connect 19 17\r\n"\r | |
| 548 | " \r\n"\r | |
| 549 | " * To connect console devices described in the UEFI Shell environment\r\n"\r | |
| 550 | " variables:\r\n"\r | |
| 551 | " Shell> connect -c\r\n"\r | |
| 552 | ".SH RETURNVALUES\r\n"\r | |
| 553 | " \r\n"\r | |
| 554 | "RETURN VALUES:\r\n"\r | |
| 555 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 556 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 557 | " violation.\r\n"\r | |
| 558 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 559 | " formatted or its value was out of bounds.\r\n"\r | |
| 560 | \r | |
| 561 | #string STR_GET_HELP_OPENINFO #language en-US ""\r | |
| 562 | ".TH openinfo 0 "display info about a handle."\r\n"\r | |
| 563 | ".SH NAME\r\n"\r | |
| 564 | "Displays the protocols and agents associated with a handle. \r\n"\r | |
| 565 | ".SH SYNOPSIS\r\n"\r | |
| 566 | " \r\n"\r | |
| 567 | "OPENINFO Handle [-b] \r\n"\r | |
| 568 | ".SH OPTIONS\r\n"\r | |
| 569 | " \r\n"\r | |
| 570 | " -b - Displays one screen at a time.\r\n"\r | |
| 571 | " Handle - Displays open protocol information for the specified handle.\r\n"\r | |
| 572 | ".SH DESCRIPTION\r\n"\r | |
| 573 | " \r\n"\r | |
| 574 | "NOTES:\r\n"\r | |
| 575 | " 1. This command is used to display the open protocols on a given handle.\r\n"\r | |
| 576 | ".SH EXAMPLES\r\n"\r | |
| 577 | " \r\n"\r | |
| 578 | "EXAMPLES:\r\n"\r | |
| 579 | " * To show open protocols on handle 0x23:\r\n"\r | |
| 580 | " Shell> openinfo 23\r\n"\r | |
| 581 | " \r\n"\r | |
| 582 | \r | |
| 583 | #string STR_GET_HELP_DRVDIAG #language en-US ""\r | |
| 584 | ".TH drvdiag 0 "diagnose a driver"\r\n"\r | |
| 585 | ".SH NAME\r\n"\r | |
| 586 | "Invokes the Driver Diagnostics Protocol. \r\n"\r | |
| 587 | ".SH SYNOPSIS\r\n"\r | |
| 588 | " \r\n"\r | |
| 589 | "DRVDIAG [-c] [-l XXX] [-s|-e|-m] [DriverHandle [DeviceHandle [ChildHandle]]] \r\n"\r | |
| 590 | ".SH OPTIONS\r\n"\r | |
| 591 | " \r\n"\r | |
| 592 | " -c - Diagnoses all child devices.\r\n"\r | |
| 593 | " -l - Diagnoses using the ISO 639-2 language specified by XXX.\r\n"\r | |
| 594 | " -s - Runs diagnostics in standard mode.\r\n"\r | |
| 595 | " -e - Runs diagnostics in extended mode.\r\n"\r | |
| 596 | " -m - Runs diagnostics in manufacturing mode.\r\n"\r | |
| 597 | " DriverHandle - Specifies the handle of the driver to diagnose.\r\n"\r | |
| 598 | " DeviceHandle - Specifies the handle of a device that DriverHandle is managing.\r\n"\r | |
| 599 | " ChildHandle - Specifies the handle of a device that is a child of DeviceHandle.\r\n"\r | |
| 600 | ".SH DESCRIPTION\r\n"\r | |
| 601 | " \r\n"\r | |
| 602 | "NOTES:\r\n"\r | |
| 603 | " 1. This command invokes the Driver Diagnostics Protocol.\r\n"\r | |
| 604 | ".SH EXAMPLES\r\n"\r | |
| 605 | " \r\n"\r | |
| 606 | "EXAMPLES:\r\n"\r | |
| 607 | " * To display the list of devices that are available for diagnostics:\r\n"\r | |
| 608 | " Shell> drvdiag\r\n"\r | |
| 609 | " \r\n"\r | |
| 610 | " * To display the list of devices and child devices that are available for\r\n"\r | |
| 611 | " diagnostics:\r\n"\r | |
| 612 | " Shell> drvdiag -c\r\n"\r | |
| 613 | " \r\n"\r | |
| 614 | " * To run diagnostics in standard mode on all devices:\r\n"\r | |
| 615 | " Shell> drvdiag -s\r\n"\r | |
| 616 | " \r\n"\r | |
| 617 | " * To run diagnostics in standard mode on all devices in English:\r\n"\r | |
| 618 | " Shell> drvdiag -s -l eng\r\n"\r | |
| 619 | " \r\n"\r | |
| 620 | " * To run diagnostics in standard mode on all devices in Spanish:\r\n"\r | |
| 621 | " Shell> drvdiag -s -l spa\r\n"\r | |
| 622 | " \r\n"\r | |
| 623 | " * To run diagnostics in standard mode on all devices and child devices:\r\n"\r | |
| 624 | " Shell> drvdiag -s -c\r\n"\r | |
| 625 | " \r\n"\r | |
| 626 | " * To run diagnostics in extended mode on all devices:\r\n"\r | |
| 627 | " Shell> drvdiag -e\r\n"\r | |
| 628 | " \r\n"\r | |
| 629 | " * To run diagnostics in manufacturing mode on all devices:\r\n"\r | |
| 630 | " Shell> drvdiag -m\r\n"\r | |
| 631 | " \r\n"\r | |
| 632 | " * To run diagnostics in standard mode on all devices managed by driver 0x17:\r\n"\r | |
| 633 | " Shell> drvdiag -s 17\r\n"\r | |
| 634 | " \r\n"\r | |
| 635 | " * To run diagnostics in standard mode on device 0x28 managed by driver 0x17:\r\n"\r | |
| 636 | " Shell> drvdiag -s 17 28\r\n"\r | |
| 637 | " \r\n"\r | |
| 638 | " * To run diagnostics in standard mode on all child devices of device 0x28\r\n"\r | |
| 639 | " managed by driver 0x17:\r\n"\r | |
| 640 | " Shell> drvdiag -s 17 28 -c\r\n"\r | |
| 641 | " \r\n"\r | |
| 642 | " * To run diagnostics in standard mode on child device 0x30 of device 0x28\r\n"\r | |
| 643 | " managed by driver 0x17:\r\n"\r | |
| 644 | " Shell> drvdiag -s 17 28 30\r\n"\r | |
| 645 | ".SH RETURNVALUES\r\n"\r | |
| 646 | " \r\n"\r | |
| 647 | "RETURN VALUES:\r\n"\r | |
| 648 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 649 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 650 | " violation.\r\n"\r | |
| 651 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 652 | " formatted or its value was out of bounds.\r\n"\r | |
| 653 | \r | |
| 654 | #string STR_GET_HELP_RECONNECT #language en-US ""\r | |
| 655 | ".TH reconnect 0 "reconnect drivers"\r\n"\r | |
| 656 | ".SH NAME\r\n"\r | |
| 657 | "Reconnects drivers to the specific device. \r\n"\r | |
| 658 | ".SH SYNOPSIS\r\n"\r | |
| 659 | " \r\n"\r | |
| 660 | "RECONNECT DeviceHandle [DriverHandle [ChildHandle]]\r\n"\r | |
| 661 | "RECONNECT -r \r\n"\r | |
| 662 | ".SH OPTIONS\r\n"\r | |
| 663 | " \r\n"\r | |
| 664 | " -r - Reconnects drivers to all devices.\r\n"\r | |
| 665 | " DeviceHandle - Specifies a device handle (a hexadecimal number).\r\n"\r | |
| 666 | " DriverHandle - Specifies a driver handle (a hexadecimal number). If not specified, all\r\n"\r | |
| 667 | " drivers on the specified device will be reconnected. \r\n"\r | |
| 668 | " ChildHandle - Specifies the child handle of device (a hexadecimal number). If not\r\n"\r | |
| 669 | " specified, then all child handles of the specified device are\r\n"\r | |
| 670 | " reconnected.\r\n"\r | |
| 671 | ".SH DESCRIPTION\r\n"\r | |
| 672 | " \r\n"\r | |
| 673 | "NOTES:\r\n"\r | |
| 674 | " 1. This command reconnects drivers to the specific device. It will first\r\n"\r | |
| 675 | " disconnect the specified driver from the specified device and then connect\r\n"\r | |
| 676 | " the driver to the device recursively.\r\n"\r | |
| 677 | " 2. If the -r option is used, then all drivers will be reconnected to all\r\n"\r | |
| 678 | " devices. Any drivers that are bound to any devices will be disconnected\r\n"\r | |
| 679 | " first and then connected recursively.\r\n"\r | |
| 680 | " 3. See the connect and disconnect commands for more details. \r\n"\r | |
| 681 | ".SH EXAMPLES\r\n"\r | |
| 682 | " \r\n"\r | |
| 683 | "EXAMPLES:\r\n"\r | |
| 684 | " * To reconnect all drivers to all devices:\r\n"\r | |
| 685 | " Shell> reconnect -r\r\n"\r | |
| 686 | " \r\n"\r | |
| 687 | " * To reconnect all drivers to device 0x28:\r\n"\r | |
| 688 | " fs0:\> reconnect 28\r\n"\r | |
| 689 | " \r\n"\r | |
| 690 | " * To disconnect 0x17 from 0x28 then reconnect drivers with 0x17 as highest\r\n"\r | |
| 691 | " priority to device 0x28:\r\n"\r | |
| 692 | " fs0:\> reconnect 28 17\r\n"\r | |
| 693 | " \r\n"\r | |
| 694 | " * To disconnect 0x17 from 0x28 destroying child 0x32 then reconnect drivers\r\n"\r | |
| 695 | " with 0x17 as highest priority to device 0x28\r\n"\r | |
| 696 | " fs0:\> reconnect 28 17 32\r\n"\r | |
| 697 | ".SH RETURNVALUES\r\n"\r | |
| 698 | " \r\n"\r | |
| 699 | "RETURN VALUES:\r\n"\r | |
| 700 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 701 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 702 | " violation.\r\n"\r | |
| 703 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 704 | " formatted or its value was out of bounds.\r\n"\r | |
| 705 | \r | |
| 706 | #string STR_GET_HELP_UNLOAD #language en-US ""\r | |
| 707 | ".TH unload 0 "unload a driver"\r\n"\r | |
| 708 | ".SH NAME\r\n"\r | |
| 709 | "Unloads a driver image that was already loaded. \r\n"\r | |
| 710 | ".SH SYNOPSIS\r\n"\r | |
| 711 | " \r\n"\r | |
| 712 | "UNLOAD [-n] [-v|-verbose] Handle \r\n"\r | |
| 713 | ".SH OPTIONS\r\n"\r | |
| 714 | " \r\n"\r | |
| 715 | " -n - Skips all prompts during unloading, so that it can be used\r\n"\r | |
| 716 | " in a script file.\r\n"\r | |
| 717 | " -v, -verbose - Dumps verbose status information before the image is unloaded.\r\n"\r | |
| 718 | " Handle - Specifies the handle of driver to unload, always taken as hexadecimal number.\r\n"\r | |
| 719 | ".SH DESCRIPTION\r\n"\r | |
| 720 | " \r\n"\r | |
| 721 | "NOTES:\r\n"\r | |
| 722 | " 1. The '-n' option can be used to skip all prompts during unloading.\r\n"\r | |
| 723 | " 2. If the '-v' option is specified, verbose image information will be\r\n"\r | |
| 724 | " displayed before the image is unloaded.\r\n"\r | |
| 725 | " 3. Only drivers that support unloading can be successfully unloaded.\r\n"\r | |
| 726 | " 4. Use the 'LOAD' command to load a driver.\r\n"\r | |
| 727 | ".SH EXAMPLES\r\n"\r | |
| 728 | " \r\n"\r | |
| 729 | "EXAMPLES:\r\n"\r | |
| 730 | " * To find the handle for the UEFI driver image to unload:\r\n"\r | |
| 731 | " Shell> dh -b\r\n"\r | |
| 732 | " \r\n"\r | |
| 733 | " * To unload the UEFI driver image with handle 27:\r\n"\r | |
| 734 | " Shell> unload 27\r\n"\r | |
| 735 | ".SH RETURNVALUES\r\n"\r | |
| 736 | " \r\n"\r | |
| 737 | "RETURN VALUES:\r\n"\r | |
| 738 | " SHELL_SUCCESS The action was completed as requested.\r\n"\r | |
| 739 | " SHELL_SECURITY_VIOLATION This function was not performed due to a security\r\n"\r | |
| 740 | " violation.\r\n"\r | |
| 741 | " SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly\r\n"\r | |
| 742 | " formatted or its value was out of bounds.\r\n"\r | |
| 743 | \r | |
| 744 | \r | |
| 745 | \r | |
| 746 | \r | |
| 747 | \r | |
| 748 | \r | |
| 749 | \r | |
| 750 | \r | |
| 751 | \r | |
| 752 | \r | |
| 753 | \r | |
| 754 | \r | |
| 755 | \r | |
| 756 | \r | |
| 757 | \r | |
| 758 | \r | |
| 759 | \r |