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

From Syslinux Wiki
Jump to: navigation, search
m (Delete "Level 2" headings and TOC.)
m (Apply Template "V".)
 
(2 intermediate revisions by the same user not shown)
Line 31: Line 31:
 
(containing <tt>ldlinux.sys</tt> or <tt>extlinux.sys</tt>).
 
(containing <tt>ldlinux.sys</tt> or <tt>extlinux.sys</tt>).
  
<tt>[3.35+]</tt> SYSLINUX also searches for the config file in  
+
{{v|3.35+}}SYSLINUX also searches for the config file in  
 
"<tt>/boot/syslinux/</tt>",  
 
"<tt>/boot/syslinux/</tt>",  
 
"<tt>/syslinux/</tt>" and  
 
"<tt>/syslinux/</tt>" and  
 
"<tt>/</tt>", in this order.
 
"<tt>/</tt>", in this order.
  
<tt>[-3.xx]</tt> SYSLINUX uses  
+
The first configuration file that is found
 +
stops the search and
 +
the configuration file is parsed&nbsp;/&nbsp;used.
 +
 
 +
{{v|-3.xx}}SYSLINUX uses  
 
<tt>syslinux.cfg</tt> as config file name.  
 
<tt>syslinux.cfg</tt> as config file name.  
 
EXTLINUX (merged into SYSLINUX as of 4.00) used  
 
EXTLINUX (merged into SYSLINUX as of 4.00) used  
 
<tt>extlinux.conf</tt>.
 
<tt>extlinux.conf</tt>.
  
<tt>[4.00+]</tt> SYSLINUX searches first for  
+
{{v|4.00+}}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  
+
{{v|-4.02}}ISOLINUX uses  
 
<tt>isolinux.cfg</tt> as config file name,  
 
<tt>isolinux.cfg</tt> as config file name,  
 
searching first in  
 
searching first in  
"<tt>/boot/isolinux/</tt>" <tt>[2.00+]</tt>, then in  
+
"<tt>/boot/isolinux/</tt>" {{v|2.00+}}, then in  
 
"<tt>/isolinux/</tt>"  
 
"<tt>/isolinux/</tt>"  
 
and then in "<tt>/</tt>".
 
and then in "<tt>/</tt>".
  
<tt>[4.03+]</tt> ISOLINUX searches for  
+
{{v|4.03+}}ISOLINUX searches for  
 
<tt>isolinux.cfg</tt> and then for  
 
<tt>isolinux.cfg</tt> and then for  
 
<tt>syslinux.cfg</tt> in  
 
<tt>syslinux.cfg</tt> in  
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.
 +
 +
{{v|6.04+}}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.

Latest revision as of 11:53, 16 March 2017

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.