UEFI Shell Specification

Total Page:16

File Type:pdf, Size:1020Kb

UEFI Shell Specification UEFI Shell Specification January 26, 2016 Revision 2.2 The material contained herein is not a license, either expressly or impliedly, to any intellectual property owned or controlled by any of the authors or developers of this material or to any contribution thereto. The material contained herein is provided on an "AS IS" basis and, to the maximum extent permitted by applicable law, this information is provided AS IS AND WITH ALL FAULTS, and the authors and developers of this material hereby disclaim all other warranties and conditions, either express, implied or statutory, including, but not limited to, any (if any) implied warranties, duties or conditions of merchantability, of fitness for a particular purpose, of accuracy or completeness of responses, of results, of workmanlike effort, of lack of viruses and of lack of negligence, all with regard to this material and any contribution thereto. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." The Unified EFI Forum, Inc. reserves any features or instructions so marked for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. ALSO, THERE IS NO WARRANTY OR CONDITION OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION, CORRESPONDENCE TO DESCRIPTION OR NON-INFRINGEMENT WITH REGARD TO THE SPECIFICATION AND ANY CONTRIBUTION THERETO. IN NO EVENT WILL ANY AUTHOR OR DEVELOPER OF THIS MATERIAL OR ANY CONTRIBUTION THERETO BE LIABLE TO ANY OTHER PARTY FOR THE COST OF PROCURING SUBSTITUTE GOODS OR SERVICES, LOST PROFITS, LOSS OF USE, LOSS OF DATA, OR ANY INCIDENTAL, CONSEQUENTIAL, DIRECT, INDIRECT, OR SPECIAL DAMAGES WHETHER UNDER CONTRACT, TORT, WARRANTY, OR OTHERWISE, ARISING IN ANY WAY OUT OF THIS OR ANY OTHER AGREEMENT RELATING TO THIS DOCUMENT, WHETHER OR NOT SUCH PARTY HAD ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. Copyright 2008, - 2016 Unified EFI, Inc. All Rights Reserved ii Contents 1 Introduction ...................................................................................................... 1 1.1 Overview ............................................................................................... 1 1.2 Related Information ................................................................................ 1 1.3 Terms ................................................................................................... 1 2 Code Definitions ................................................................................................ 3 2.1 Introduction ........................................................................................... 3 2.2 EFI_SHELL_PROTOCOL ............................................................................ 3 EFI_SHELL_PROTOCOL ............................................................................ 3 EFI_SHELL_PROTOCOL.BatchIsActive() ..................................................... 9 EFI_SHELL_PROTOCOL.CloseFile() .......................................................... 10 EFI_SHELL_PROTOCOL.CreateFile() ........................................................ 11 EFI_SHELL_PROTOCOL.DeleteFile() ........................................................ 13 EFI_SHELL_PROTOCOL.DeleteFileByName() ............................................. 14 EFI_SHELL_PROTOCOL.DisablePageBreak() ............................................. 15 EFI_SHELL_PROTOCOL.EnablePageBreak() .............................................. 16 EFI_SHELL_PROTOCOL.Execute() ........................................................... 17 EFI_SHELL_PROTOCOL.FindFiles() .......................................................... 19 EFI_SHELL_PROTOCOL.FindFilesInDir() ................................................... 20 EFI_SHELL_PROTOCOL.FlushFile() .......................................................... 21 EFI_SHELL_PROTOCOL.FreeFileList() ...................................................... 22 EFI_SHELL_PROTOCOL.GetAlias() ........................................................... 23 EFI_SHELL_PROTOCOL.GetCurDir() ........................................................ 24 EFI_SHELL_PROTOCOL.GetDeviceName() ................................................ 25 EFI_SHELL_PROTOCOL.GetDevicePathFromMap() ..................................... 27 EFI_SHELL_PROTOCOL.GetDevicePathFromFilePath()................................ 28 EFI_SHELL_PROTOCOL.GetEnv() ............................................................ 29 EFI_SHELL_PROTOCOL.GetEnvEx() ......................................................... 30 EFI_SHELL_PROTOCOL.GetFileInfo() ....................................................... 31 EFI_SHELL_PROTOCOL.GetFilePathFromDevicePath()................................ 32 EFI_SHELL_PROTOCOL.GetFilePosition().................................................. 33 EFI_SHELL_PROTOCOL.GetFileSize() ....................................................... 34 EFI_SHELL_PROTOCOL.GetGuidFromName() ........................................... 35 EFI_SHELL_PROTOCOL.GetGuidName() ................................................... 36 EFI_SHELL_PROTOCOL.GetHelpText() ..................................................... 37 EFI_SHELL_PROTOCOL.GetMapFromDevicePath() ..................................... 38 EFI_SHELL_PROTOCOL.GetPageBreak() .................................................. 39 EFI_SHELL_PROTOCOL.IsRootShell() ...................................................... 40 EFI_SHELL_PROTOCOL.OpenFileByName() .............................................. 41 EFI_SHELL_PROTOCOL.OpenFileList() ..................................................... 43 EFI_SHELL_PROTOCOL.OpenRoot() ........................................................ 45 EFI_SHELL_PROTOCOL.OpenRootByHandle() ........................................... 46 EFI_SHELL_PROTOCOL.ReadFile() .......................................................... 47 EFI_SHELL_PROTOCOL.RegisterGuidName() ............................................ 48 EFI_SHELL_PROTOCOL.RemoveDupInFileList() ......................................... 49 EFI_SHELL_PROTOCOL.SetAlias() ........................................................... 50 EFI_SHELL_PROTOCOL.SetCurDir() ........................................................ 52 EFI_SHELL_PROTOCOL.SetEnv() ............................................................ 53 EFI_SHELL_PROTOCOL.SetFileInfo() ....................................................... 54 iii EFI_SHELL_PROTOCOL.SetFilePosition() .................................................. 55 EFI_SHELL_PROTOCOL.SetMap() ............................................................ 56 EFI_SHELL_PROTOCOL.WriteFile() .......................................................... 57 2.3 EFI_SHELL_PARAMETERS_PROTOCOL ..................................................... 58 EFI_SHELL_PARAMETERS_PROTOCOL ..................................................... 58 2.4 EFI_SHELL_DYNAMIC_COMMAND_PROTOCOL .......................................... 59 EFI_SHELL_DYNAMIC_COMMAND_PROTOCOL .......................................... 59 EFI_SHELL_DYNAMIC_COMMAND_PROTOCOL.Handler() ........................... 60 EFI_SHELL_DYNAMIC_COMMAND_PROTOCOL.GetHelp() ........................... 61 3 UEFI Shell Features .......................................................................................... 63 3.1 Levels Of Support ................................................................................. 63 3.2 Invocation ........................................................................................... 64 3.3 Initialization ......................................................................................... 65 3.3.1 ...... Finding startup.nsh .................................................................. 66 3.3.2 ...... Supported Profiles ................................................................... 66 3.3.3 ...... Dynamic Profiles ...................................................................... 67 3.4 Command-Line ..................................................................................... 67 3.4.1 ...... Special Characters ................................................................... 67 3.4.2 ...... Escape Characters ................................................................... 68 3.4.3 ...... Quoting .................................................................................. 68 3.4.4 ...... Redirection ............................................................................. 69 3.4.5 ...... Comments .............................................................................. 72 3.5 Current Directory .................................................................................. 72 3.6 Variables ............................................................................................. 72 3.6.1 ...... Environment Variables ............................................................. 73 3.6.2 ...... Positional Parameters ............................................................... 75 3.6.3 ...... Index Parameters .................................................................... 76 3.6.4 ...... Aliases ................................................................................... 76 3.7 File Names ........................................................................................... 76 3.7.1 ...... Wildcard Expansion .................................................................. 77 3.7.2 ...... Mappings ................................................................................ 77 3.7.3 ...... Consistent
Recommended publications
  • 7. Functions in PHP – II
    7. Functions in PHP – II Scope of variables in Function Scope of variable is the part of PHP script where the variable can be accessed or used. PHP supports three different scopes for a variable. These scopes are 1. Local 2. Global 3. Static A variable declared within the function has local scope. That means this variable is only used within the function body. This variable is not used outside the function. To demonstrate the concept, let us take an example. // local variable scope function localscope() { $var = 5; //local scope echo '<br> The value of $var inside the function is: '. $var; } localscope(); // call the function // using $var outside the function will generate an error echo '<br> The value of $var inside the function is: '. $var; The output will be: The value of $var inside the function is: 5 ( ! ) Notice: Undefined variable: var in H:\wamp\www\PathshalaWAD\function\function localscope demo.php on line 12 Call Stack # Time Memory Function Location 1 0.0003 240416 {main}( ) ..\function localscope demo.php:0 The value of $var inside the function is: Page 1 of 7 If a variable is defined outside of the function, then the variable scope is global. By default, a global scope variable is only available to code that runs at global level. That means, it is not available inside a function. Following example demonstrate it. <?php //variable scope is global $globalscope = 20; // local variable scope function localscope() { echo '<br> The value of global scope variable is :'.$globalscope; } localscope(); // call the function // using $var outside the function will generate an error echo '<br> The value of $globalscope outside the function is: '.
    [Show full text]
  • Chapter 5 Formatting Pages: Basics Page Styles and Related Features Copyright
    Writer 6.0 Guide Chapter 5 Formatting Pages: Basics Page styles and related features Copyright This document is Copyright © 2018 by the LibreOffice Documentation Team. Contributors are listed below. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/4.0/), version 4.0 or later. All trademarks within this guide belong to their legitimate owners. Contributors Jean Hollis Weber Bruce Byfield Gillian Pollack Acknowledgments This chapter is updated from previous versions of the LibreOffice Writer Guide. Contributors to earlier versions are: Jean Hollis Weber John A Smith Ron Faile Jr. Jamie Eby This chapter is adapted from Chapter 4 of the OpenOffice.org 3.3 Writer Guide. The contributors to that chapter are: Agnes Belzunce Ken Byars Daniel Carrera Peter Hillier-Brook Lou Iorio Sigrid Kronenberger Peter Kupfer Ian Laurenson Iain Roberts Gary Schnabl Janet Swisher Jean Hollis Weber Claire Wood Michele Zarri Feedback Please direct any comments or suggestions about this document to the Documentation Team’s mailing list: [email protected] Note Everything you send to a mailing list, including your email address and any other personal information that is written in the message, is publicly archived and cannot be deleted. Publication date and software version Published July 2018. Based on LibreOffice 6.0. Note for macOS users Some keystrokes and menu items are different on macOS from those used in Windows and Linux. The table below gives some common substitutions for the instructions in this book.
    [Show full text]
  • Windows Command Prompt Cheatsheet
    Windows Command Prompt Cheatsheet - Command line interface (as opposed to a GUI - graphical user interface) - Used to execute programs - Commands are small programs that do something useful - There are many commands already included with Windows, but we will use a few. - A filepath is where you are in the filesystem • C: is the C drive • C:\user\Documents is the Documents folder • C:\user\Documents\hello.c is a file in the Documents folder Command What it Does Usage dir Displays a list of a folder’s files dir (shows current folder) and subfolders dir myfolder cd Displays the name of the current cd filepath chdir directory or changes the current chdir filepath folder. cd .. (goes one directory up) md Creates a folder (directory) md folder-name mkdir mkdir folder-name rm Deletes a folder (directory) rm folder-name rmdir rmdir folder-name rm /s folder-name rmdir /s folder-name Note: if the folder isn’t empty, you must add the /s. copy Copies a file from one location to copy filepath-from filepath-to another move Moves file from one folder to move folder1\file.txt folder2\ another ren Changes the name of a file ren file1 file2 rename del Deletes one or more files del filename exit Exits batch script or current exit command control echo Used to display a message or to echo message turn off/on messages in batch scripts type Displays contents of a text file type myfile.txt fc Compares two files and displays fc file1 file2 the difference between them cls Clears the screen cls help Provides more details about help (lists all commands) DOS/Command Prompt help command commands Source: https://technet.microsoft.com/en-us/library/cc754340.aspx.
    [Show full text]
  • Chapter 21. Introduction to Fortran 90 Language Features
    http://www.nr.com or call 1-800-872-7423 (North America only), or send email to [email protected] (outside North Amer readable files (including this one) to any server computer, is strictly prohibited. To order Numerical Recipes books or CDROMs, v Permission is granted for internet users to make one paper copy their own personal use. Further reproduction, or any copyin Copyright (C) 1986-1996 by Cambridge University Press. Programs Copyright (C) 1986-1996 by Numerical Recipes Software. Sample page from NUMERICAL RECIPES IN FORTRAN 90: THE Art of PARALLEL Scientific Computing (ISBN 0-521-57439-0) Chapter 21. Introduction to Fortran 90 Language Features 21.0 Introduction Fortran 90 is in many respects a backwards-compatible modernization of the long-used (and much abused) Fortran 77 language, but it is also, in other respects, a new language for parallel programming on present and future multiprocessor machines. These twin design goals of the language sometimes add confusion to the process of becoming fluent in Fortran 90 programming. In a certain trivial sense, Fortran 90 is strictly backwards-compatible with Fortran 77. That is, any Fortran 90 compiler is supposed to be able to compile any legacy Fortran 77 code without error. The reason for terming this compatibility trivial, however, is that you have to tell the compiler (usually via a source file name ending in “.f”or“.for”) that it is dealing with a Fortran 77 file. If you instead try to pass off Fortran 77 code as native Fortran 90 (e.g., by naming the source file something ending in “.f90”) it will not always work correctly! It is best, therefore, to approach Fortran 90 as a new computer language, albeit one with a lot in common with Fortran 77.
    [Show full text]
  • Creating Rpms Guide
    CREATING RPMS (Student version) v1.0 Featuring 36 pages of lecture and a 48 page lab exercise This docu m e n t serves two purpose s: 1. Representative sample to allow evaluation of our courseware manuals 2. Make available high quality RPM documentation to Linux administrators A bout this m aterial : The blue background you see simulates the custom paper that all Guru Labs course w are is printed on. This student version does not contain the instructor notes and teaching tips present in the instructor version. For more information on all the features of our unique layout, see: http://ww w . g urulabs.co m /courseware/course w are_layout.php For more freely available Guru Labs content (and the latest version of this file), see: http://www.gurulabs.co m/goodies/ This sample validated on: Red Hat Enterprise Linux 4 & Fedora Core v3 SUSE Linux Enterprise Server 9 & SUSE Linux Professional 9.2 About Guru Labs: Guru Labs is a Linux training company started in 199 9 by Linux experts to produce the best Linux training and course w are available. For a complete list, visit our website at: http://www.gurulabs.co m/ This work is copyrighted Guru Labs, L.C. 2005 and is licensed under the Creative Common s Attribution- NonCom mer cial- NoDerivs License. To view a copy of this license, visit http://creativecom m o n s.org/licenses/by- nc- nd/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 943 0 5, USA. Guru Labs 801 N 500 W Ste 202 Bountiful, UT 84010 Ph: 801-298-5227 WWW.GURULABS.COM Objectives: • Understand
    [Show full text]
  • The Frege Programming Language ( Draft)
    The Frege Programming Language (Draft) by Ingo Wechsung last changed May 14, 2014 3.21.285 Abstract This document describes the functional programming language Frege and its implemen- tation for the Java virtual machine. Commonplace features of Frege are type inference, lazy evaluation, modularization and separate compile-ability, algebraic data types and type classes, pattern matching and list comprehension. Distinctive features are, first, that the type system supports higher ranked polymorphic types, and, second, that Frege code is compiled to Java. This allows for maximal interoperability with existing Java software. Any Java class may be used as an abstract data type, Java functions and methods may be called from Frege functions and vice versa. Despite this interoperability feature Frege is a pure functional language as long as impure Java functions are declared accordingly. What is or who was Frege? Friedrich Ludwig Gottlob Frege was a German mathematician, who, in the second half of the 19th century tried to establish the foundation of mathematics in pure logic. Al- though this attempt failed in the very moment when he was about to publish his book Grundgesetze der Arithmetik, he is nevertheless recognized as the father of modern logic among philosophers and mathematicians. In his essay Funktion und Begriff [1] Frege introduces a function that takes another function as argument and remarks: Eine solche Funktion ist offenbar grundverschieden von den bisher betrachteten; denn als ihr Argument kann nur eine Funktion auftreten. Wie nun Funktionen von Gegenst¨andengrundverschieden sind, so sind auch Funktionen, deren Argu- mente Funktionen sind und sein m¨ussen,grundverschieden von Funktionen, deren Argumente Gegenst¨andesind und nichts anderes sein k¨onnen.
    [Show full text]
  • Powerview Command Reference
    PowerView Command Reference TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents ...................................................................................................................... PowerView User Interface ............................................................................................................ PowerView Command Reference .............................................................................................1 History ...................................................................................................................................... 12 ABORT ...................................................................................................................................... 13 ABORT Abort driver program 13 AREA ........................................................................................................................................ 14 AREA Message windows 14 AREA.CLEAR Clear area 15 AREA.CLOSE Close output file 15 AREA.Create Create or modify message area 16 AREA.Delete Delete message area 17 AREA.List Display a detailed list off all message areas 18 AREA.OPEN Open output file 20 AREA.PIPE Redirect area to stdout 21 AREA.RESet Reset areas 21 AREA.SAVE Save AREA window contents to file 21 AREA.Select Select area 22 AREA.STDERR Redirect area to stderr 23 AREA.STDOUT Redirect area to stdout 23 AREA.view Display message area in AREA window 24 AutoSTOre ..............................................................................................................................
    [Show full text]
  • Scope in Fortran 90
    Scope in Fortran 90 The scope of objects (variables, named constants, subprograms) within a program is the portion of the program in which the object is visible (can be use and, if it is a variable, modified). It is important to understand the scope of objects not only so that we know where to define an object we wish to use, but also what portion of a program unit is effected when, for example, a variable is changed, and, what errors might occur when using identifiers declared in other program sections. Objects declared in a program unit (a main program section, module, or external subprogram) are visible throughout that program unit, including any internal subprograms it hosts. Such objects are said to be global. Objects are not visible between program units. This is illustrated in Figure 1. Figure 1: The figure shows three program units. Main program unit Main is a host to the internal function F1. The module program unit Mod is a host to internal function F2. The external subroutine Sub hosts internal function F3. Objects declared inside a program unit are global; they are visible anywhere in the program unit including in any internal subprograms that it hosts. Objects in one program unit are not visible in another program unit, for example variable X and function F3 are not visible to the module program unit Mod. Objects in the module Mod can be imported to the main program section via the USE statement, see later in this section. Data declared in an internal subprogram is only visible to that subprogram; i.e.
    [Show full text]
  • Pingdirectory Administration Guide Version
    Release 7.3.0.3 Server Administration Guide PingDirectory | Contents | ii Contents PingDirectory™ Product Documentation................................................ 20 Overview of the Server............................................................................. 20 Server Features.................................................................................................................................20 Administration Framework.................................................................................................................21 Server Tools Location....................................................................................................................... 22 Preparing Your Environment....................................................................22 Before You Begin.............................................................................................................................. 22 System requirements..............................................................................................................22 Installing Java......................................................................................................................... 23 Preparing the Operating System (Linux).......................................................................................... 24 Configuring the File Descriptor Limits.................................................................................... 24 File System Tuning.................................................................................................................25
    [Show full text]
  • Declare and Assign Global Variable Python
    Declare And Assign Global Variable Python Unstaid and porous Murdoch never requiring wherewith when Thaddus cuts his unessential. Differentiated and slicked Emanuel bituminize almost duly, though Percival localise his calices stylize. Is Normie defunctive when Jeff objurgates toxicologically? Programming and global variables in the code shows the respondent what happened above, but what is inheritance and local variables in? Once declared global variable assignment previously, assigning values from a variable from python variable from outside that might want. They are software, you will see a mortgage of armor in javascript. Learn about Python variables plus data types, you must cross a variable forward declaration. How like you indulge a copy of view object in Python? If you declare global and. All someone need is to ran the variable only thing outside the modules. Why most variables and variable declaration with the responses. Python global python creates an assignment statement not declared globally anywhere in programming both a declaration is teaching computers, assigning these solutions are quite cumbersome. How to present an insurgent in Python? Can assign new python. If we boast that the entered value is invalid, sometimes creating the variable first. Thus of python and assigned using the value globally accepted store data. Python and python on site is available in coding and check again declare global variables can refer to follow these variables are some examples. Specific manner where a grate is screwing with us. Global variable will be use it has the python and variables, including headers is a function depending on. Local variable declaration is assigned it by assigning the variable to declare global variable in this open in the caller since the value globally.
    [Show full text]
  • Lenovo Flex System FC3171 8 Gb SAN Switch Command Line Interface User’S Guide This Document Explains How to Manage the Switch Using the CLI
    Flex System FC3171 8 Gb SAN Switch Command Line Interface User’s Guide Flex System FC3171 8 Gb SAN Switch Command Line Interface User’s Guide Note: Before using this information and the product it supports, read the general information in “Notices” on page 391. First Edition, April 2015 © Copyright Lenovo 2015. LIMITED AND RESTRICTED RIGHTS NOTICE: If data or software is delivered pursuant a General Services Administration “GSA” contract, use, reproduction, or disclosure is subject to restrictions set forth in Contract No. GS-35F-05925. Contents Chapter 1. Lenovo Flex System FC3171 8 Gb SAN Switch . 1 Related documentation . 1 Notices and statements in this document . 3 Chapter 2. Command line interface usage . 5 Logging in to the switch . 6 Opening and closing an Admin session . 7 Entering commands. 7 Getting help . 7 Setting page breaks . 8 Creating a support file. 9 Downloading and uploading files. 10 Chapter 3. User account configuration . 13 Displaying user account information . 14 Creating user accounts . 15 Modifying user accounts and passwords. 15 Chapter 4. Network and fabric configuration . 17 Displaying the Ethernet network configuration . 17 Displaying name server information . 18 Configuring the Ethernet port . 19 IPv4 configuration . 19 IPv6 configuration . 20 DNS server configuration . 21 Verifying a switch in the network . 22 Verifying and tracing Fibre Channel connections . 22 Managing IP security. 23 IP security concepts . 24 Legacy and Strict security . 24 Security policies and associations . 24 IKE peers and policies . 25 Public key infrastructure . 25 Displaying IP security information . 25 Policy and association information . 25 IKE peer and policy information . 26 Public key infrastructure information .
    [Show full text]
  • Docker Windows Task Scheduler
    Docker Windows Task Scheduler Genealogical Scarface glissading, his karyotype outgone inflicts overflowingly. Rudolph is accessorial and suckers languorously as sociologistic Engelbart bridled sonorously and systematises sigmoidally. Which Cecil merchandises so unbelievably that Cole comedowns her suavity? Simple task runner that runs pending tasks in Redis when Docker container. With Docker Content Trust, see will soon. Windows Tip Run applications in extra background using Task. Cronicle is a multi-server task scheduler and runner with a web based front-end UI It handles both scheduled repeating and on-demand jobs targeting any. Django project that you would only fetch of windows task directory and how we may seem. Docker schedulers and docker compose utility program by learning service on a scheduled time, operators and manage your already interact with. You get a byte array elements followed by the target system privileges, manage such data that? Machine learning service Creatio Academy. JSON list containing all my the jobs. As you note have noticed, development, thank deity for this magazine article. Docker-crontab A docker job scheduler aka crontab for. Careful with your terminology. Sometimes you and docker schedulers for task failed job gets silently redirected to get our task. Here you do want to docker swarm, task scheduler or scheduled background tasks in that. Url into this script in one easy to this was already existing cluster created, it retry a little effort. Works pretty stark deviation from your code is followed by searching for a process so how to be executed automatically set. Now docker for windows service container in most amateur players play to pass as.
    [Show full text]