]>
Commit | Line | Data |
---|---|---|
a405b86d | 1 | /** @file\r |
2 | Main file for NULL named library for level 1 shell command functions.\r | |
3 | \r | |
77dcec12 | 4 | Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r |
a405b86d | 5 | This program and the accompanying materials\r |
6 | are licensed and made available under the terms and conditions of the BSD License\r | |
7 | which accompanies this distribution. The full text of the license may be found at\r | |
8 | http://opensource.org/licenses/bsd-license.php\r | |
9 | \r | |
10 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
11 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
12 | \r | |
13 | **/\r | |
14 | \r | |
15 | #include "UefiShellLevel1CommandsLib.h"\r | |
16 | \r | |
17 | STATIC CONST CHAR16 mFileName[] = L"ShellCommands";\r | |
18 | EFI_HANDLE gShellLevel1HiiHandle = NULL;\r | |
a405b86d | 19 | \r |
77dcec12 | 20 | /**\r |
21 | Return the help text filename. Only used if no HII information found.\r | |
22 | \r | |
23 | @retval the filename.\r | |
24 | **/\r | |
a405b86d | 25 | CONST CHAR16*\r |
26 | EFIAPI\r | |
27 | ShellCommandGetManFileNameLevel1 (\r | |
28 | VOID\r | |
29 | )\r | |
30 | {\r | |
31 | return (mFileName);\r | |
32 | }\r | |
33 | \r | |
34 | /**\r | |
35 | Constructor for the Shell Level 1 Commands library.\r | |
36 | \r | |
37 | Install the handlers for level 1 UEFI Shell 2.0 commands.\r | |
38 | \r | |
39 | @param ImageHandle the image handle of the process\r | |
40 | @param SystemTable the EFI System Table pointer\r | |
41 | \r | |
42 | @retval EFI_SUCCESS the shell command handlers were installed sucessfully\r | |
43 | @retval EFI_UNSUPPORTED the shell level required was not found.\r | |
44 | **/\r | |
45 | EFI_STATUS\r | |
46 | EFIAPI\r | |
47 | ShellLevel1CommandsLibConstructor (\r | |
48 | IN EFI_HANDLE ImageHandle,\r | |
49 | IN EFI_SYSTEM_TABLE *SystemTable\r | |
50 | )\r | |
51 | {\r | |
52 | //\r | |
53 | // if shell level is less than 2 do nothing\r | |
54 | //\r | |
55 | if (PcdGet8(PcdShellSupportLevel) < 1) {\r | |
82571fb5 | 56 | return (EFI_SUCCESS);\r |
a405b86d | 57 | }\r |
58 | \r | |
59 | gShellLevel1HiiHandle = HiiAddPackages (&gShellLevel1HiiGuid, gImageHandle, UefiShellLevel1CommandsLibStrings, NULL);\r | |
60 | if (gShellLevel1HiiHandle == NULL) {\r | |
61 | return (EFI_DEVICE_ERROR);\r | |
62 | }\r | |
63 | \r | |
64 | //\r | |
65 | // install our shell command handlers that are always installed\r | |
66 | //\r | |
77dcec12 | 67 | ShellCommandRegisterCommandName(L"stall", ShellCommandRunStall , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_STALL) ));\r |
a405b86d | 68 | ShellCommandRegisterCommandName(L"for", ShellCommandRunFor , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_FOR) ));\r |
69 | ShellCommandRegisterCommandName(L"goto", ShellCommandRunGoto , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_GOTO) ));\r | |
70 | ShellCommandRegisterCommandName(L"if", ShellCommandRunIf , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_IF) ));\r | |
71 | ShellCommandRegisterCommandName(L"shift", ShellCommandRunShift , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_SHIFT) ));\r | |
72 | ShellCommandRegisterCommandName(L"exit", ShellCommandRunExit , ShellCommandGetManFileNameLevel1, 1, L"", TRUE , gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_EXIT) ));\r | |
73 | ShellCommandRegisterCommandName(L"else", ShellCommandRunElse , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_ELSE) ));\r | |
74 | ShellCommandRegisterCommandName(L"endif", ShellCommandRunEndIf , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_ENDIF) ));\r | |
75 | ShellCommandRegisterCommandName(L"endfor", ShellCommandRunEndFor , ShellCommandGetManFileNameLevel1, 1, L"", FALSE, gShellLevel1HiiHandle, (EFI_STRING_ID)(PcdGet8(PcdShellSupportLevel) < 3 ? 0 : STRING_TOKEN(STR_GET_HELP_ENDFOR)));\r | |
76 | \r | |
77 | return (EFI_SUCCESS);\r | |
78 | }\r | |
79 | \r | |
80 | /**\r | |
81 | Destructor for the library. free any resources.\r | |
77dcec12 | 82 | \r |
83 | @param ImageHandle The image handle of the process.\r | |
84 | @param SystemTable The EFI System Table pointer.\r | |
a405b86d | 85 | **/\r |
86 | EFI_STATUS\r | |
87 | EFIAPI\r | |
88 | ShellLevel1CommandsLibDestructor (\r | |
89 | IN EFI_HANDLE ImageHandle,\r | |
90 | IN EFI_SYSTEM_TABLE *SystemTable\r | |
91 | )\r | |
92 | {\r | |
93 | if (gShellLevel1HiiHandle != NULL) {\r | |
94 | HiiRemovePackages(gShellLevel1HiiHandle);\r | |
95 | }\r | |
96 | return (EFI_SUCCESS);\r | |
97 | }\r | |
98 | \r | |
77dcec12 | 99 | /**\r |
100 | Test a node to see if meets the criterion.\r | |
101 | \r | |
102 | It functions so that count starts at 1 and it increases or decreases when it\r | |
103 | hits the specified tags. when it hits zero the location has been found.\r | |
104 | \r | |
105 | DecrementerTag and IncrementerTag are used to get around for/endfor and \r | |
106 | similar paired types where the entire middle should be ignored.\r | |
107 | \r | |
108 | If label is used it will be used instead of the count.\r | |
109 | \r | |
4ff7e37b ED |
110 | @param[in] Function The function to use to enumerate through the \r |
111 | list. Normally GetNextNode or GetPreviousNode.\r | |
112 | @param[in] DecrementerTag The tag to decrement the count at.\r | |
113 | @param[in] IncrementerTag The tag to increment the count at.\r | |
114 | @param[in] Label A label to look for.\r | |
115 | @param[in, out] ScriptFile The pointer to the current script file structure.\r | |
116 | @param[in] MovePast TRUE makes function return 1 past the found \r | |
117 | location.\r | |
118 | @param[in] FindOnly TRUE to not change the ScriptFile.\r | |
119 | @param[in] CommandNode The pointer to the Node to test.\r | |
120 | @param[in, out] TargetCount The pointer to the current count.\r | |
77dcec12 | 121 | **/\r |
a405b86d | 122 | BOOLEAN\r |
123 | EFIAPI\r | |
124 | TestNodeForMove (\r | |
125 | IN CONST LIST_MANIP_FUNC Function,\r | |
126 | IN CONST CHAR16 *DecrementerTag,\r | |
127 | IN CONST CHAR16 *IncrementerTag,\r | |
128 | IN CONST CHAR16 *Label OPTIONAL,\r | |
77dcec12 | 129 | IN OUT SCRIPT_FILE *ScriptFile,\r |
a405b86d | 130 | IN CONST BOOLEAN MovePast,\r |
131 | IN CONST BOOLEAN FindOnly,\r | |
132 | IN CONST SCRIPT_COMMAND_LIST *CommandNode,\r | |
77dcec12 | 133 | IN OUT UINTN *TargetCount\r |
a405b86d | 134 | )\r |
135 | {\r | |
136 | BOOLEAN Found;\r | |
137 | CHAR16 *CommandName;\r | |
138 | CHAR16 *CommandNameWalker;\r | |
139 | CHAR16 *TempLocation;\r | |
140 | \r | |
141 | Found = FALSE;\r | |
142 | \r | |
143 | //\r | |
144 | // get just the first part of the command line...\r | |
145 | //\r | |
146 | CommandName = NULL;\r | |
147 | CommandName = StrnCatGrow(&CommandName, NULL, CommandNode->Cl, 0);\r | |
532691c8 | 148 | if (CommandName == NULL) {\r |
149 | return (FALSE);\r | |
150 | }\r | |
151 | \r | |
a405b86d | 152 | CommandNameWalker = CommandName;\r |
153 | while(CommandNameWalker[0] == L' ') {\r | |
154 | CommandNameWalker++;\r | |
155 | }\r | |
156 | TempLocation = StrStr(CommandNameWalker, L" ");\r | |
157 | \r | |
158 | if (TempLocation != NULL) {\r | |
159 | *TempLocation = CHAR_NULL;\r | |
160 | }\r | |
161 | \r | |
162 | //\r | |
163 | // did we find a nested item ?\r | |
164 | //\r | |
165 | if (gUnicodeCollation->StriColl(\r | |
166 | gUnicodeCollation,\r | |
167 | (CHAR16*)CommandNameWalker,\r | |
168 | (CHAR16*)IncrementerTag) == 0) {\r | |
169 | (*TargetCount)++;\r | |
170 | } else if (gUnicodeCollation->StriColl(\r | |
171 | gUnicodeCollation,\r | |
172 | (CHAR16*)CommandNameWalker,\r | |
173 | (CHAR16*)DecrementerTag) == 0) {\r | |
174 | if (*TargetCount > 0) {\r | |
175 | (*TargetCount)--;\r | |
176 | }\r | |
177 | }\r | |
178 | \r | |
179 | //\r | |
180 | // did we find the matching one...\r | |
181 | //\r | |
182 | if (Label == NULL) {\r | |
183 | if (*TargetCount == 0) {\r | |
184 | Found = TRUE;\r | |
185 | if (!FindOnly) {\r | |
186 | if (MovePast) {\r | |
187 | ScriptFile->CurrentCommand = (SCRIPT_COMMAND_LIST *)(*Function)(&ScriptFile->CommandList, &CommandNode->Link);\r | |
188 | } else {\r | |
189 | ScriptFile->CurrentCommand = (SCRIPT_COMMAND_LIST *)CommandNode;\r | |
190 | }\r | |
191 | }\r | |
192 | }\r | |
193 | } else {\r | |
194 | if (gUnicodeCollation->StriColl(\r | |
195 | gUnicodeCollation,\r | |
196 | (CHAR16*)CommandNameWalker,\r | |
197 | (CHAR16*)Label) == 0\r | |
198 | && (*TargetCount) == 0) {\r | |
199 | Found = TRUE;\r | |
200 | if (!FindOnly) {\r | |
201 | //\r | |
202 | // we found the target label without loops\r | |
203 | //\r | |
204 | if (MovePast) {\r | |
205 | ScriptFile->CurrentCommand = (SCRIPT_COMMAND_LIST *)(*Function)(&ScriptFile->CommandList, &CommandNode->Link);\r | |
206 | } else {\r | |
207 | ScriptFile->CurrentCommand = (SCRIPT_COMMAND_LIST *)CommandNode;\r | |
208 | }\r | |
209 | }\r | |
210 | }\r | |
211 | }\r | |
212 | \r | |
213 | //\r | |
214 | // Free the memory for this loop...\r | |
215 | //\r | |
216 | FreePool(CommandName);\r | |
217 | return (Found);\r | |
218 | }\r | |
219 | \r | |
77dcec12 | 220 | /**\r |
221 | Move the script pointer from 1 tag (line) to another.\r | |
222 | \r | |
223 | It functions so that count starts at 1 and it increases or decreases when it\r | |
224 | hits the specified tags. when it hits zero the location has been found.\r | |
225 | \r | |
226 | DecrementerTag and IncrementerTag are used to get around for/endfor and \r | |
227 | similar paired types where the entire middle should be ignored.\r | |
228 | \r | |
229 | If label is used it will be used instead of the count.\r | |
230 | \r | |
4ff7e37b ED |
231 | @param[in] Function The function to use to enumerate through the \r |
232 | list. Normally GetNextNode or GetPreviousNode.\r | |
233 | @param[in] DecrementerTag The tag to decrement the count at.\r | |
234 | @param[in] IncrementerTag The tag to increment the count at.\r | |
235 | @param[in] Label A label to look for.\r | |
236 | @param[in, out] ScriptFile The pointer to the current script file structure.\r | |
237 | @param[in] MovePast TRUE makes function return 1 past the found \r | |
238 | location.\r | |
239 | @param[in] FindOnly TRUE to not change the ScriptFile.\r | |
240 | @param[in] WrapAroundScript TRUE to wrap end-to-begining or vise versa in \r | |
241 | searching.\r | |
77dcec12 | 242 | **/\r |
a405b86d | 243 | BOOLEAN\r |
244 | EFIAPI\r | |
245 | MoveToTag (\r | |
246 | IN CONST LIST_MANIP_FUNC Function,\r | |
247 | IN CONST CHAR16 *DecrementerTag,\r | |
248 | IN CONST CHAR16 *IncrementerTag,\r | |
249 | IN CONST CHAR16 *Label OPTIONAL,\r | |
77dcec12 | 250 | IN OUT SCRIPT_FILE *ScriptFile,\r |
a405b86d | 251 | IN CONST BOOLEAN MovePast,\r |
252 | IN CONST BOOLEAN FindOnly,\r | |
253 | IN CONST BOOLEAN WrapAroundScript\r | |
254 | )\r | |
255 | {\r | |
256 | SCRIPT_COMMAND_LIST *CommandNode;\r | |
257 | BOOLEAN Found;\r | |
258 | UINTN TargetCount;\r | |
259 | \r | |
260 | if (Label == NULL) {\r | |
261 | TargetCount = 1;\r | |
262 | } else {\r | |
263 | TargetCount = 0;\r | |
264 | }\r | |
265 | \r | |
266 | if (ScriptFile == NULL) {\r | |
267 | return FALSE;\r | |
268 | }\r | |
269 | \r | |
270 | for (CommandNode = (SCRIPT_COMMAND_LIST *)(*Function)(&ScriptFile->CommandList, &ScriptFile->CurrentCommand->Link), Found = FALSE\r | |
271 | ; !IsNull(&ScriptFile->CommandList, &CommandNode->Link)&& !Found\r | |
272 | ; CommandNode = (SCRIPT_COMMAND_LIST *)(*Function)(&ScriptFile->CommandList, &CommandNode->Link)\r | |
273 | ){\r | |
274 | Found = TestNodeForMove(\r | |
275 | Function,\r | |
276 | DecrementerTag,\r | |
277 | IncrementerTag,\r | |
278 | Label,\r | |
279 | ScriptFile,\r | |
280 | MovePast,\r | |
281 | FindOnly,\r | |
282 | CommandNode,\r | |
283 | &TargetCount);\r | |
284 | }\r | |
285 | \r | |
286 | if (WrapAroundScript && !Found) {\r | |
287 | for (CommandNode = (SCRIPT_COMMAND_LIST *)GetFirstNode(&ScriptFile->CommandList), Found = FALSE\r | |
288 | ; CommandNode != ScriptFile->CurrentCommand && !Found\r | |
289 | ; CommandNode = (SCRIPT_COMMAND_LIST *)(*Function)(&ScriptFile->CommandList, &CommandNode->Link)\r | |
290 | ){\r | |
291 | Found = TestNodeForMove(\r | |
292 | Function,\r | |
293 | DecrementerTag,\r | |
294 | IncrementerTag,\r | |
295 | Label,\r | |
296 | ScriptFile,\r | |
297 | MovePast,\r | |
298 | FindOnly,\r | |
299 | CommandNode,\r | |
300 | &TargetCount);\r | |
301 | }\r | |
302 | }\r | |
303 | return (Found);\r | |
304 | }\r | |
305 | \r |