GRUB-SYSLINUX2CFG(1)

πŸ’– NAME πŸ’–

okay so bestie, meet grub-syslinux2cfg β€” the little icon that transforms a syslinux config into a grub.cfg. that's it. that's the whole job. and it ate. ✨

(also hi, this is the GRUB-SYSLINUX2CFG(1) page, from the User Commands girlies β€” welcome πŸŽ€)


✨ SYNOPSIS ✨

grub-syslinux2cfg [OPTION...] FILE

like, you give it a FILE, you sprinkle options on top, it gives you GRUB. no cap. πŸ¦‹


🌸 DESCRIPTION 🌸

so the whole vibe: it takes a syslinux config and turns it into a GRUB one. literally the entire personality. 🫢

the flags themselves πŸ’…

okay so listen, there are a LOT of them, but they're all your friends. every one of these has a default, and defaults matter, so I'm telling you every single one:

  • -c, --cwd=DIR β€” sets the current directory of syslinux. [default is parent directory of input file] β€” yes, it reads that off your input file, she's smart like that. πŸ™ˆ
  • -i, --isolinux β€” assume the input is an isolinux configuration file. assuming is the whole thing here, bestie.
  • -o, --output=FILE β€” write the output to FILE. [default=stdout] β€” so if you forget it, it just yells into your terminal. iconic.
  • -p, --pxelinux β€” assume the input is a pxelinux configuration file. same energy, different flavor.
  • -r, --root=DIR β€” root directory of the syslinux disk. [default=/] 🌈
  • -s, --syslinux β€” assume the input is a syslinux configuration file. yes there are three of these "assume" flags. yes you pick one. no I'm not judging. πŸ’€
  • -t, --target-root=DIR β€” the root directory as it will be seen on runtime. [default=/] β€” very "who will she be when she grows up" of it honestly.
  • -T, --target-cwd=DIR β€” the current directory of syslinux as it will be seen on runtime. [default is parent directory of input file] β€” note the capital T, that's a different flag than lowercase t, do NOT mix them up, I'm begging 🫢
  • -v, --verbose β€” prints verbose messages. she talks more. we love when she talks more. πŸ—£οΈ
  • -?, --help β€” give this help list. the "help me help you" button.
  • --usage β€” give a short usage message. the lowkey version of --help. no long option twin for this one, just the long option, that's just how she is.
  • -V, --version β€” print program version. know your queen's version number. πŸ‘‘
⭐ important little note, bestie: Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. so like, if the long one wants a DIR, the short one wants a DIR too. they're a matching set. fr fr.

πŸ¦‹ REPORTING BUGS πŸ¦‹

found a bug? don't come for me, report it to <bug-grub@gnu.org> 😭 that's the whole address, angle brackets and all.


πŸ”₯ SEE ALSO πŸ”₯

  • grub-menulst2cfg(8) β€” her cousin. different conversion, same family. iykyk.

also!! the full documentation for grub-syslinux2cfg is maintained as a Texinfo manual. so if the info and grub-syslinux2cfg programs are properly installed at your site, this command:

info grub-syslinux2cfg
should give you access to the complete manual. periodt. ✨

and that's the page, bestie πŸŽ€ β€” brought to you by GRUB 2.12-1ubuntu7.3, dated March 2025, and delivered with the full GRUB-SYSLINUX2CFG(1) energy. mwah. πŸ’œπŸ’…

πŸ“¦ where this page comes from