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    PauseForKey();
 336 } // static VOID HandleString()
 337
 338 // Handle a parameter with a series of string arguments, to replace or be added to a
 339 // comma-delimited list. Passes each token through the CleanUpPathNameSlashes() function
 340 // to ensure consistency in subsequent comparisons of filenames. If the first
 341 // non-keyword token is "+", the list is added to the existing target string; otherwise,
 342 // the tokens replace the current string.
 343 static VOID HandleStrings(IN CHAR16 **TokenList, IN UINTN TokenCount, OUT CHAR16 **Target) {
 344    UINTN i;
 345    BOOLEAN AddMode = FALSE;
 346
 347    if ((TokenCount > 2) && (StriCmp(TokenList[1], L"+") == 0)) {
 348       AddMode = TRUE;
 349    }
 350
 351    if ((*Target != NULL) && !AddMode) {
 352       FreePool(*Target);
 353       *Target = NULL;
 354    } // if
 355    for (i = 1; i < TokenCount; i++) {
 356       if ((i != 1) || !AddMode) {
 357          CleanUpPathNameSlashes(TokenList[i]);
 358          MergeStrings(Target, TokenList[i], L',');
 359       } // if
 360    } // for
 361 } // static VOID HandleStrings()
 362
 363 // Convert TimeString (in "HH:MM" format) to a pure-minute format. Values should be
 364 // in the range from 0 (for 00:00, or midnight) to 1439 (for 23:59; aka LAST_MINUTE).
 365 // Any value outside that range denotes an error in the specification. Note that if
 366 // the input is a number that includes no colon, this function will return the original
 367 // number in UINTN form.
 368 static UINTN HandleTime(IN CHAR16 *TimeString) {
 369    UINTN Hour = 0, Minute = 0, TimeLength, i = 0;
 370
 371    TimeLength = StrLen(TimeString);
 372    while (i < TimeLength) {
 373       if (TimeString[i] == L':') {
 374          Hour = Minute;
 375          Minute = 0;
 376       } // if
 377       if ((TimeString[i] >= L'0') && (TimeString[i] <= '9')) {
 378          Minute *= 10;
 379          Minute += (TimeString[i] - L'0');
 380       } // if
 381       i++;
 382    } // while
 383    return (Hour * 60 + Minute);
 384 } // BOOLEAN HandleTime()
 385
 386 static BOOLEAN HandleBoolean(IN CHAR16 **TokenList, IN UINTN TokenCount) {
 387    BOOLEAN TruthValue = TRUE;
 388
 389    if ((TokenCount >= 2) && ((StriCmp(TokenList[1], L"0") == 0) ||
 390                              (StriCmp(TokenList[1], L"false") == 0) ||
 391                              (StriCmp(TokenList[1], L"off") == 0))) {
 392       TruthValue = FALSE;
 393    } // if
 394
 395    return TruthValue;
 396 } // BOOLEAN HandleBoolean
 397
 398 // Sets the default boot loader IF the current time is within the bounds
 399 // defined by the third and fourth tokens in the TokenList.
 400 static VOID SetDefaultByTime(IN CHAR16 **TokenList, OUT CHAR16 **Default) {
 401    EFI_STATUS            Status;
 402    EFI_TIME              CurrentTime;
 403    UINTN                 StartTime = LAST_MINUTE + 1, EndTime = LAST_MINUTE + 1, Now;
 404    BOOLEAN               SetIt = FALSE;
 405
 406    StartTime = HandleTime(TokenList[2]);
 407    EndTime = HandleTime(TokenList[3]);
 408
 409    if ((StartTime <= LAST_MINUTE) && (EndTime <= LAST_MINUTE)) {
 410       Status = refit_call2_wrapper(GetTime, &CurrentTime, NULL);
 411       if (Status != EFI_SUCCESS)
 412          return;
 413       Now = CurrentTime.Hour * 60 + CurrentTime.Minute;
 414
 415       if (Now > LAST_MINUTE) { // Shouldn't happen; just being paranoid
 416          Print(L"Warning: Impossible system time: %d:%d\n", CurrentTime.Hour, CurrentTime.Minute);
 417          return;
 418       } // if impossible time
 419
 420       if (StartTime < EndTime) { // Time range does NOT cross midnight
 421          if ((Now >= StartTime) && (Now <= EndTime))
 422             SetIt = TRUE;
 423       } else { // Time range DOES cross midnight
 424          if ((Now >= StartTime) && (Now <= EndTime))
 425             SetIt = TRUE;
 426       } // if/else time range crosses midnight
 427
 428       if (SetIt) {
 429          MyFreePool(*Default);
 430          *Default = StrDuplicate(TokenList[1]);
 431       } // if (SetIt)
 432    } // if ((StartTime <= LAST_MINUTE) && (EndTime <= LAST_MINUTE))
 433 } // VOID SetDefaultByTime()
 434
 435 // read config file
 436 VOID ReadConfig(CHAR16 *FileName)
 437 {
 438     EFI_STATUS      Status;
 439     REFIT_FILE      File;
 440     CHAR16          **TokenList;
 441     CHAR16          *FlagName;
 442     CHAR16          *TempStr = NULL;
 443     UINTN           TokenCount, i;
 444     EFI_GUID        RefindGuid = REFIND_GUID_VALUE;
 445
 446     // Set a few defaults only if we're loading the default file.
 447     if (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0) {
 448        MyFreePool(GlobalConfig.AlsoScan);
 449        GlobalConfig.AlsoScan = StrDuplicate(ALSO_SCAN_DIRS);
 450        MyFreePool(GlobalConfig.DontScanDirs);
 451        if (SelfVolume) {
 452           if (SelfVolume->VolName) {
 453              TempStr = SelfVolume->VolName ? StrDuplicate(SelfVolume->VolName) : NULL;
 454           } else {
 455              TempStr = AllocateZeroPool(256 * sizeof(CHAR16));
 456              if (TempStr != NULL)
 457                 SPrint(TempStr, 255, L"fs%d", SelfVolume->VolNumber);
 458           } // if/else
 459        }
 460        MergeStrings(&TempStr, SelfDirPath, L':');
 461        MergeStrings(&TempStr, MEMTEST_LOCATIONS, L',');
 462        GlobalConfig.DontScanDirs = TempStr;
 463        MyFreePool(GlobalConfig.DontScanFiles);
 464        GlobalConfig.DontScanFiles = StrDuplicate(DONT_SCAN_FILES);
 465        MergeStrings(&(GlobalConfig.DontScanFiles), MOK_NAMES, L',');
 466        MyFreePool(GlobalConfig.DontScanVolumes);
 467        GlobalConfig.DontScanVolumes = StrDuplicate(DONT_SCAN_VOLUMES);
 468        GlobalConfig.WindowsRecoveryFiles = StrDuplicate(WINDOWS_RECOVERY_FILES);
 469        if (GlobalConfig.DefaultSelection != NULL) {
 470           MyFreePool(GlobalConfig.DefaultSelection);
 471           GlobalConfig.DefaultSelection = NULL;
 472        }
 473        Status = EfivarGetRaw(&RefindGuid, L"PreviousBoot", (CHAR8**) &(GlobalConfig.DefaultSelection), &i);
 474        if (Status != EFI_SUCCESS)
 475           GlobalConfig.DefaultSelection = NULL;
 476     } // if
 477
 478     if (!FileExists(SelfDir, FileName)) {
 479         Print(L"Configuration file '%s' missing!\n", FileName);
 480         return;
 481     }
 482
 483     Status = ReadFile(SelfDir, FileName, &File, &i);
 484     if (EFI_ERROR(Status))
 485         return;
 486
 487     for (;;) {
 488         TokenCount = ReadTokenLine(&File, &TokenList);
 489         if (TokenCount == 0)
 490             break;
 491
 492         if (StriCmp(TokenList[0], L"timeout") == 0) {
 493             HandleInt(TokenList, TokenCount, &(GlobalConfig.Timeout));
 494
 495         } else if (StriCmp(TokenList[0], L"hideui") == 0) {
 496             for (i = 1; i < TokenCount; i++) {
 497                 FlagName = TokenList[i];
 498                 if (StriCmp(FlagName, L"banner") == 0) {
 499                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_BANNER;
 500                 } else if (StriCmp(FlagName, L"label") == 0) {
 501                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_LABEL;
 502                 } else if (StriCmp(FlagName, L"singleuser") == 0) {
 503                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_SINGLEUSER;
 504                 } else if (StriCmp(FlagName, L"hwtest") == 0) {
 505                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_HWTEST;
 506                 } else if (StriCmp(FlagName, L"arrows") == 0) {
 507                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_ARROWS;
 508                 } else if (StriCmp(FlagName, L"hints") == 0) {
 509                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_HINTS;
 510                 } else if (StriCmp(FlagName, L"editor") == 0) {
 511                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_EDITOR;
 512                 } else if (StriCmp(FlagName, L"safemode") == 0) {
 513                    GlobalConfig.HideUIFlags |= HIDEUI_FLAG_SAFEMODE;
 514                 } else if (StriCmp(FlagName, L"all") == 0) {
 515                    GlobalConfig.HideUIFlags = HIDEUI_FLAG_ALL;
 516                 } else {
 517                     Print(L" unknown hideui flag: '%s'\n", FlagName);
 518                 }
 519             }
 520
 521         } else if (StriCmp(TokenList[0], L"icons_dir") == 0) {
 522            HandleString(TokenList, TokenCount, &(GlobalConfig.IconsDir));
 523
 524         } else if (StriCmp(TokenList[0], L"scanfor") == 0) {
 525            for (i = 0; i < NUM_SCAN_OPTIONS; i++) {
 526               if (i < TokenCount)
 527                  GlobalConfig.ScanFor[i] = TokenList[i][0];
 528               else
 529                  GlobalConfig.ScanFor[i] = ' ';
 530            }
 531
 532         } else if (StriCmp(TokenList[0], L"uefi_deep_legacy_scan") == 0) {
 533            GlobalConfig.DeepLegacyScan = HandleBoolean(TokenList, TokenCount);
 534
 535         } else if ((StriCmp(TokenList[0], L"scan_delay") == 0) && (TokenCount == 2)) {
 536            HandleInt(TokenList, TokenCount, &(GlobalConfig.ScanDelay));
 537
 538         } else if (StriCmp(TokenList[0], L"also_scan_dirs") == 0) {
 539             HandleStrings(TokenList, TokenCount, &(GlobalConfig.AlsoScan));
 540
 541         } else if ((StriCmp(TokenList[0], L"don't_scan_volumes") == 0) || (StriCmp(TokenList[0], L"dont_scan_volumes") == 0)) {
 542            // Note: Don't use HandleStrings() because it modifies slashes, which might be present in volume name
 543            MyFreePool(GlobalConfig.DontScanVolumes);
 544            GlobalConfig.DontScanVolumes = NULL;
 545            for (i = 1; i < TokenCount; i++) {
 546               MergeStrings(&GlobalConfig.DontScanVolumes, TokenList[i], L',');
 547            }
 548
 549         } else if ((StriCmp(TokenList[0], L"don't_scan_dirs") == 0) || (StriCmp(TokenList[0], L"dont_scan_dirs") == 0)) {
 550             HandleStrings(TokenList, TokenCount, &(GlobalConfig.DontScanDirs));
 551
 552         } else if ((StriCmp(TokenList[0], L"don't_scan_files") == 0) || (StriCmp(TokenList[0], L"dont_scan_files") == 0)) {
 553            HandleStrings(TokenList, TokenCount, &(GlobalConfig.DontScanFiles));
 554
 555         } else if (StriCmp(TokenList[0], L"windows_recovery_files") == 0) {
 556            HandleStrings(TokenList, TokenCount, &(GlobalConfig.WindowsRecoveryFiles));
 557
 558         } else if (StriCmp(TokenList[0], L"scan_driver_dirs") == 0) {
 559             HandleStrings(TokenList, TokenCount, &(GlobalConfig.DriverDirs));
 560
 561         } else if (StriCmp(TokenList[0], L"showtools") == 0) {
 562             SetMem(GlobalConfig.ShowTools, NUM_TOOLS * sizeof(UINTN), 0);
 563             for (i = 1; (i < TokenCount) && (i < NUM_TOOLS); i++) {
 564                 FlagName = TokenList[i];
 565                 if (StriCmp(FlagName, L"shell") == 0) {
 566                     GlobalConfig.ShowTools[i - 1] = TAG_SHELL;
 567                 } else if (StriCmp(FlagName, L"gptsync") == 0) {
 568                     GlobalConfig.ShowTools[i - 1] = TAG_GPTSYNC;
 569                 } else if (StriCmp(FlagName, L"gdisk") == 0) {
 570                    GlobalConfig.ShowTools[i - 1] = TAG_GDISK;
 571                 } else if (StriCmp(FlagName, L"about") == 0) {
 572                    GlobalConfig.ShowTools[i - 1] = TAG_ABOUT;
 573                 } else if (StriCmp(FlagName, L"exit") == 0) {
 574                    GlobalConfig.ShowTools[i - 1] = TAG_EXIT;
 575                 } else if (StriCmp(FlagName, L"reboot") == 0) {
 576                    GlobalConfig.ShowTools[i - 1] = TAG_REBOOT;
 577                 } else if (StriCmp(FlagName, L"shutdown") == 0) {
 578                    GlobalConfig.ShowTools[i - 1] = TAG_SHUTDOWN;
 579                 } else if (StriCmp(FlagName, L"apple_recovery") == 0) {
 580                    GlobalConfig.ShowTools[i - 1] = TAG_APPLE_RECOVERY;
 581                 } else if (StriCmp(FlagName, L"windows_recovery") == 0) {
 582                    GlobalConfig.ShowTools[i - 1] = TAG_WINDOWS_RECOVERY;
 583                 } else if (StriCmp(FlagName, L"mok_tool") == 0) {
 584                    GlobalConfig.ShowTools[i - 1] = TAG_MOK_TOOL;
 585                 } else if (StriCmp(FlagName, L"firmware") == 0) {
 586                    GlobalConfig.ShowTools[i - 1] = TAG_FIRMWARE;
 587                 } else if ((StriCmp(FlagName, L"memtest86") == 0) || (StriCmp(FlagName, L"memtest") == 0)) {
 588                    GlobalConfig.ShowTools[i - 1] = TAG_MEMTEST;
 589                 } else {
 590                    Print(L" unknown showtools flag: '%s'\n", FlagName);
 591                 }
 592             } // showtools options
 593
 594         } else if (StriCmp(TokenList[0], L"banner") == 0) {
 595            HandleString(TokenList, TokenCount, &(GlobalConfig.BannerFileName));
 596
 597         } else if ((StriCmp(TokenList[0], L"banner_scale") == 0) && (TokenCount == 2)) {
 598            if (StriCmp(TokenList[1], L"noscale") == 0) {
 599               GlobalConfig.BannerScale = BANNER_NOSCALE;
 600            } else if ((StriCmp(TokenList[1], L"fillscreen") == 0) || (StriCmp(TokenList[1], L"fullscreen") == 0)) {
 601               GlobalConfig.BannerScale = BANNER_FILLSCREEN;
 602            } else {
 603               Print(L" unknown banner_type flag: '%s'\n", TokenList[1]);
 604            } // if/else
 605
 606         } else if ((StriCmp(TokenList[0], L"small_icon_size") == 0) && (TokenCount == 2)) {
 607            HandleInt(TokenList, TokenCount, &i);
 608            if (i >= 32)
 609               GlobalConfig.IconSizes[ICON_SIZE_SMALL] = i;
 610
 611         } else if ((StriCmp(TokenList[0], L"big_icon_size") == 0) && (TokenCount == 2)) {
 612            HandleInt(TokenList, TokenCount, &i);
 613            if (i >= 32) {
 614               GlobalConfig.IconSizes[ICON_SIZE_BIG] = i;
 615               GlobalConfig.IconSizes[ICON_SIZE_BADGE] = i / 4;
 616            }
 617
 618         } else if (StriCmp(TokenList[0], L"selection_small") == 0) {
 619            HandleString(TokenList, TokenCount, &(GlobalConfig.SelectionSmallFileName));
 620
 621         } else if (StriCmp(TokenList[0], L"selection_big") == 0) {
 622            HandleString(TokenList, TokenCount, &(GlobalConfig.SelectionBigFileName));
 623
 624         } else if (StriCmp(TokenList[0], L"default_selection") == 0) {
 625            if (TokenCount == 4) {
 626               SetDefaultByTime(TokenList, &(GlobalConfig.DefaultSelection));
 627            } else {
 628               HandleString(TokenList, TokenCount, &(GlobalConfig.DefaultSelection));
 629            }
 630
 631         } else if (StriCmp(TokenList[0], L"textonly") == 0) {
 632            GlobalConfig.TextOnly = HandleBoolean(TokenList, TokenCount);
 633
 634         } else if (StriCmp(TokenList[0], L"textmode") == 0) {
 635            HandleInt(TokenList, TokenCount, &(GlobalConfig.RequestedTextMode));
 636
 637         } else if ((StriCmp(TokenList[0], L"resolution") == 0) && ((TokenCount == 2) || (TokenCount == 3))) {
 638            GlobalConfig.RequestedScreenWidth = Atoi(TokenList[1]);
 639            if (TokenCount == 3)
 640               GlobalConfig.RequestedScreenHeight = Atoi(TokenList[2]);
 641            else
 642               GlobalConfig.RequestedScreenHeight = 0;
 643
 644         } else if (StriCmp(TokenList[0], L"screensaver") == 0) {
 645            HandleInt(TokenList, TokenCount, &(GlobalConfig.ScreensaverTime));
 646
 647         } else if (StriCmp(TokenList[0], L"use_graphics_for") == 0) {
 648            if ((TokenCount == 2) || ((TokenCount > 2) && (StriCmp(TokenList[1], L"+") != 0)))
 649               GlobalConfig.GraphicsFor = 0;
 650            for (i = 1; i < TokenCount; i++) {
 651               if (StriCmp(TokenList[i], L"osx") == 0) {
 652                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_OSX;
 653               } else if (StriCmp(TokenList[i], L"linux") == 0) {
 654                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_LINUX;
 655               } else if (StriCmp(TokenList[i], L"elilo") == 0) {
 656                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_ELILO;
 657               } else if (StriCmp(TokenList[i], L"grub") == 0) {
 658                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_GRUB;
 659               } else if (StriCmp(TokenList[i], L"windows") == 0) {
 660                  GlobalConfig.GraphicsFor |= GRAPHICS_FOR_WINDOWS;
 661               }
 662            } // for (graphics_on tokens)
 663
 664         } else if ((StriCmp(TokenList[0], L"font") == 0) && (TokenCount == 2)) {
 665            egLoadFont(TokenList[1]);
 666
 667         } else if (StriCmp(TokenList[0], L"scan_all_linux_kernels") == 0) {
 668            GlobalConfig.ScanAllLinux = HandleBoolean(TokenList, TokenCount);
 669 //            if ((TokenCount >= 2) && (StriCmp(TokenList[1], L"0") == 0)) {
 670 //               GlobalConfig.ScanAllLinux = FALSE;
 671 //            } else {
 672 //               GlobalConfig.ScanAllLinux = TRUE;
 673 //            }
 674
 675         } else if (StriCmp(TokenList[0], L"max_tags") == 0) {
 676            HandleInt(TokenList, TokenCount, &(GlobalConfig.MaxTags));
 677
 678         } else if ((StriCmp(TokenList[0], L"include") == 0) && (TokenCount == 2) &&
 679                    (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0)) {
 680            if (StriCmp(TokenList[1], FileName) != 0) {
 681               ReadConfig(TokenList[1]);
 682            }
 683
 684         }
 685
 686         FreeTokenLine(&TokenList, &TokenCount);
 687     }
 688     if ((GlobalConfig.DontScanFiles) && (GlobalConfig.WindowsRecoveryFiles))
 689        MergeStrings(&(GlobalConfig.DontScanFiles), GlobalConfig.WindowsRecoveryFiles, L',');
 690     MyFreePool(File.Buffer);
 691 } /* VOID ReadConfig() */
 692
 693 // Finds a volume with the specified Identifier (a filesystem label, a
 694 // partition name, a partition GUID, or a number followed by a colon). If
 695 // found, sets *Volume to point to that volume. If not, leaves it unchanged.
 696 // Returns TRUE if a match was found, FALSE if not.
 697 static BOOLEAN FindVolume(REFIT_VOLUME **Volume, CHAR16 *Identifier) {
 698    UINTN     i = 0, CountedVolumes = 0, Length;
 699    INTN      Number = -1;
 700    BOOLEAN   Found = FALSE, IdIsGuid = FALSE;
 701    EFI_GUID  VolGuid, NullGuid = NULL_GUID_VALUE;
 702
 703    VolGuid = StringAsGuid(Identifier);
 704    Length = StrLen(Identifier);
 705    if ((Length >= 2) && (Identifier[Length - 1] == L':') &&
 706        (Identifier[0] >= L'0') && (Identifier[0] <= L'9')) {
 707       Number = (INTN) Atoi(Identifier);
 708    } else if (IsGuid(Identifier)) {
 709       IdIsGuid = TRUE;
 710    }
 711    while ((i < VolumesCount) && (!Found)) {
 712       if (Number >= 0) { // User specified a volume by number
 713          if (Volumes[i]->IsReadable) {
 714             if (CountedVolumes == Number) {
 715                *Volume = Volumes[i];
 716                Found = TRUE;
 717             }
 718             CountedVolumes++;
 719          } // if
 720       } else { // User specified a volume by label or GUID
 721          if ((StriCmp(Identifier, Volumes[i]->VolName) == 0) ||
 722              (StriCmp(Identifier, Volumes[i]->PartName) == 0)) {
 723             *Volume = Volumes[i];
 724             Found = TRUE;
 725          } // if
 726          if (IdIsGuid && !Found) {
 727             if (GuidsAreEqual(&VolGuid, &(Volumes[i]->PartGuid)) && !GuidsAreEqual(&NullGuid, &(Volumes[i]->PartGuid))) {
 728                *Volume = Volumes[i];
 729                Found = TRUE;
 730             } // if
 731          } // if
 732       } // if/else
 733       i++;
 734    } // while()
 735    return (Found);
 736 } // static VOID FindVolume()
 737
 738 static VOID AddSubmenu(LOADER_ENTRY *Entry, REFIT_FILE *File, REFIT_VOLUME *Volume, CHAR16 *Title) {
 739    REFIT_MENU_SCREEN  *SubScreen;
 740    LOADER_ENTRY       *SubEntry;
 741    UINTN              TokenCount;
 742    CHAR16             **TokenList;
 743
 744    SubScreen = InitializeSubScreen(Entry);
 745
 746    // Set defaults for the new entry; will be modified based on lines read from the config. file....
 747    SubEntry = InitializeLoaderEntry(Entry);
 748
 749    if ((SubEntry == NULL) || (SubScreen == NULL))
 750       return;
 751    SubEntry->me.Title        = StrDuplicate(Title);
 752
 753    while (((TokenCount = ReadTokenLine(File, &TokenList)) > 0) && (StriCmp(TokenList[0], L"}") != 0)) {
 754
 755       if ((StriCmp(TokenList[0], L"loader") == 0) && (TokenCount > 1)) { // set the boot loader filename
 756          MyFreePool(SubEntry->LoaderPath);
 757          SubEntry->LoaderPath = StrDuplicate(TokenList[1]);
 758          SubEntry->DevicePath = FileDevicePath(Volume->DeviceHandle, SubEntry->LoaderPath);
 759
 760       } else if ((StriCmp(TokenList[0], L"volume") == 0) && (TokenCount > 1)) {
 761          if (FindVolume(&Volume, TokenList[1])) {
 762             MyFreePool(SubEntry->me.Title);
 763             SubEntry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 764             SPrint(SubEntry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", Volume->VolName);
 765             SubEntry->me.BadgeImage   = Volume->VolBadgeImage;
 766             SubEntry->VolName         = Volume->VolName;
 767          } // if match found
 768
 769       } else if (StriCmp(TokenList[0], L"initrd") == 0) {
 770          MyFreePool(SubEntry->InitrdPath);
 771          SubEntry->InitrdPath = NULL;
 772          if (TokenCount > 1) {
 773             SubEntry->InitrdPath = StrDuplicate(TokenList[1]);
 774          }
 775
 776       } else if (StriCmp(TokenList[0], L"options") == 0) {
 777          MyFreePool(SubEntry->LoadOptions);
 778          SubEntry->LoadOptions = NULL;
 779          if (TokenCount > 1) {
 780             SubEntry->LoadOptions = StrDuplicate(TokenList[1]);
 781          } // if/else
 782
 783       } else if ((StriCmp(TokenList[0], L"add_options") == 0) && (TokenCount > 1)) {
 784          MergeStrings(&SubEntry->LoadOptions, TokenList[1], L' ');
 785
 786       } else if ((StriCmp(TokenList[0], L"graphics") == 0) && (TokenCount > 1)) {
 787          SubEntry->UseGraphicsMode = (StriCmp(TokenList[1], L"on") == 0);
 788
 789       } else if (StriCmp(TokenList[0], L"disabled") == 0) {
 790          SubEntry->Enabled = FALSE;
 791       } // ief/elseif
 792
 793       FreeTokenLine(&TokenList, &TokenCount);
 794    } // while()
 795
 796    if (SubEntry->InitrdPath != NULL) {
 797       MergeStrings(&SubEntry->LoadOptions, L"initrd=", L' ');
 798       MergeStrings(&SubEntry->LoadOptions, SubEntry->InitrdPath, 0);
 799       MyFreePool(SubEntry->InitrdPath);
 800       SubEntry->InitrdPath = NULL;
 801    } // if
 802    if (SubEntry->Enabled == TRUE) {
 803       AddMenuEntry(SubScreen, (REFIT_MENU_ENTRY *)SubEntry);
 804    }
 805    Entry->me.SubScreen = SubScreen;
 806 } // VOID AddSubmenu()
 807
 808 // Adds the options from a SINGLE refind.conf stanza to a new loader entry and returns
 809 // that entry. The calling function is then responsible for adding the entry to the
 810 // list of entries.
 811 static LOADER_ENTRY * AddStanzaEntries(REFIT_FILE *File, REFIT_VOLUME *Volume, CHAR16 *Title) {
 812    CHAR16       **TokenList;
 813    UINTN        TokenCount;
 814    LOADER_ENTRY *Entry;
 815    BOOLEAN      DefaultsSet = FALSE, AddedSubmenu = FALSE;
 816    REFIT_VOLUME *CurrentVolume = Volume;
 817
 818    // prepare the menu entry
 819    Entry = InitializeLoaderEntry(NULL);
 820    if (Entry == NULL)
 821       return NULL;
 822
 823    Entry->Title           = StrDuplicate(Title);
 824    Entry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 825    SPrint(Entry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", CurrentVolume->VolName);
 826    Entry->me.Row          = 0;
 827    Entry->me.BadgeImage   = CurrentVolume->VolBadgeImage;
 828    Entry->VolName         = CurrentVolume->VolName;
 829
 830    // Parse the config file to add options for a single stanza, terminating when the token
 831    // is "}" or when the end of file is reached.
 832    while (((TokenCount = ReadTokenLine(File, &TokenList)) > 0) && (StriCmp(TokenList[0], L"}") != 0)) {
 833       if ((StriCmp(TokenList[0], L"loader") == 0) && (TokenCount > 1)) { // set the boot loader filename
 834          Entry->LoaderPath = StrDuplicate(TokenList[1]);
 835          Entry->DevicePath = FileDevicePath(CurrentVolume->DeviceHandle, Entry->LoaderPath);
 836          SetLoaderDefaults(Entry, TokenList[1], CurrentVolume);
 837          MyFreePool(Entry->LoadOptions);
 838          Entry->LoadOptions = NULL; // Discard default options, if any
 839          DefaultsSet = TRUE;
 840
 841       } else if ((StriCmp(TokenList[0], L"volume") == 0) && (TokenCount > 1)) {
 842          if (FindVolume(&CurrentVolume, TokenList[1])) {
 843             MyFreePool(Entry->me.Title);
 844             Entry->me.Title        = AllocateZeroPool(256 * sizeof(CHAR16));
 845             SPrint(Entry->me.Title, 255, L"Boot %s from %s", (Title != NULL) ? Title : L"Unknown", CurrentVolume->VolName);
 846             Entry->me.BadgeImage   = CurrentVolume->VolBadgeImage;
 847             Entry->VolName         = CurrentVolume->VolName;
 848          } // if match found
 849
 850       } else if ((StriCmp(TokenList[0], L"icon") == 0) && (TokenCount > 1)) {
 851          MyFreePool(Entry->me.Image);
 852          Entry->me.Image = egLoadIcon(CurrentVolume->RootDir, TokenList[1], GlobalConfig.IconSizes[ICON_SIZE_BIG]);
 853          if (Entry->me.Image == NULL) {
 854             Entry->me.Image = DummyImage(GlobalConfig.IconSizes[ICON_SIZE_BIG]);
 855          }
 856
 857       } else if ((StriCmp(TokenList[0], L"initrd") == 0) && (TokenCount > 1)) {
 858          MyFreePool(Entry->InitrdPath);
 859          Entry->InitrdPath = StrDuplicate(TokenList[1]);
 860
 861       } else if ((StriCmp(TokenList[0], L"options") == 0) && (TokenCount > 1)) {
 862          MyFreePool(Entry->LoadOptions);
 863          Entry->LoadOptions = StrDuplicate(TokenList[1]);
 864
 865       } else if ((StriCmp(TokenList[0], L"ostype") == 0) && (TokenCount > 1)) {
 866          if (TokenCount > 1) {
 867             Entry->OSType = TokenList[1][0];
 868          }
 869
 870       } else if ((StriCmp(TokenList[0], L"graphics") == 0) && (TokenCount > 1)) {
 871          Entry->UseGraphicsMode = (StriCmp(TokenList[1], L"on") == 0);
 872
 873       } else if (StriCmp(TokenList[0], L"disabled") == 0) {
 874          Entry->Enabled = FALSE;
 875
 876       } else if ((StriCmp(TokenList[0], L"submenuentry") == 0) && (TokenCount > 1)) {
 877          AddSubmenu(Entry, File, CurrentVolume, TokenList[1]);
 878          AddedSubmenu = TRUE;
 879
 880       } // set options to pass to the loader program
 881       FreeTokenLine(&TokenList, &TokenCount);
 882    } // while()
 883
 884    if (AddedSubmenu)
 885        AddMenuEntry(Entry->me.SubScreen, &MenuEntryReturn);
 886
 887    if (Entry->InitrdPath) {
 888       MergeStrings(&Entry->LoadOptions, L"initrd=", L' ');
 889       MergeStrings(&Entry->LoadOptions, Entry->InitrdPath, 0);
 890       MyFreePool(Entry->InitrdPath);
 891       Entry->InitrdPath = NULL;
 892    } // if
 893
 894    if (!DefaultsSet)
 895       SetLoaderDefaults(Entry, L"\\EFI\\BOOT\\nemo.efi", CurrentVolume); // user included no "loader" line; use bogus one
 896
 897    return(Entry);
 898 } // static VOID AddStanzaEntries()
 899
 900 // Read the user-configured menu entries from refind.conf and add or delete
 901 // entries based on the contents of that file....
 902 VOID ScanUserConfigured(CHAR16 *FileName)
 903 {
 904    EFI_STATUS        Status;
 905    REFIT_FILE        File;
 906    REFIT_VOLUME      *Volume;
 907    CHAR16            **TokenList;
 908    CHAR16            *Title = NULL;
 909    UINTN             TokenCount, size;
 910    LOADER_ENTRY      *Entry;
 911
 912    if (FileExists(SelfDir, FileName)) {
 913       Status = ReadFile(SelfDir, FileName, &File, &size);
 914       if (EFI_ERROR(Status))
 915          return;
 916
 917       Volume = SelfVolume;
 918
 919       while ((TokenCount = ReadTokenLine(&File, &TokenList)) > 0) {
 920          if ((StriCmp(TokenList[0], L"menuentry") == 0) && (TokenCount > 1)) {
 921             Title = StrDuplicate(TokenList[1]);
 922             Entry = AddStanzaEntries(&File, Volume, TokenList[1]);
 923             if (Entry->Enabled) {
 924                if (Entry->me.SubScreen == NULL)
 925                   GenerateSubScreen(Entry, Volume);
 926                AddPreparedLoaderEntry(Entry);
 927             } else {
 928                MyFreePool(Entry);
 929             } // if/else
 930             MyFreePool(Title);
 931
 932          } else if ((StriCmp(TokenList[0], L"include") == 0) && (TokenCount == 2) &&
 933                     (StriCmp(FileName, GlobalConfig.ConfigFilename) == 0)) {
 934             if (StriCmp(TokenList[1], FileName) != 0) {
 935                ScanUserConfigured(TokenList[1]);
 936             }
 937
 938          } // if/else if...
 939          FreeTokenLine(&TokenList, &TokenCount);
 940       } // while()
 941    } // if()
 942 } // VOID ScanUserConfigured()
 943
 944 // Create an options file based on /etc/fstab. The resulting file has two options
 945 // lines, one of which boots the system with "ro root={rootfs}" and the other of
 946 // which boots the system with "ro root={rootfs} single", where "{rootfs}" is the
 947 // filesystem identifier associated with the "/" line in /etc/fstab.
 948 static REFIT_FILE * GenerateOptionsFromEtcFstab(REFIT_VOLUME *Volume) {
 949    UINTN        TokenCount, i;
 950    REFIT_FILE   *Options = NULL, *Fstab = NULL;
 951    EFI_STATUS   Status;
 952    CHAR16       **TokenList, *Line, Root[100];
 953
 954    if (FileExists(Volume->RootDir, L"\\etc\\fstab")) {
 955       Options = AllocateZeroPool(sizeof(REFIT_FILE));
 956       Fstab = AllocateZeroPool(sizeof(REFIT_FILE));
 957       Status = ReadFile(Volume->RootDir, L"\\etc\\fstab", Fstab, &i);
 958       if (CheckError(Status, L"while reading /etc/fstab")) {
 959          if (Options != NULL)
 960             FreePool(Options);
 961          if (Fstab != NULL)
 962             FreePool(Fstab);
 963          Options = NULL;
 964          Fstab = NULL;
 965       } else { // File read; locate root fs and create entries
 966          Options->Encoding = ENCODING_UTF16_LE;
 967          while ((TokenCount = ReadTokenLine(Fstab, &TokenList)) > 0) {
 968             if (TokenCount > 2) {
 969                Root[0] = '\0';
 970                if (StriCmp(TokenList[1], L"\\") == 0) {
 971                   SPrint(Root, 99, L"%s", TokenList[0]);
 972                } else if (StriCmp(TokenList[2], L"\\") == 0) {
 973                   SPrint(Root, 99, L"%s=%s", TokenList[0], TokenList[1]);
 974                } // if/elseif/elseif
 975                if (Root[0] != L'\0') {
 976                   for (i = 0; i < StrLen(Root); i++)
 977                      if (Root[i] == '\\')
 978                         Root[i] = '/';
 979                   Line = PoolPrint(L"\"Boot with normal options\"    \"ro root=%s\"\n", Root);
 980                   MergeStrings((CHAR16 **) &(Options->Buffer), Line, 0);
 981                   MyFreePool(Line);
 982                   Line = PoolPrint(L"\"Boot into single-user mode\"  \"ro root=%s single\"\n", Root);
 983                   MergeStrings((CHAR16**) &(Options->Buffer), Line, 0);
 984                   Options->BufferSize = StrLen((CHAR16*) Options->Buffer) * sizeof(CHAR16);
 985                } // if
 986             } // if
 987             FreeTokenLine(&TokenList, &TokenCount);
 988          } // while
 989
 990          Options->Current8Ptr  = (CHAR8 *)Options->Buffer;
 991          Options->End8Ptr      = Options->Current8Ptr + Options->BufferSize;
 992          Options->Current16Ptr = (CHAR16 *)Options->Buffer;
 993          Options->End16Ptr     = Options->Current16Ptr + (Options->BufferSize >> 1);
 994
 995          MyFreePool(Fstab->Buffer);
 996          MyFreePool(Fstab);
 997       } // if/else file read error
 998    } // if /etc/fstab exists
 999    return Options;
1000 } // GenerateOptionsFromEtcFstab()
1001
1002
1003 // Read a Linux kernel options file for a Linux boot loader into memory. The LoaderPath
1004 // and Volume variables identify the location of the options file, but not its name --
1005 // you pass this function the filename of the Linux kernel, initial RAM disk, or other
1006 // file in the target directory, and this function finds the file with a name in the
1007 // comma-delimited list of names specified by LINUX_OPTIONS_FILENAMES within that
1008 // directory and loads it. This function tries multiple files because I originally
1009 // used the filename linux.conf, but close on the heels of that decision, the Linux
1010 // kernel developers decided to use that name for a similar purpose, but with a
1011 // different file format. Thus, I'm migrating rEFInd to use the name refind_linux.conf,
1012 // but I want a migration period in which both names are used.
1013 // If a rEFInd options file can't be found, try to generate minimal options from
1014 // /etc/fstab on the same volume as the kernel. This typically works only if the
1015 // kernel is being read from the Linux root filesystem.
1016 //
1017 // The return value is a pointer to the REFIT_FILE handle for the file, or NULL if
1018 // it wasn't found.
1019 REFIT_FILE * ReadLinuxOptionsFile(IN CHAR16 *LoaderPath, IN REFIT_VOLUME *Volume) {
1020    CHAR16       *OptionsFilename, *FullFilename;
1021    BOOLEAN      GoOn = TRUE, FileFound = FALSE;
1022    UINTN        i = 0, size;
1023    REFIT_FILE   *File = NULL;
1024    EFI_STATUS   Status;
1025
1026    do {
1027       OptionsFilename = FindCommaDelimited(LINUX_OPTIONS_FILENAMES, i++);
1028       FullFilename = FindPath(LoaderPath);
1029       if ((OptionsFilename != NULL) && (FullFilename != NULL)) {
1030          MergeStrings(&FullFilename, OptionsFilename, '\\');
1031          if (FileExists(Volume->RootDir, FullFilename)) {
1032             File = AllocateZeroPool(sizeof(REFIT_FILE));
1033             Status = ReadFile(Volume->RootDir, FullFilename, File, &size);
1034             if (CheckError(Status, L"while loading the Linux options file")) {
1035                if (File != NULL)
1036                   FreePool(File);
1037                File = NULL;
1038             } else {
1039                GoOn = FALSE;
1040                FileFound = TRUE;
1041             } // if/else error
1042          } // if file exists
1043       } else { // a filename string is NULL
1044          GoOn = FALSE;
1045       } // if/else
1046       if (!FileFound)
1047          File = GenerateOptionsFromEtcFstab(Volume);
1048       MyFreePool(OptionsFilename);
1049       MyFreePool(FullFilename);
1050       OptionsFilename = FullFilename = NULL;
1051    } while (GoOn);
1052    return (File);
1053 } // static REFIT_FILE * ReadLinuxOptionsFile()
1054
1055 // Retrieve a single line of options from a Linux kernel options file
1056 CHAR16 * GetFirstOptionsFromFile(IN CHAR16 *LoaderPath, IN REFIT_VOLUME *Volume) {
1057    UINTN        TokenCount;
1058    CHAR16       *Options = NULL;
1059    CHAR16       **TokenList;
1060    REFIT_FILE   *File;
1061
1062    File = ReadLinuxOptionsFile(LoaderPath, Volume);
1063    if (File != NULL) {
1064       TokenCount = ReadTokenLine(File, &TokenList);
1065       if (TokenCount > 1)
1066          Options = StrDuplicate(TokenList[1]);
1067       FreeTokenLine(&TokenList, &TokenCount);
1068       FreePool(File);
1069    } // if
1070    return Options;
1071 } // static CHAR16 * GetOptionsFile()
1072