code.delx.au - refind/blob - refind/config.c

   1 /*
   2  * refind/config.c
   3  * Configuration file functions
   4  *
   5  * Copyright (c) 2006 Christoph Pfisterer
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions are
  10  * met:
  11  *
  12  *  * Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  *
  15  *  * Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in the
  17  *    documentation and/or other materials provided with the
  18  *    distribution.
  19  *
  20  *  * Neither the name of Christoph Pfisterer nor the names of the
  21  *    contributors may be used to endorse or promote products derived
  22  *    from this software without specific prior written permission.
  23  *
  24  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  25  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  26  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  27  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  28  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  29  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  30  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  31  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  32  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  33  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  34  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  35  */
  36
  37 /*
  38  * Modifications copyright (c) 2012-2014 Roderick W. Smith
  39  *
  40  * Modifications distributed under the terms of the GNU General Public
  41  * License (GPL) version 3 (GPLv3), a copy of which must be distributed
  42  * with this source code or binaries made from it.
  43  *
  44  */
  45
  46 #include "global.h"
  47 #include "lib.h"
  48 #include "icns.h"
  49 #include "menu.h"
  50 #include "config.h"
  51 #include "screen.h"
  52 #include "../include/refit_call_wrapper.h"
  53 #include "../mok/mok.h"
  54
  55 // constants
  56
  57 #define LINUX_OPTIONS_FILENAMES  L"refind_linux.conf,refind-linux.conf"
  58 #define MAXCONFIGFILESIZE        (128*1024)
  59
  60 #define ENCODING_ISO8859_1  (0)
  61 #define ENCODING_UTF8       (1)
  62 #define ENCODING_UTF16_LE   (2)
  63
  64 #define GetTime ST->RuntimeServices->GetTime
  65 #define LAST_MINUTE 1439 /* Last minute of a day */
  66
  67 static REFIT_MENU_ENTRY MenuEntryReturn   = { L"Return to Main Menu", TAG_RETURN, 0, 0, 0, NULL, NULL, NULL };
  68
  69 //
  70 // read a file into a buffer
  71 //
  72
  73 EFI_STATUS ReadFile(IN EFI_FILE_HANDLE BaseDir, IN CHAR16 *FileName, IN OUT REFIT_FILE *File, OUT UINTN *size)
  74 {
  75     EFI_STATUS      Status;
  76     EFI_FILE_HANDLE FileHandle;
  77     EFI_FILE_INFO   *FileInfo;
  78     UINT64          ReadSize;
  79     CHAR16          Message[256];
  80
  81     File->Buffer = NULL;
  82     File->BufferSize = 0;
  83
  84     // read the file, allocating a buffer on the way
  85     Status = refit_call5_wrapper(BaseDir->Open, BaseDir, &FileHandle, FileName, EFI_FILE_MODE_READ, 0);
  86     SPrint(Message, 255, L"while loading the file '%s'", FileName);
  87     if (CheckError(Status, Message))
  88         return Status;
  89
  90     FileInfo = LibFileInfo(FileHandle);
  91     if (FileInfo == NULL) {
  92         // TODO: print and register the error
  93         refit_call1_wrapper(FileHandle->Close, FileHandle);
  94         return EFI_LOAD_ERROR;
  95     }
  96     ReadSize = FileInfo->FileSize;
  97     FreePool(FileInfo);
  98
  99     File->BufferSize = (UINTN)ReadSize;
 100     File->Buffer = AllocatePool(File->BufferSize);
 101     if (File->Buffer == NULL) {
 102        size = 0;
 103        return EFI_OUT_OF_RESOURCES;
 104     } else {
 105        *size = File->BufferSize;
 106     } // if/else
 107     Status = refit_call3_wrapper(FileHandle->Read, FileHandle, &File->BufferSize, File->Buffer);
 108     if (CheckError(Status, Message)) {
 109         MyFreePool(File->Buffer);
 110         File->Buffer = NULL;
 111         refit_call1_wrapper(FileHandle->Close, FileHandle);
 112         return Status;
 113     }
 114     Status = refit_call1_wrapper(FileHandle->Close, FileHandle);
 115
 116     // setup for reading
 117     File->Current8Ptr  = (CHAR8 *)File->Buffer;
 118     File->End8Ptr      = File->Current8Ptr + File->BufferSize;
 119     File->Current16Ptr = (CHAR16 *)File->Buffer;
 120     File->End16Ptr     = File->Current16Ptr + (File->BufferSize >> 1);
 121
 122     // detect encoding
 123     File->Encoding = ENCODING_ISO8859_1;   // default: 1:1 translation of CHAR8 to CHAR16
 124     if (File->BufferSize >= 4) {
 125         if (File->Buffer[0] == 0xFF && File->Buffer[1] == 0xFE) {
 126             // BOM in UTF-16 little endian (or UTF-32 little endian)
 127             File->Encoding = ENCODING_UTF16_LE;   // use CHAR16 as is
 128             File->Current16Ptr++;
 129         } else if (File->Buffer[0] == 0xEF && File->Buffer[1] == 0xBB && File->Buffer[2] == 0xBF) {
 130             // BOM in UTF-8
 131             File->Encoding = ENCODING_UTF8;       // translate from UTF-8 to UTF-16
 132             File->Current8Ptr += 3;
 133         } else if (File->Buffer[1] == 0 && File->Buffer[3] == 0) {
 134             File->Encoding = ENCODING_UTF16_LE;   // use CHAR16 as is
 135         }
 136         // TODO: detect other encodings as they are implemented
 137     }
 138
 139     return EFI_SUCCESS;
 140 }
 141
 142 //
 143 // get a single line of text from a file
 144 //
 145
 146 static CHAR16 *ReadLine(REFIT_FILE *File)
 147 {
 148     CHAR16  *Line, *q;
 149     UINTN   LineLength;
 150
 151     if (File->Buffer == NULL)
 152         return NULL;
 153
 154     if (File->Encoding == ENCODING_ISO8859_1 || File->Encoding == ENCODING_UTF8) {
 155
 156         CHAR8 *p, *LineStart, *LineEnd;
 157
 158         p = File->Current8Ptr;
 159         if (p >= File->End8Ptr)
 160             return NULL;
 161
 162         LineStart = p;
 163         for (; p < File->End8Ptr; p++)
 164             if (*p == 13 || *p == 10)
 165                 break;
 166         LineEnd = p;
 167         for (; p < File->End8Ptr; p++)
 168             if (*p != 13 && *p != 10)
 169                 break;
 170         File->Current8Ptr = p;
 171
 172         LineLength = (UINTN)(LineEnd - LineStart) + 1;
 173         Line = AllocatePool(LineLength * sizeof(CHAR16));
 174         if (Line == NULL)
 175             return NULL;
 176
 177         q = Line;
 178         if (File->Encoding == ENCODING_ISO8859_1) {
 179             for (p = LineStart; p < LineEnd; )
 180                 *q++ = *p++;
 181         } else if (File->Encoding == ENCODING_UTF8) {
 182             // TODO: actually handle UTF-8
 183             for (p = LineStart; p < LineEnd; )
 184                 *q++ = *p++;
 185         }
 186         *q = 0;
 187
 188     } else if (File->Encoding == ENCODING_UTF16_LE) {
 189
 190         CHAR16 *p, *LineStart, *LineEnd;
 191
 192         p = File->Current16Ptr;
 193         if (p >= File->End16Ptr)
 194             return NULL;
 195
 196         LineStart = p;
 197         for (; p < File->End16Ptr; p++)
 198             if (*p == 13 || *p == 10)
 199                 break;
 200         LineEnd = p;
 201         for (; p < File->End16Ptr; p++)
 202             if (*p != 13 && *p != 10)
 203                 break;
 204         File->Current16Ptr = p;
 205
 206         LineLength = (UINTN)(LineEnd - LineStart) + 1;
 207         Line = AllocatePool(LineLength * sizeof(CHAR16));
 208         if (Line == NULL)
 209             return NULL;
 210
 211         for (p = LineStart, q = Line; p < LineEnd; )
 212             *q++ = *p++;
 213         *q = 0;
 214
 215     } else
 216         return NULL;   // unsupported encoding
 217
 218     return Line;
 219 }
 220
 221 // Returns FALSE if *p points to the end of a token, TRUE otherwise.
 222 // Also modifies *p **IF** the first and second characters are both
 223 // quotes ('"'); it deletes one of them.
 224 static BOOLEAN KeepReading(IN OUT CHAR16 *p, IN OUT BOOLEAN *IsQuoted) {
 225    BOOLEAN MoreToRead = FALSE;
 226    CHAR16  *Temp = NULL;
 227
 228    if ((p == NULL) || (IsQuoted == NULL))
 229       return FALSE;
 230
 231    if (*p == L'\0')
 232       return FALSE;
 233
 234    if ((*p != ' ' && *p != '\t' && *p != '=' && *p != '#' && *p != ',') || *IsQuoted) {
 235       MoreToRead = TRUE;
 236    }
 237    if (*p == L'"') {
 238       if (p[1] == L'"') {
 239          Temp = StrDuplicate(&p[1]);
 240          if (Temp != NULL) {
 241             StrCpy(p, Temp);
 242             FreePool(Temp);
 243          }
 244          MoreToRead = TRUE;
 245       } else {
 246          *IsQuoted = !(*IsQuoted);
 247          MoreToRead = FALSE;
 248       } // if/else second character is a quote
 249    } // if first character is a quote
 250
 251    return MoreToRead;
 252 } // BOOLEAN KeepReading()
 253
 254 //
 255 // get a line of tokens from a file
 256 //
 257 UINTN ReadTokenLine(IN REFIT_FILE *File, OUT CHAR16 ***TokenList)
 258 {
 259     BOOLEAN         LineFinished, IsQuoted = FALSE;
 260     CHAR16          *Line, *Token, *p;
 261     UINTN           TokenCount = 0;
 262
 263     *TokenList = NULL;
 264
 265     while (TokenCount == 0) {
 266         Line = ReadLine(File);
 267         if (Line == NULL)
 268             return(0);
 269
 270         p = Line;
 271         LineFinished = FALSE;
 272         while (!LineFinished) {
 273             // skip whitespace & find start of token
 274             while ((*p == ' ' || *p == '\t' || *p == '=' || *p == ',') && !IsQuoted)
 275                 p++;
 276             if (*p == 0 || *p == '#')
 277                 break;
 278
 279             if (*p == '"') {
 280                IsQuoted = !IsQuoted;
 281                p++;
 282             } // if
 283             Token = p;
 284
 285             // find end of token
 286             while (KeepReading(p, &IsQuoted)) {
 287                if ((*p == L'/') && !IsQuoted) // Switch Unix-style to DOS-style directory separators
 288                   *p = L'\\';
 289                p++;
 290             } // while
 291             if (*p == L'\0' || *p == L'#')
 292                 LineFinished = TRUE;
 293             *p++ = 0;
 294
 295             AddListElement((VOID ***)TokenList, &TokenCount, (VOID *)StrDuplicate(Token));
 296         }
 297
 298         FreePool(Line);
 299     }
 300     return (TokenCount);
 301 } /* ReadTokenLine() */
 302
 303 VOID FreeTokenLine(IN OUT CHAR16 ***TokenList, IN OUT UINTN *TokenCount)
 304 {
 305     // TODO: also free the items
 306     FreeList((VOID ***)TokenList, TokenCount);
 307 }
 308
 309 // handle a parameter with a single integer argument
 310 static VOID HandleInt(IN CHAR16 **TokenList, IN UINTN TokenCount, OUT UINTN *Value)
 311 {
 312     if (TokenCount == 2) {
 313        if (StriCmp(TokenList[1], L"-1") == 0)
 314           *Value = -1;
 315        else
 316           *Value = Atoi(TokenList[1]);
 317     }
 318 }
 319
 320 // handle a parameter with a single string argument
 321 static VOID HandleString(IN CHAR16 **TokenList, IN UINTN TokenCount, OUT CHAR16 **Target) {
 322    if ((TokenCount == 2) && Target) {
 323       if ((StrLen(TokenList[1]) > 1) && (TokenList[1][0] == L'+') &&
 324           ((TokenList[1][1] == L',') || (TokenList[1][1] == L' '))) {
 325          if (*Target) {
 326             MergeStrings(Target, TokenList[1] + 2, L',');
 327          } else {
 328             *Target = StrDuplicate(TokenList[1] + 2);
 329          } // if/else
 330       } else {
 331          MyFreePool(*Target);
 332          *Target = StrDuplicate(TokenList[1]);
 333       } // if/else
 334    } // if
 335 } // static VOID HandleString()
 336
 337 // Handle a parameter with a series of string arguments, to replace or be added to a
 338 // comma-delimited list. Passes each token through the CleanUpPathNameSlashes() function
 339 // to ensure consistency in subsequent comparisons of filenames. If the first
 340 // non-keyword token is "+", the list is added to the existing target string; otherwise,
 341 // the tokens replace the current string.
 342 static VOID HandleStrings(IN CHAR16 **TokenList, IN UINTN TokenCount, OUT CHAR16 **Target) {
 343    UINTN i;
 344    BOOLEAN AddMode = FALSE;
 345
 346    if ((TokenCount > 2) && (StriCmp(TokenList[1], L"+") == 0)) {
 347       AddMode = TRUE;
 348    }
 349
 350    if ((*Target != NULL) && !AddMode) {
 351       FreePool(*Target);
 352       *Target = NULL;
 353    } // if
 354    for (i = 1; i < TokenCount; i++) {
 355       if ((i != 1) || !AddMode) {
 356          CleanUpPathNameSlashes(TokenList[i]);
 357          MergeStrings(Target, TokenList[i], L',');
 358       } // if
 359    } // for
 360 } // static VOID HandleStrings()
 361
 362 // Convert TimeString (in "HH:MM" format) to a pure-minute format. Values should be
 363 // in the range from 0 (for 00:00, or midnight) to 1439 (for 23:59; aka LAST_MINUTE).
 364 // Any value outside that range denotes an error in the specification. Note that if
 365 // the input is a number that includes no colon, this function will return the original
 366 // number in UINTN form.
 367 static UINTN HandleTime(IN CHAR16 *TimeString) {
 368    UINTN Hour = 0, Minute = 0, TimeLength, i = 0;
 369
 370    TimeLength = StrLen(TimeString);
 371    while (i < TimeLength) {
 372       if (TimeString[i] == L':') {
 373          Hour = Minute;
 374          Minute = 0;
 375       } // if
 376       if ((TimeString[i] >= L'0') && (TimeString[i] <= '9')) {
 377          Minute *= 10;
 378          Minute += (TimeString[i] - L'0');
 379       } // if
 380       i++;
 381    } // while
 382    return (Hour * 60 + Minute);
 383 } // BOOLEAN HandleTime()
 384
 385 static BOOLEAN HandleBoolean(IN CHAR16 **TokenList, IN UINTN TokenCount) {
 386    BOOLEAN TruthValue = TRUE;
 387
 388    if ((TokenCount >= 2) && ((StriCmp(TokenList[1], L"0") == 0) ||
 389                              (StriCmp(TokenList[1], L"false") == 0) ||
 390                              (StriCmp(TokenList[1], L"off") == 0))) {
 391       TruthValue = FALSE;
 392    } // if
 393
 394    return TruthValue;
 395 } // BOOLEAN HandleBoolean
 396
 397 // Sets the default boot loader IF the current time is within the bounds
 398 // defined by the third and fourth tokens in the TokenList.
 399 static VOID SetDefaultByTime(IN CHAR16 **TokenList, OUT CHAR16 **Default) {
 400    EFI_STATUS            Status;
 401    EFI_TIME              CurrentTime;
 402    UINTN                 StartTime = LAST_MINUTE + 1, EndTime = LAST_MINUTE + 1, Now;
 403    BOOLEAN               SetIt = FALSE;
 404
 405    StartTime = HandleTime(TokenList[2]);
 406    EndTime = HandleTime(TokenList[3]);
 407
 408    if ((StartTime <= LAST_MINUTE) && (EndTime <= LAST_MINUTE)) {
 409       Status = refit_call2_wrapper(GetTime, &CurrentTime, NULL);
 410       if (Status != EFI_SUCCESS)
 411          return;
 412       Now = CurrentTime.Hour * 60 + CurrentTime.Minute;
 413
 414       if (Now > LAST_MINUTE) { // Shouldn't happen; just being paranoid
 415          Print(L"Warning: Impossible system time: %d:%d\n", CurrentTime.Hour, CurrentTime.Minute);
 416          return;
 417       } // if impossible time
 418
 419       if (StartTime < EndTime) { // Time range does NOT cross midnight
 420          if ((Now >= StartTime) && (Now <= EndTime))
 421             SetIt = TRUE;
 422       } else { // Time range DOES cross midnight
 423          if ((Now >= StartTime) && (Now <= EndTime))
 424             SetIt = TRUE;
 425       } // if/else time range crosses midnight
 426
 427       if (SetIt) {
 428          MyFreePool(*Default);
 429          *Default = StrDuplicate(TokenList[1]);
 430       } // if (SetIt)
 431    } // if ((StartTime <= LAST_MINUTE) && (EndTime <= LAST_MINUTE))
 432 } // VOID SetDefaultByTime()
 433
 434 // read config file
 435 VOID ReadConfig(CHAR16 *FileName)
 436 {
 437     EFI_STATUS      Status;
 438     REFIT_FILE      File;
 439     CHAR16          **TokenList;
 440     CHAR16          *FlagName;
 441     CHAR16          *TempStr = NULL;
 442     UINTN           TokenCount, i;
 443     EFI_GUID        RefindGuid = REFIND_GUID_VALUE;
 444
 445     // Set a few defaults only if we're loading the default file.
 446     if (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0) {
 447        MyFreePool(GlobalConfig.AlsoScan);
 448        GlobalConfig.AlsoScan = StrDuplicate(ALSO_SCAN_DIRS);
 449        MyFreePool(GlobalConfig.DontScanDirs);
 450        if (SelfVolume) {
 451           if (SelfVolume->VolName) {
 452              TempStr = SelfVolume->VolName ? StrDuplicate(SelfVolume->VolName) : NULL;
 453           } else {
 454              TempStr = AllocateZeroPool(256 * sizeof(CHAR16));
 455              if (TempStr != NULL)
 456                 SPrint(TempStr, 255, L"fs%d", SelfVolume->VolNumber);
 457           } // if/else
 458        }
 459        MergeStrings(&TempStr, SelfDirPath, L':');
 460        MergeStrings(&TempStr, MEMTEST_LOCATIONS, L',');
 461        GlobalConfig.DontScanDirs = TempStr;
 462        MyFreePool(GlobalConfig.DontScanFiles);
 463        GlobalConfig.DontScanFiles = StrDuplicate(DONT_SCAN_FILES);
 464        MergeStrings(&(GlobalConfig.DontScanFiles), MOK_NAMES, L',');
 465        MyFreePool(GlobalConfig.DontScanVolumes);
 466        GlobalConfig.DontScanVolumes = StrDuplicate(DONT_SCAN_VOLUMES);
 467        GlobalConfig.WindowsRecoveryFiles = StrDuplicate(WINDOWS_RECOVERY_FILES);
 468        if (GlobalConfig.DefaultSelection != NULL) {
 469           MyFreePool(GlobalConfig.DefaultSelection);
 470           GlobalConfig.DefaultSelection = NULL;
 471        }
 472        Status = EfivarGetRaw(&RefindGuid, L"PreviousBoot", (CHAR8**) &(GlobalConfig.DefaultSelection), &i);
 473        if (Status != EFI_SUCCESS)
 474           GlobalConfig.DefaultSelection = NULL;
 475     } // if
 476
 477     if (!FileExists(SelfDir, FileName)) {
 478         Print(L"Configuration file '%s' missing!\n", FileName);
 479         return;
 480     }
 481
 482     Status = ReadFile(SelfDir, FileName, &File, &i);
 483     if (EFI_ERROR(Status))
 484         return;
 485
 486     for (;;) {
 487         TokenCount = ReadTokenLine(&File, &TokenList);
 488         if (TokenCount == 0)
 489             break;
 490
 491         if (StriCmp(TokenList[0], L"timeout") == 0) {
 492             HandleInt(TokenList, TokenCount, &(GlobalConfig.Timeout));
 493
 494         } else if (StriCmp(TokenList[0], L"hideui") == 0) {
 495             for (i = 1; i < TokenCount; i++) {
 496                 FlagName = TokenList[i];
 497                 if (StriCmp(FlagName, L"banner") == 0) {
 498                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_BANNER;
 499                 } else if (StriCmp(FlagName, L"label") == 0) {
 500                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_LABEL;
 501                 } else if (StriCmp(FlagName, L"singleuser") == 0) {
 502                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_SINGLEUSER;
 503                 } else if (StriCmp(FlagName, L"hwtest") == 0) {
 504                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_HWTEST;
 505                 } else if (StriCmp(FlagName, L"arrows") == 0) {
 506                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_ARROWS;
 507                 } else if (StriCmp(FlagName, L"hints") == 0) {
 508                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_HINTS;
 509                 } else if (StriCmp(FlagName, L"editor") == 0) {
 510                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_EDITOR;
 511                 } else if (StriCmp(FlagName, L"safemode") == 0) {
 512                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_SAFEMODE;
 513                 } else if (StriCmp(FlagName, L"all") == 0) {
 514                    GlobalConfig.HideUIFlags = HIDEUI_FLAG_ALL;
 515                 } else {
 516                     Print(L" unknown hideui flag: '%s'\n", FlagName);
 517                 }
 518             }
 519
 520         } else if (StriCmp(TokenList[0], L"icons_dir") == 0) {
 521            HandleString(TokenList, TokenCount, &(GlobalConfig.IconsDir));
 522
 523         } else if (StriCmp(TokenList[0], L"scanfor") == 0) {
 524            for (i = 0; i < NUM_SCAN_OPTIONS; i++) {
 525               if (i < TokenCount)
 526                  GlobalConfig.ScanFor[i] = TokenList[i][0];
 527               else
 528                  GlobalConfig.ScanFor[i] = ' ';
 529            }
 530
 531         } else if (StriCmp(TokenList[0], L"uefi_deep_legacy_scan") == 0) {
 532            GlobalConfig.DeepLegacyScan = HandleBoolean(TokenList, TokenCount);
 533
 534         } else if ((StriCmp(TokenList[0], L"scan_delay") == 0) && (TokenCount == 2)) {
 535            HandleInt(TokenList, TokenCount, &(GlobalConfig.ScanDelay));
 536
 537         } else if (StriCmp(TokenList[0], L"also_scan_dirs") == 0) {
 538             HandleStrings(TokenList, TokenCount, &(GlobalConfig.AlsoScan));
 539
 540         } else if ((StriCmp(TokenList[0], L"don't_scan_volumes") == 0) || (StriCmp(TokenList[0], L"dont_scan_volumes") == 0)) {
 541            // Note: Don't use HandleStrings() because it modifies slashes, which might be present in volume name
 542            MyFreePool(GlobalConfig.DontScanVolumes);
 543            GlobalConfig.DontScanVolumes = NULL;
 544            for (i = 1; i < TokenCount; i++) {
 545               MergeStrings(&GlobalConfig.DontScanVolumes, TokenList[i], L',');
 546            }
 547
 548         } else if ((StriCmp(TokenList[0], L"don't_scan_dirs") == 0) || (StriCmp(TokenList[0], L"dont_scan_dirs") == 0)) {
 549             HandleStrings(TokenList, TokenCount, &(GlobalConfig.DontScanDirs));
 550
 551         } else if ((StriCmp(TokenList[0], L"don't_scan_files") == 0) || (StriCmp(TokenList[0], L"dont_scan_files") == 0)) {
 552            HandleStrings(TokenList, TokenCount, &(GlobalConfig.DontScanFiles));
 553
 554         } else if (StriCmp(TokenList[0], L"windows_recovery_files") == 0) {
 555            HandleStrings(TokenList, TokenCount, &(GlobalConfig.WindowsRecoveryFiles));
 556
 557         } else if (StriCmp(TokenList[0], L"scan_driver_dirs") == 0) {
 558             HandleStrings(TokenList, TokenCount, &(GlobalConfig.DriverDirs));
 559
 560         } else if (StriCmp(TokenList[0], L"showtools") == 0) {
 561             SetMem(GlobalConfig.ShowTools, NUM_TOOLS * sizeof(UINTN), 0);
 562             for (i = 1; (i < TokenCount) && (i < NUM_TOOLS); i++) {
 563                 FlagName = TokenList[i];
 564                 if (StriCmp(FlagName, L"shell") == 0) {
 565                     GlobalConfig.ShowTools[i - 1] = TAG_SHELL;
 566                 } else if (StriCmp(FlagName, L"gptsync") == 0) {
 567                     GlobalConfig.ShowTools[i - 1] = TAG_GPTSYNC;
 568                 } else if (StriCmp(FlagName, L"gdisk") == 0) {
 569                    GlobalConfig.ShowTools[i - 1] = TAG_GDISK;
 570                 } else if (StriCmp(FlagName, L"about") == 0) {
 571                    GlobalConfig.ShowTools[i - 1] = TAG_ABOUT;
 572                 } else if (StriCmp(FlagName, L"exit") == 0) {
 573                    GlobalConfig.ShowTools[i - 1] = TAG_EXIT;
 574                 } else if (StriCmp(FlagName, L"reboot") == 0) {
 575                    GlobalConfig.ShowTools[i - 1] = TAG_REBOOT;
 576                 } else if (StriCmp(FlagName, L"shutdown") == 0) {
 577                    GlobalConfig.ShowTools[i - 1] = TAG_SHUTDOWN;
 578                 } else if (StriCmp(FlagName, L"apple_recovery") == 0) {
 579                    GlobalConfig.ShowTools[i - 1] = TAG_APPLE_RECOVERY;
 580                 } else if (StriCmp(FlagName, L"windows_recovery") == 0) {
 581                    GlobalConfig.ShowTools[i - 1] = TAG_WINDOWS_RECOVERY;
 582                 } else if (StriCmp(FlagName, L"mok_tool") == 0) {
 583                    GlobalConfig.ShowTools[i - 1] = TAG_MOK_TOOL;
 584                 } else if (StriCmp(FlagName, L"firmware") == 0) {
 585                    GlobalConfig.ShowTools[i - 1] = TAG_FIRMWARE;
 586                 } else if ((StriCmp(FlagName, L"memtest86") == 0) || (StriCmp(FlagName, L"memtest") == 0)) {
 587                    GlobalConfig.ShowTools[i - 1] = TAG_MEMTEST;
 588                 } else {
 589                    Print(L" unknown showtools flag: '%s'\n", FlagName);
 590                 }
 591             } // showtools options
 592
 593         } else if (StriCmp(TokenList[0], L"banner") == 0) {
 594            HandleString(TokenList, TokenCount, &(GlobalConfig.BannerFileName));
 595
 596         } else if ((StriCmp(TokenList[0], L"banner_scale") == 0) && (TokenCount == 2)) {
 597            if (StriCmp(TokenList[1], L"noscale") == 0) {
 598               GlobalConfig.BannerScale = BANNER_NOSCALE;
 599            } else if ((StriCmp(TokenList[1], L"fillscreen") == 0) || (StriCmp(TokenList[1], L"fullscreen") == 0)) {
 600               GlobalConfig.BannerScale = BANNER_FILLSCREEN;
 601            } else {
 602               Print(L" unknown banner_type flag: '%s'\n", TokenList[1]);
 603            } // if/else
 604
 605         } else if ((StriCmp(TokenList[0], L"small_icon_size") == 0) && (TokenCount == 2)) {
 606            HandleInt(TokenList, TokenCount, &i);
 607            if (i >= 32)
 608               GlobalConfig.IconSizes[ICON_SIZE_SMALL] = i;
 609
 610         } else if ((StriCmp(TokenList[0], L"big_icon_size") == 0) && (TokenCount == 2)) {
 611            HandleInt(TokenList, TokenCount, &i);
 612            if (i >= 32) {
 613               GlobalConfig.IconSizes[ICON_SIZE_BIG] = i;
 614               GlobalConfig.IconSizes[ICON_SIZE_BADGE] = i / 4;
 615            }
 616
 617         } else if (StriCmp(TokenList[0], L"selection_small") == 0) {
 618            HandleString(TokenList, TokenCount, &(GlobalConfig.SelectionSmallFileName));
 619
 620         } else if (StriCmp(TokenList[0], L"selection_big") == 0) {
 621            HandleString(TokenList, TokenCount, &(GlobalConfig.SelectionBigFileName));
 622
 623         } else if (StriCmp(TokenList[0], L"default_selection") == 0) {
 624            if (TokenCount == 4) {
 625               SetDefaultByTime(TokenList, &(GlobalConfig.DefaultSelection));
 626            } else {
 627               HandleString(TokenList, TokenCount, &(GlobalConfig.DefaultSelection));
 628            }
 629
 630         } else if (StriCmp(TokenList[0], L"textonly") == 0) {
 631            GlobalConfig.TextOnly = HandleBoolean(TokenList, TokenCount);
 632
 633         } else if (StriCmp(TokenList[0], L"textmode") == 0) {
 634            HandleInt(TokenList, TokenCount, &(GlobalConfig.RequestedTextMode));
 635
 636         } else if ((StriCmp(TokenList[0], L"resolution") == 0) && ((TokenCount == 2) || (TokenCount == 3))) {
 637            GlobalConfig.RequestedScreenWidth = Atoi(TokenList[1]);
 638            if (TokenCount == 3)
 639               GlobalConfig.RequestedScreenHeight = Atoi(TokenList[2]);
 640            else
 641               GlobalConfig.RequestedScreenHeight = 0;
 642
 643         } else if (StriCmp(TokenList[0], L"screensaver") == 0) {
 644            HandleInt(TokenList, TokenCount, &(GlobalConfig.ScreensaverTime));
 645
 646         } else if (StriCmp(TokenList[0], L"use_graphics_for") == 0) {
 647            if ((TokenCount == 2) || ((TokenCount > 2) && (StriCmp(TokenList[1], L"+") != 0)))
 648               GlobalConfig.GraphicsFor = 0;
 649            for (i = 1; i < TokenCount; i++) {
 650               if (StriCmp(TokenList[i], L"osx") == 0) {
 651                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_OSX;
 652               } else if (StriCmp(TokenList[i], L"linux") == 0) {
 653                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_LINUX;
 654               } else if (StriCmp(TokenList[i], L"elilo") == 0) {
 655                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_ELILO;
 656               } else if (StriCmp(TokenList[i], L"grub") == 0) {
 657                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_GRUB;
 658               } else if (StriCmp(TokenList[i], L"windows") == 0) {
 659                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_WINDOWS;
 660               }
 661            } // for (graphics_on tokens)
 662
 663         } else if ((StriCmp(TokenList[0], L"font") == 0) && (TokenCount == 2)) {
 664            egLoadFont(TokenList[1]);
 665
 666         } else if (StriCmp(TokenList[0], L"scan_all_linux_kernels") == 0) {
 667            GlobalConfig.ScanAllLinux = HandleBoolean(TokenList, TokenCount);
 668
 669         } else if (StriCmp(TokenList[0], L"max_tags") == 0) {
 670            HandleInt(TokenList, TokenCount, &(GlobalConfig.MaxTags));
 671
 672         } else if (StriCmp(TokenList[0], L"enable_and_lock_vmx") == 0) {
 673            GlobalConfig.EnableAndLockVMX = HandleBoolean(TokenList, TokenCount);
 674
 675         } else if ((StriCmp(TokenList[0], L"include") == 0) && (TokenCount == 2) &&
 676                    (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0)) {
 677            if (StriCmp(TokenList[1], FileName) != 0) {
 678               ReadConfig(TokenList[1]);
 679            }
 680
 681         }
 682
 683         FreeTokenLine(&TokenList, &TokenCount);
 684     }
 685     if ((GlobalConfig.DontScanFiles) && (GlobalConfig.WindowsRecoveryFiles))
 686        MergeStrings(&(GlobalConfig.DontScanFiles), GlobalConfig.WindowsRecoveryFiles, L',');
 687     MyFreePool(File.Buffer);
 688 } /* VOID ReadConfig() */
 689
 690 // Finds a volume with the specified Identifier (a filesystem label, a
 691 // partition name, a partition GUID, or a number followed by a colon). If
 692 // found, sets *Volume to point to that volume. If not, leaves it unchanged.
 693 // Returns TRUE if a match was found, FALSE if not.
 694 static BOOLEAN FindVolume(REFIT_VOLUME **Volume, CHAR16 *Identifier) {
 695    UINTN     i = 0, CountedVolumes = 0, Length;
 696    INTN      Number = -1;
 697    BOOLEAN   Found = FALSE, IdIsGuid = FALSE;
 698    EFI_GUID  VolGuid, NullGuid = NULL_GUID_VALUE;
 699
 700    VolGuid = StringAsGuid(Identifier);
 701    Length = StrLen(Identifier);
 702    if ((Length >= 2) && (Identifier[Length - 1] == L':') &&
 703        (Identifier[0] >= L'0') && (Identifier[0] <= L'9')) {
 704       Number = (INTN) Atoi(Identifier);
 705    } else if (IsGuid(Identifier)) {
 706       IdIsGuid = TRUE;
 707    }
 708    while ((i < VolumesCount) && (!Found)) {
 709       if (Number >= 0) { // User specified a volume by number
 710          if (Volumes[i]->IsReadable) {
 711             if (CountedVolumes == Number) {
 712                *Volume = Volumes[i];
 713                Found = TRUE;
 714             }
 715             CountedVolumes++;
 716          } // if
 717       } else { // User specified a volume by label or GUID
 718          if ((StriCmp(Identifier, Volumes[i]->VolName) == 0) ||
 719              (StriCmp(Identifier, Volumes[i]->PartName) == 0)) {
 720             *Volume = Volumes[i];
 721             Found = TRUE;
 722          } // if
 723          if (IdIsGuid && !Found) {
 724             if (GuidsAreEqual(&VolGuid, &(Volumes[i]->PartGuid)) && !GuidsAreEqual(&NullGuid, &(Volumes[i]->PartGuid))) {
 725                *Volume = Volumes[i];
 726                Found = TRUE;
 727             } // if
 728          } // if
 729       } // if/else
 730       i++;
 731    } // while()
 732    return (Found);
 733 } // static VOID FindVolume()
 734
 735 static VOID AddSubmenu(LOADER_ENTRY *Entry, REFIT_FILE *File, REFIT_VOLUME *Volume, CHAR16 *Title) {
 736    REFIT_MENU_SCREEN  *SubScreen;
 737    LOADER_ENTRY       *SubEntry;
 738    UINTN              TokenCount;
 739    CHAR16             **TokenList;
 740
 741    SubScreen = InitializeSubScreen(Entry);
 742
 743    // Set defaults for the new entry; will be modified based on lines read from the config. file....
 744    SubEntry = InitializeLoaderEntry(Entry);
 745
 746    if ((SubEntry == NULL) || (SubScreen == NULL))
 747       return;
 748    SubEntry->me.Title        = StrDuplicate(Title);
 749
 750    while (((TokenCount = ReadTokenLine(File, &TokenList)) > 0) && (StriCmp(TokenList[0], L"}") != 0)) {
 751
 752       if ((StriCmp(TokenList[0], L"loader") == 0) && (TokenCount > 1)) { // set the boot loader filename
 753          MyFreePool(SubEntry->LoaderPath);
 754          SubEntry->LoaderPath = StrDuplicate(TokenList[1]);
 755          SubEntry->DevicePath = FileDevicePath(Volume->DeviceHandle, SubEntry->LoaderPath);
 756
 757       } else if ((StriCmp(TokenList[0], L"volume") == 0) && (TokenCount > 1)) {
 758          if (FindVolume(&Volume, TokenList[1])) {
 759             MyFreePool(SubEntry->me.Title);
 760             SubEntry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 761             SPrint(SubEntry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", Volume->VolName);
 762             SubEntry->me.BadgeImage   = Volume->VolBadgeImage;
 763             SubEntry->VolName         = Volume->VolName;
 764          } // if match found
 765
 766       } else if (StriCmp(TokenList[0], L"initrd") == 0) {
 767          MyFreePool(SubEntry->InitrdPath);
 768          SubEntry->InitrdPath = NULL;
 769          if (TokenCount > 1) {
 770             SubEntry->InitrdPath = StrDuplicate(TokenList[1]);
 771          }
 772
 773       } else if (StriCmp(TokenList[0], L"options") == 0) {
 774          MyFreePool(SubEntry->LoadOptions);
 775          SubEntry->LoadOptions = NULL;
 776          if (TokenCount > 1) {
 777             SubEntry->LoadOptions = StrDuplicate(TokenList[1]);
 778          } // if/else
 779
 780       } else if ((StriCmp(TokenList[0], L"add_options") == 0) && (TokenCount > 1)) {
 781          MergeStrings(&SubEntry->LoadOptions, TokenList[1], L' ');
 782
 783       } else if ((StriCmp(TokenList[0], L"graphics") == 0) && (TokenCount > 1)) {
 784          SubEntry->UseGraphicsMode = (StriCmp(TokenList[1], L"on") == 0);
 785
 786       } else if (StriCmp(TokenList[0], L"disabled") == 0) {
 787          SubEntry->Enabled = FALSE;
 788       } // ief/elseif
 789
 790       FreeTokenLine(&TokenList, &TokenCount);
 791    } // while()
 792
 793    if (SubEntry->InitrdPath != NULL) {
 794       MergeStrings(&SubEntry->LoadOptions, L"initrd=", L' ');
 795       MergeStrings(&SubEntry->LoadOptions, SubEntry->InitrdPath, 0);
 796       MyFreePool(SubEntry->InitrdPath);
 797       SubEntry->InitrdPath = NULL;
 798    } // if
 799    if (SubEntry->Enabled == TRUE) {
 800       AddMenuEntry(SubScreen, (REFIT_MENU_ENTRY *)SubEntry);
 801    }
 802    Entry->me.SubScreen = SubScreen;
 803 } // VOID AddSubmenu()
 804
 805 // Adds the options from a SINGLE refind.conf stanza to a new loader entry and returns
 806 // that entry. The calling function is then responsible for adding the entry to the
 807 // list of entries.
 808 static LOADER_ENTRY * AddStanzaEntries(REFIT_FILE *File, REFIT_VOLUME *Volume, CHAR16 *Title) {
 809    CHAR16       **TokenList;
 810    UINTN        TokenCount;
 811    LOADER_ENTRY *Entry;
 812    BOOLEAN      DefaultsSet = FALSE, AddedSubmenu = FALSE;
 813    REFIT_VOLUME *CurrentVolume = Volume;
 814
 815    // prepare the menu entry
 816    Entry = InitializeLoaderEntry(NULL);
 817    if (Entry == NULL)
 818       return NULL;
 819
 820    Entry->Title           = StrDuplicate(Title);
 821    Entry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 822    SPrint(Entry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", CurrentVolume->VolName);
 823    Entry->me.Row          = 0;
 824    Entry->me.BadgeImage   = CurrentVolume->VolBadgeImage;
 825    Entry->VolName         = CurrentVolume->VolName;
 826
 827    // Parse the config file to add options for a single stanza, terminating when the token
 828    // is "}" or when the end of file is reached.
 829    while (((TokenCount = ReadTokenLine(File, &TokenList)) > 0) && (StriCmp(TokenList[0], L"}") != 0)) {
 830       if ((StriCmp(TokenList[0], L"loader") == 0) && (TokenCount > 1)) { // set the boot loader filename
 831          Entry->LoaderPath = StrDuplicate(TokenList[1]);
 832          Entry->DevicePath = FileDevicePath(CurrentVolume->DeviceHandle, Entry->LoaderPath);
 833          SetLoaderDefaults(Entry, TokenList[1], CurrentVolume);
 834          MyFreePool(Entry->LoadOptions);
 835          Entry->LoadOptions = NULL; // Discard default options, if any
 836          DefaultsSet = TRUE;
 837
 838       } else if ((StriCmp(TokenList[0], L"volume") == 0) && (TokenCount > 1)) {
 839          if (FindVolume(&CurrentVolume, TokenList[1])) {
 840             MyFreePool(Entry->me.Title);
 841             Entry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 842             SPrint(Entry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", CurrentVolume->VolName);
 843             Entry->me.BadgeImage   = CurrentVolume->VolBadgeImage;
 844             Entry->VolName         = CurrentVolume->VolName;
 845          } // if match found
 846
 847       } else if ((StriCmp(TokenList[0], L"icon") == 0) && (TokenCount > 1)) {
 848          MyFreePool(Entry->me.Image);
 849          Entry->me.Image = egLoadIcon(CurrentVolume->RootDir, TokenList[1], GlobalConfig.IconSizes[ICON_SIZE_BIG]);
 850          if (Entry->me.Image == NULL) {
 851             Entry->me.Image = DummyImage(GlobalConfig.IconSizes[ICON_SIZE_BIG]);
 852          }
 853
 854       } else if ((StriCmp(TokenList[0], L"initrd") == 0) && (TokenCount > 1)) {
 855          MyFreePool(Entry->InitrdPath);
 856          Entry->InitrdPath = StrDuplicate(TokenList[1]);
 857
 858       } else if ((StriCmp(TokenList[0], L"options") == 0) && (TokenCount > 1)) {
 859          MyFreePool(Entry->LoadOptions);
 860          Entry->LoadOptions = StrDuplicate(TokenList[1]);
 861
 862       } else if ((StriCmp(TokenList[0], L"ostype") == 0) && (TokenCount > 1)) {
 863          if (TokenCount > 1) {
 864             Entry->OSType = TokenList[1][0];
 865          }
 866
 867       } else if ((StriCmp(TokenList[0], L"graphics") == 0) && (TokenCount > 1)) {
 868          Entry->UseGraphicsMode = (StriCmp(TokenList[1], L"on") == 0);
 869
 870       } else if (StriCmp(TokenList[0], L"disabled") == 0) {
 871          Entry->Enabled = FALSE;
 872
 873       } else if ((StriCmp(TokenList[0], L"submenuentry") == 0) && (TokenCount > 1)) {
 874          AddSubmenu(Entry, File, CurrentVolume, TokenList[1]);
 875          AddedSubmenu = TRUE;
 876
 877       } // set options to pass to the loader program
 878       FreeTokenLine(&TokenList, &TokenCount);
 879    } // while()
 880
 881    if (AddedSubmenu)
 882        AddMenuEntry(Entry->me.SubScreen, &MenuEntryReturn);
 883
 884    if (Entry->InitrdPath) {
 885       MergeStrings(&Entry->LoadOptions, L"initrd=", L' ');
 886       MergeStrings(&Entry->LoadOptions, Entry->InitrdPath, 0);
 887       MyFreePool(Entry->InitrdPath);
 888       Entry->InitrdPath = NULL;
 889    } // if
 890
 891    if (!DefaultsSet)
 892       SetLoaderDefaults(Entry, L"\\EFI\\BOOT\\nemo.efi", CurrentVolume); // user included no "loader" line; use bogus one
 893
 894    return(Entry);
 895 } // static VOID AddStanzaEntries()
 896
 897 // Read the user-configured menu entries from refind.conf and add or delete
 898 // entries based on the contents of that file....
 899 VOID ScanUserConfigured(CHAR16 *FileName)
 900 {
 901    EFI_STATUS        Status;
 902    REFIT_FILE        File;
 903    REFIT_VOLUME      *Volume;
 904    CHAR16            **TokenList;
 905    CHAR16            *Title = NULL;
 906    UINTN             TokenCount, size;
 907    LOADER_ENTRY      *Entry;
 908
 909    if (FileExists(SelfDir, FileName)) {
 910       Status = ReadFile(SelfDir, FileName, &File, &size);
 911       if (EFI_ERROR(Status))
 912          return;
 913
 914       Volume = SelfVolume;
 915
 916       while ((TokenCount = ReadTokenLine(&File, &TokenList)) > 0) {
 917          if ((StriCmp(TokenList[0], L"menuentry") == 0) && (TokenCount > 1)) {
 918             Title = StrDuplicate(TokenList[1]);
 919             Entry = AddStanzaEntries(&File, Volume, TokenList[1]);
 920             if (Entry->Enabled) {
 921                if (Entry->me.SubScreen == NULL)
 922                   GenerateSubScreen(Entry, Volume);
 923                AddPreparedLoaderEntry(Entry);
 924             } else {
 925                MyFreePool(Entry);
 926             } // if/else
 927             MyFreePool(Title);
 928
 929          } else if ((StriCmp(TokenList[0], L"include") == 0) && (TokenCount == 2) &&
 930                     (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0)) {
 931             if (StriCmp(TokenList[1], FileName) != 0) {
 932                ScanUserConfigured(TokenList[1]);
 933             }
 934
 935          } // if/else if...
 936          FreeTokenLine(&TokenList, &TokenCount);
 937       } // while()
 938    } // if()
 939 } // VOID ScanUserConfigured()
 940
 941 // Create an options file based on /etc/fstab. The resulting file has two options
 942 // lines, one of which boots the system with "ro root={rootfs}" and the other of
 943 // which boots the system with "ro root={rootfs} single", where "{rootfs}" is the
 944 // filesystem identifier associated with the "/" line in /etc/fstab.
 945 static REFIT_FILE * GenerateOptionsFromEtcFstab(REFIT_VOLUME *Volume) {
 946    UINTN        TokenCount, i;
 947    REFIT_FILE   *Options = NULL, *Fstab = NULL;
 948    EFI_STATUS   Status;
 949    CHAR16       **TokenList, *Line, Root[100];
 950
 951    if (FileExists(Volume->RootDir, L"\\etc\\fstab")) {
 952       Options = AllocateZeroPool(sizeof(REFIT_FILE));
 953       Fstab = AllocateZeroPool(sizeof(REFIT_FILE));
 954       Status = ReadFile(Volume->RootDir, L"\\etc\\fstab", Fstab, &i);
 955       if (CheckError(Status, L"while reading /etc/fstab")) {
 956          if (Options != NULL)
 957             FreePool(Options);
 958          if (Fstab != NULL)
 959             FreePool(Fstab);
 960          Options = NULL;
 961          Fstab = NULL;
 962       } else { // File read; locate root fs and create entries
 963          Options->Encoding = ENCODING_UTF16_LE;
 964          while ((TokenCount = ReadTokenLine(Fstab, &TokenList)) > 0) {
 965             if (TokenCount > 2) {
 966                Root[0] = '\0';
 967                if (StriCmp(TokenList[1], L"\\") == 0) {
 968                   SPrint(Root, 99, L"%s", TokenList[0]);
 969                } else if (StriCmp(TokenList[2], L"\\") == 0) {
 970                   SPrint(Root, 99, L"%s=%s", TokenList[0], TokenList[1]);
 971                } // if/elseif/elseif
 972                if (Root[0] != L'\0') {
 973                   for (i = 0; i < StrLen(Root); i++)
 974                      if (Root[i] == '\\')
 975                         Root[i] = '/';
 976                   Line = PoolPrint(L"\"Boot with normal options\"    \"ro root=%s\"\n", Root);
 977                   MergeStrings((CHAR16 **) &(Options->Buffer), Line, 0);
 978                   MyFreePool(Line);
 979                   Line = PoolPrint(L"\"Boot into single-user mode\"  \"ro root=%s single\"\n", Root);
 980                   MergeStrings((CHAR16**) &(Options->Buffer), Line, 0);
 981                   Options->BufferSize = StrLen((CHAR16*) Options->Buffer) * sizeof(CHAR16);
 982                } // if
 983             } // if
 984             FreeTokenLine(&TokenList, &TokenCount);
 985          } // while
 986
 987          Options->Current8Ptr  = (CHAR8 *)Options->Buffer;
 988          Options->End8Ptr      = Options->Current8Ptr + Options->BufferSize;
 989          Options->Current16Ptr = (CHAR16 *)Options->Buffer;
 990          Options->End16Ptr     = Options->Current16Ptr + (Options->BufferSize >> 1);
 991
 992          MyFreePool(Fstab->Buffer);
 993          MyFreePool(Fstab);
 994       } // if/else file read error
 995    } // if /etc/fstab exists
 996    return Options;
 997 } // GenerateOptionsFromEtcFstab()
 998
 999
1000 // Read a Linux kernel options file for a Linux boot loader into memory. The LoaderPath
1001 // and Volume variables identify the location of the options file, but not its name --
1002 // you pass this function the filename of the Linux kernel, initial RAM disk, or other
1003 // file in the target directory, and this function finds the file with a name in the
1004 // comma-delimited list of names specified by LINUX_OPTIONS_FILENAMES within that
1005 // directory and loads it. This function tries multiple files because I originally
1006 // used the filename linux.conf, but close on the heels of that decision, the Linux
1007 // kernel developers decided to use that name for a similar purpose, but with a
1008 // different file format. Thus, I'm migrating rEFInd to use the name refind_linux.conf,
1009 // but I want a migration period in which both names are used.
1010 // If a rEFInd options file can't be found, try to generate minimal options from
1011 // /etc/fstab on the same volume as the kernel. This typically works only if the
1012 // kernel is being read from the Linux root filesystem.
1013 //
1014 // The return value is a pointer to the REFIT_FILE handle for the file, or NULL if
1015 // it wasn't found.
1016 REFIT_FILE * ReadLinuxOptionsFile(IN CHAR16 *LoaderPath, IN REFIT_VOLUME *Volume) {
1017    CHAR16       *OptionsFilename, *FullFilename;
1018    BOOLEAN      GoOn = TRUE, FileFound = FALSE;
1019    UINTN        i = 0, size;
1020    REFIT_FILE   *File = NULL;
1021    EFI_STATUS   Status;
1022
1023    do {
1024       OptionsFilename = FindCommaDelimited(LINUX_OPTIONS_FILENAMES, i++);
1025       FullFilename = FindPath(LoaderPath);
1026       if ((OptionsFilename != NULL) && (FullFilename != NULL)) {
1027          MergeStrings(&FullFilename, OptionsFilename, '\\');
1028          if (FileExists(Volume->RootDir, FullFilename)) {
1029             File = AllocateZeroPool(sizeof(REFIT_FILE));
1030             Status = ReadFile(Volume->RootDir, FullFilename, File, &size);
1031             if (CheckError(Status, L"while loading the Linux options file")) {
1032                if (File != NULL)
1033                   FreePool(File);
1034                File = NULL;
1035             } else {
1036                GoOn = FALSE;
1037                FileFound = TRUE;
1038             } // if/else error
1039          } // if file exists
1040       } else { // a filename string is NULL
1041          GoOn = FALSE;
1042       } // if/else
1043       if (!FileFound)
1044          File = GenerateOptionsFromEtcFstab(Volume);
1045       MyFreePool(OptionsFilename);
1046       MyFreePool(FullFilename);
1047       OptionsFilename = FullFilename = NULL;
1048    } while (GoOn);
1049    return (File);
1050 } // static REFIT_FILE * ReadLinuxOptionsFile()
1051
1052 // Retrieve a single line of options from a Linux kernel options file
1053 CHAR16 * GetFirstOptionsFromFile(IN CHAR16 *LoaderPath, IN REFIT_VOLUME *Volume) {
1054    UINTN        TokenCount;
1055    CHAR16       *Options = NULL;
1056    CHAR16       **TokenList;
1057    REFIT_FILE   *File;
1058
1059    File = ReadLinuxOptionsFile(LoaderPath, Volume);
1060    if (File != NULL) {
1061       TokenCount = ReadTokenLine(File, &TokenList);
1062       if (TokenCount > 1)
1063          Options = StrDuplicate(TokenList[1]);
1064       FreeTokenLine(&TokenList, &TokenCount);
1065       FreePool(File);
1066    } // if
1067    return Options;
1068 } // static CHAR16 * GetOptionsFile()
1069