0% found this document useful (0 votes)
27 views2 pages

Syslinux Boot Prompt Commands Guide

The document is a manpage for syslinux-cli, detailing its command line interface for loading modules and booting kernels. It includes information on command line keystrokes, working directory behavior, alternate filename handling, and path rules. The document is authored by H. Peter Anvin and edited by Gene Cumm, and it provides essential operational details for users of Syslinux.

Uploaded by

konsumirre
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
27 views2 pages

Syslinux Boot Prompt Commands Guide

The document is a manpage for syslinux-cli, detailing its command line interface for loading modules and booting kernels. It includes information on command line keystrokes, working directory behavior, alternate filename handling, and path rules. The document is authored by H. Peter Anvin and edited by Gene Cumm, and it provides essential operational details for users of Syslinux.

Uploaded by

konsumirre
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd

= syslinux-cli(1) =

:doctype: manpage
:revdate: 2012-11-10
:author: H. Peter Anvin
:author-email: hpa@[Link]
:editor1: Gene Cumm
:editor1-email: [Link]@[Link]
:editor1-revlast: 2012-11-10
:data-uri:

== NAME ==
syslinux-cli - *Syslinux* boot prompt/command line interface

== DESCRIPTION ==
*Syslinux*'s boot prompt provides a very simplistic command line
interface for loading modules and booting kernels.

== BOOT PROMPT ==
=== COMMAND LINE KEYSTROKES ===
The command line prompt supports the following keystrokes:

<Enter> boot specified command line


<BackSpace> erase one character
<Ctrl-U> erase the whole line
<Ctrl-V> display the current Syslinux version
<Ctrl-W> erase one word
<Ctrl-X> force text mode
<Tab> list matching labels
<F1>..<F12> help screens (if configured)
<Ctrl-F><digit> equivalent to F1..F10
<Ctrl-C> interrupt boot in progress
<Esc> interrupt boot in progress
<Ctrl-N> display network information (PXELINUX only; 3.50-4.06)

=== WORKING DIRECTORY ===


At start, the initial working directory for *SYSLINUX*/*ISOLINUX* will
be the directory containing the initial configuration file. If no
configuration file is found, *SYSLINUX* should default to the
install-time working directory, however this is a known issue with some
versions including 4.06.

At start, the initial working directory for *PXELINUX* will be the


parent directory of pxelinux.0 unless overridden with DHCP option 210.
If no configuration file is found, *PXELINUX* will start a timer to
reboot the system in an attempt to restart the boot process and resolve
a possible transient issue.

=== ALTERNATE FILENAMES ===


For kernel-like file names given on the command line, *Syslinux* will
attempt to append file name extensions to the specified file name when
the file is not found in the following order: .0[*PXELINUX* only],
.bin[*ISOLINUX* only], .bs[*SYSLINUX* only], .bss[*SYSLINUX* only],
.c32, .cbt[Up to 4.06], .com[Up to 4.06] and .img[*ISOLINUX* 1.65-4.04 only].

// Is this true of file names specified in a config? As of when?


=== PATH RULES ===

The current working directory is *always* searched first, before PATH,


when attempting to open a filename. The current working directory is
not affected when specifying a file with an absolute path. For
example, given the following file system layout,

....
/boot/
/bin/
ls.c32
libls.c32
/foo/
libls.c32
....

assuming that the current working directory is /boot/foo, and assuming


that libls.c32 is a dependency of ls.c32, executing /boot/bin/ls.c32
will cause /boot/foo/libls.c32 to be loaded, not /boot/bin/libls.c32,
even if /boot/bin is specified in the PATH directive of a config file.

The reason that things work this way is that typically a user will
install all library files in the Syslinux installation directory, as
specified with the --directory installer option. This method allows
the user to omit the PATH directive from their config file and still
have things work correctly.

== AUTHOR ==
This AsciiDoc derived document is a modified version of the original
*SYSLINUX* documentation by {author} <{author-email}>. The conversion
to an AsciiDoc was made by {editor1} <{editor1-email}>

Common questions

Powered by AI

Syslinux prioritizes the current working directory over the PATH when resolving file dependencies to ensure that all library files within the Syslinux installation directory are utilized first. This approach is crucial since users typically install dependencies there, allowing them to omit the PATH directive in their configuration file without affecting functionality. The filesystem hierarchy and user-installed configurations thus remain effective and cohesive .

The Syslinux CLI provides a simplistic yet effective interface for loading modules and booting kernels by allowing users to enter commands at the boot prompt. It facilitates user interaction by supporting vital keystrokes like <Enter> to execute commands, <BackSpace> to delete characters, <Ctrl-U> to erase the line, and <Tab> to list matching labels. This set of functions enables users to efficiently manage the boot configuration and load desired kernel modules as needed .

Control key combinations like <Ctrl-U>, <Ctrl-W>, and <Ctrl-X> manage text input by allowing line and word deletions or switching modes, which enhances textual command efficiency. Function key combinations like <Ctrl-F><digit> enable swift access to help, akin to function keys <F1>..<F10>. This varied use of keys enhances flexibility and control for the user, enabling tailored boot management actions that improve user experience and system accessibility .

If PXELINUX fails to detect a configuration file during boot, it initiates a timer set to reboot the system as a fallback measure. This design attempts to resolve transient issues that could have caused the initial problem by automatically restarting the boot process, hence ensuring a higher chance for successful boot in subsequent attempts .

Defaulting to the install-time working directory can be problematic as it might not accurately reflect the intended configuration environment in the absence of a specific configuration file, potentially leading to incorrect file paths or dependencies. This issue is known to affect versions like 4.06 of Syslinux, highlighting the need for improvements in configuration handling .

In SYSLINUX and ISOLINUX, the initial working directory is set to the directory containing the initial configuration file. If the configuration file is not found, SYSLINUX defaults to the install-time working directory, although this is a known issue in some versions like 4.06. In PXELINUX, the working directory starts as the parent directory of pxelinux.0 unless DHCP option 210 is used to override this setting .

The Syslinux CLI supports in-depth troubleshooting by offering users the ability to list available boot options, verify configurations with network information through <Ctrl-N> in PXELINUX, or check current Syslinux version with <Ctrl-V>. Moreover, the capacity to interrupt or modify the boot sequence using specific keystrokes allows users to adjust boot parameters or rectify issues before kernel loading, proving invaluable for troubleshooting intricate boot problems .

When a specified kernel-like file name is not found, Syslinux appends different known file extensions in a predefined sequence to the file name: .0, .bin, .bs, .bss, .c32, .cbt, .com, and .img. This behavior is significant as it provides flexibility in locating and loading kernel or boot files across different configurations and environments, enhancing robustness in boot management .

Keystrokes like <Tab> greatly enhance user experience by listing matching labels, making it easier for users to find and select boot entries quickly. Function keys <F1>..<F12> cater to context-specific help screens if configured, providing users with immediate access to additional information or guidance, facilitating a smoother and more user-friendly interaction with the boot system .

Users can interrupt the boot process in Syslinux using keystrokes like <Ctrl-C> or <Esc>. Additionally, they can engage with the interface using <Ctrl-N> to display network information in PXELINUX, or <Ctrl-V> to view the current Syslinux version, among other commands. These interactive keystrokes provide users the ability to modify, halt, or troubleshoot the boot sequence effectively .

You might also like