Difference between revisions of "Template:Configuration location and name"

From Syslinux Wiki
Jump to: navigation, search
m (Ady moved page Configuration location and name to Template:Configuration location and name: Moving from Main to Template. The resulting Template page is easier to transclude into other pages.)
(Minor rewording. Add platform-specific configuration files for UEFI, since version 6.04.)
Line 35: Line 35:
 
"<tt>/syslinux/</tt>" and  
 
"<tt>/syslinux/</tt>" and  
 
"<tt>/</tt>", in this order.
 
"<tt>/</tt>", in this order.
 +
 +
The first configuration file that is found
 +
stops the search and
 +
the configuration file is parsed&nbsp;/&nbsp;used.
  
 
<tt>[-3.xx]</tt> SYSLINUX uses  
 
<tt>[-3.xx]</tt> SYSLINUX uses  
Line 41: Line 45:
 
<tt>extlinux.conf</tt>.
 
<tt>extlinux.conf</tt>.
  
<tt>[4.00+]</tt> SYSLINUX searches first for  
+
<tt>[4.00+]</tt> In each {{nowrap|searched-for}} directory,
 +
SYSLINUX searches first for  
 
<tt>extlinux.conf</tt> and then for  
 
<tt>extlinux.conf</tt> and then for  
<tt>syslinux.cfg</tt> in each {{nowrap|searched-for}} directory,
+
<tt>syslinux.cfg</tt> before falling back to the next directory.
before falling back to the next directory.
+
  
 
<tt>[-4.02]</tt> ISOLINUX uses  
 
<tt>[-4.02]</tt> ISOLINUX uses  
Line 87: Line 91:
 
SYSLINUX  
 
SYSLINUX  
 
defaults to searching for  
 
defaults to searching for  
<tt>syslinux.cfg</tt> in the installed directory, where  
+
the configuration file in the installed directory, where  
 
<tt>syslinux.efi</tt>  
 
<tt>syslinux.efi</tt>  
 
is located and containing also its corresponding  
 
is located and containing also its corresponding  
 
{{nowrap|"&nbsp;''<code>ldlinux.*</code>''&nbsp;"}}  
 
{{nowrap|"&nbsp;''<code>ldlinux.*</code>''&nbsp;"}}  
 
file.
 
file.
 +
 +
<tt>[6.04+]</tt> In each {{nowrap|searched-for}} directory,
 +
SYSLINUX searches first for
 +
<!--  -->
 +
<!-- Note: extlinux.conf is searched-for also in UEFI mode -->
 +
<!--  but documenting such possibility might add unnecesary -->
 +
<!--  complications or misunderstandings for users: -->
 +
<!--  SYSLINUX searches first for -->
 +
<!--  <tt>extlinux.conf</tt>, then searches for... -->
 +
<!--  -->
 +
either:
 +
* <tt>syslia32.cfg</tt> when booting in EFI_ia32 mode
 +
* <tt>syslx64.cfg</tt> when booting in EFI_x64 mode
 +
and finally
 +
SYSLINUX searches for <tt>syslinux.cfg</tt>
 +
before falling back to the next directory.
 +
 +
The first configuration file that is found
 +
stops the search and
 +
the configuration file is parsed&nbsp;/&nbsp;used.
  
 
Note that <tt>syslinux.efi</tt> could be optionally renamed.
 
Note that <tt>syslinux.efi</tt> could be optionally renamed.

Revision as of 11:53, 2 July 2016

Note: In the following paragraphs, the "/" directory represents the root of the filesystem in which Syslinux (in its several variants) is (going to be) installed.


BIOS

SYSLINUX / EXTLINUX default to searching for the config file in the installed directory (containing ldlinux.sys or extlinux.sys).

[3.35+] SYSLINUX also searches for the config file in "/boot/syslinux/", "/syslinux/" and "/", in this order.

The first configuration file that is found stops the search and the configuration file is parsed / used.

[-3.xx] SYSLINUX uses syslinux.cfg as config file name. EXTLINUX (merged into SYSLINUX as of 4.00) used extlinux.conf.

[4.00+] In each searched-for directory, SYSLINUX searches first for extlinux.conf and then for syslinux.cfg before falling back to the next directory.

[-4.02] ISOLINUX uses isolinux.cfg as config file name, searching first in "/boot/isolinux/" [2.00+], then in "/isolinux/" and then in "/".

[4.03+] ISOLINUX searches for isolinux.cfg and then for syslinux.cfg in "/boot/isolinux/" before searching for the same files in "/isolinux/", "/boot/syslinux/", "/syslinux/", and "/", in this order.


Since version 4.03, the resulting behavior is that the same "/[[boot/]syslinux/]syslinux.cfg" file can optionally be used for SYSLINUX / EXTLINUX / ISOLINUX, while specific isolinux.cfg and/or extlinux.conf files would take precedence if present.

Since version 4.03, the resulting behavior is that any of the respective config files (or even all of them) — namely isolinux.cfg, and/or extlinux.conf, and/or syslinux.cfg — can optionally be located together in the same "/[[boot/]syslinux/]" directory.


UEFI

SYSLINUX defaults to searching for the configuration file in the installed directory, where syslinux.efi is located and containing also its corresponding ldlinux.* " file.

[6.04+] In each searched-for directory, SYSLINUX searches first for either:

  • syslia32.cfg when booting in EFI_ia32 mode
  • syslx64.cfg when booting in EFI_x64 mode

and finally SYSLINUX searches for syslinux.cfg before falling back to the next directory.

The first configuration file that is found stops the search and the configuration file is parsed / used.

Note that syslinux.efi could be optionally renamed.