GRUB-SYSLINUX2CFG(1)

📦
version 2.12 · 6 versions
, in fedora 43, fedora 44

💖 GRUB-SYSLINUX2CFG 💖

okay bestie, gather round, because this one is a glow-up tool and it lives in section 1 of the manual (User Commands, if you're keeping score). Say hi to grub-syslinux2cfg — the little icon that takes your syslinux config and transforms it into a grub.cfg. no cap.

✨ SYNOPSIS ✨

grub-syslinux2cfg [OPTION...] FILE

like… that's it. options, then a file. periodt.

🦋 DESCRIPTION 🦋

It transforms a syslinux config into a GRUB one. literally its whole job. it's giving translator. it's giving bilingual queen. 🌈

And here's every single knob you can turn, no skips, no shortcuts, all of them:

  • -c, --cwd=DIR — the current directory of syslinux. default is the parent directory of the input file, because it just assumes the obvious thing.
  • -i, --isolinux — assume the input is an isolinux configuration file. tell it, don't let it guess.
  • -o, --output=FILE — write the output to FILE. default=stdout, so if you say nothing it just yells it at your terminal. iconic behaviour honestly.
  • -p, --pxelinux — assume the input is a pxelinux configuration file.
  • -r, --root=DIR — root directory of the syslinux disk. default=/.
  • -s, --syslinux — assume the input is a syslinux configuration file.
  • -t, --target-root=DIR — root directory as it will be seen on runtime. default=/.
  • -T, --target-cwd=DIR — current directory of syslinux as it will be seen on runtime. default is the parent directory of the input file.
  • -v, --verbose — print verbose messages. she will talk. a lot. and honestly? we love that for her.
  • -?, --help — give this help list.
  • --usage — give a short usage message.
  • -V, --version — print program version.
bestie, important: mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. so don't go thinking the short ones play by different rules. they do not. 💅

😭 REPORTING BUGS 😭

Found a bug? not the vibe, but okay, report it to <bug-grub@gnu.org>. they want to know. fr fr.

👑 SEE ALSO 👑

  • grub-menulst2cfg(8) — the sibling. the other one. go look.

The full documentation for grub-syslinux2cfg is maintained as a Texinfo manual. If the info and grub-syslinux2cfg programs are properly installed at your site, the command

info grub-syslinux2cfg

should give you access to the complete manual. yes, the whole thing. the director's cut. 🎀

and that's the tea, bestie 🫶 this little page comes to you from GRUB 2.12, dated April 2026 — mwah, no notes, go transform something. 💖✨🌸

📦 where this page comes from