Difference between revisions of "BURG"

From ArchWiki
Jump to: navigation, search
(redirect dead GRUB fork)
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Boot loaders]]
+
#REDIRECT: [[GRUB]]
[[es:Burg]]
+
[[it:Burg]]
+
[[ja:BURG]]
+
[[pt:Burg]]
+
[[zh-CN:Burg]]
+
[[zh-TW:Burg]]
+
BURG, '''B'''rand-new '''U'''niversal loade'''R''' from '''G'''RUB, is an alternative boot loader forked from [[GRUB]]. It uses a new object format which allows it to be built in a wider range of OS's, including Linux, Windows, OS X, Solaris, FreeBSD, etc. BURG features superior theming and has a highly configurable menu system which works at boot time in both text and graphical mode.
+
 
+
== Installation ==
+
 
+
{{Note|Crunick's binary repository is no longer up-to-date and all users should use the packages from AUR.}}
+
 
+
All BURG packages are currently found in the [[AUR]] and can be built using normal methods.
+
 
+
Only two packages are required:
+
* {{AUR|burg-bios-bzr}} or {{AUR|burg-efi-x86_64-bzr}}
+
* {{AUR|burg-themes}}
+
 
+
{{Tip|When upgrading, be sure to read the changelog which is provided in the tarball. New features and configuration options may be listed there.}}
+
 
+
=== Compile options ===
+
 
+
Tunables can be found at the top of the PKGBUILD for customizing the building process in addition to the usual options:
+
# '''_mk_burg_emu''' (only in burg-bios-bzr) (default=y) - Setting this to {{ic|y}} enables '''burg-emu''' and will double the build time. Users who have no need for '''burg-emu''' and wish to speed things up should probably set this to {{ic|n}}.
+
# '''_rm_build_dirs''' (default=n) - When set to {{ic|y}} the build directories are deleted saving precious space. This will not affect the Bazaar checkout tree or anything else in ${srcdir}.
+
 
+
=== Initial setup ===
+
 
+
The main configuration file {{ic|burg.cfg}} is not provided by any package. Users must obtain one by copying an existing one, manual construction or automatic generation using '''update-burg''' (see the section on [[#Configuration|configuration]]).
+
 
+
If installing for the first time, enter the following command to install to the MBR,
+
# burg-install /dev/sda --no-floppy
+
Substitute {{ic|/dev/sda}} with the device name for the disk.
+
 
+
== Configuration ==
+
 
+
Since BURG is derived from GRUB, its configuration is similar in most respects. The main configuration file is {{ic|/boot/burg/burg.cfg}} and is usually generated automatically. It is possible to create one by hand. However, this would be very tedious especially when adding the graphical features. It is more feasible to tweak and edit an existing one.
+
 
+
Generation is configured by the file {{ic|/etc/default/burg}} and scripts are located in {{ic|/etc/burg.d/}}.
+
 
+
=== Generation of a configuration ===
+
 
+
Creating a new {{ic|burg.cfg}} is done by the command:
+
# burg-mkconfig -o /boot/burg/burg.cfg
+
Arch Linux provides a handy shortcut:
+
# update-burg
+
{{Warning|These commands overwrite any preexisting file at that path.}}
+
 
+
=== Defaults ===
+
 
+
The file {{ic|/etc/default/burg}} is a Bash script that is sourced by burg-mkconfig when generating a configuration file. The defaults file is meant to be an easy way for users to control this process. The entries are Bash variables and arrays and are the same as those used in GRUB.
+
 
+
=== burg.d scripts ===
+
 
+
The directory {{ic|/etc/burg.d/}} contains scripts used when creating {{ic|burg.cfg}}. They are called in order of the numbers in the filenames.
+
 
+
The scripts can be turned on or off by flipping the executable bit in the file permission modes.
+
 
+
The script {{ic|40_custom}} is intended to be user editable. Users are also free to create more scripts to their liking. Remember that everything sent to stderr is viewed in the terminal and everything sent to stdout is appended to {{ic|burg.cfg}} verbatim.
+
 
+
=== Preview and runtime configuration ===
+
 
+
When editing a configuration, one does not need to reboot to see changes. If enabled in the PKGBUILD at compile time, the command '''burg-emu''' should be available. Run it as root to preview what BURG would look like at boot. '''burg-emu''' allows the user to do most things that can be done at boot (except for, you know, booting).
+
 
+
BURG also allows runtime configuration, such as changing themes, through menus and BURG's commandline. The settings are set as variables which are saved in {{ic|/boot/burg/burgenv}}.
+
 
+
== Theming ==
+
 
+
The primary reason to use BURG over other boot loaders is its theming system. To add a theme to BURG, copy its directory to {{ic|/boot/burg/themes/}} and then update the configuration.
+
 
+
To change themes, press {{ic|T}} when running BURG. A list of available themes will be shown. Use the arrow keys to highlight the theme you want and press ''Enter'' to make the selection. This can be done from within '''burg-emu''' and rebooting is not required.
+
 
+
Theme packages can be found in the [https://aur.archlinux.org/packages.php?O=0&K=burg-theme&do_Search=Go AUR]. Currently only four packages are available:
+
* [https://aur.archlinux.org/packages.php?ID=38066 burg-themes]
+
* [https://aur.archlinux.org/packages.php?ID=40226 burg-themes-extras]
+
* [https://aur.archlinux.org/packages.php?ID=43986 persia-theme-burg]
+
* [https://aur.archlinux.org/packages.php?ID=55805 arch-theme-burg]
+
 
+
== Tips and tricks ==
+
 
+
=== Shortcuts  ===
+
 
+
  F1 / h - Help
+
  F2 / t - Change theme
+
  F3 / r - Change resolution
+
  F5 / Ctrl-x - Finish edit
+
  F6 - Next window
+
  F7 - Show folded items
+
  F8 - Toggle between text and graphic mode
+
  F9 - Shutdown
+
  F10 - Reboot
+
  f - Toggle between folded and unfolded mode
+
  c - Open terminal
+
  2 - Open two terminals
+
  e - Edit current command
+
  q - Quit graphic mode
+
  i - Show theme information
+
  n - Next item with the same class
+
  w - Next Windows item
+
  u - Next Ubuntu item
+
  ESC - Exit from windows or menu
+
 
+
For full list of keyboard shortcuts, in BURG you can press {{ic|F1}}.
+
 
+
=== Important files ===
+
 
+
These files and directories control much of how BURG is configured and run.
+
* {{ic|/boot/burg/}}
+
* {{ic|/boot/burg/burg.cfg}}
+
* {{ic|/boot/burg/burgenv}}
+
* {{ic|/etc/default/burg}}
+
* {{ic|/etc/burg.d/}}
+
 
+
=== Other OS detection ===
+
 
+
In some cases, you may have other operating systems installed on other hard drives or partitions and you may want them to be listed in BURG. You can manually append their entries to {{ic|/etc/burg.d/40_custom}}, something like:
+
 
+
For Windows:
+
 
+
  menuentry "Windows 7" --class windows --class os {
+
  insmod ntfs
+
  set root='(hd0,1)'
+
  search --no-floppy --fs-uuid --set f28620c186208865
+
  chainloader +1
+
  }
+
 
+
For Debian with plymouth enable:
+
 
+
  menuentry 'Debian' --class debian --class gnu-linux --class gnu --class os --group group_main {
+
  insmod ext2
+
  set root='(hd0,4)'
+
  search --no-floppy --fs-uuid --set c5e0fb03-5cbe-4b79-acdc-518e33e814ac
+
  echo 'Loading Linux 2.6.35-trunk-amd64 ...'
+
  linux /boot/vmlinuz-2.6.35-trunk-amd64 root=UUID=c5e0fb03-5cbe-4b79-acdc-518e33e814ac ro quiet splash
+
  echo 'Loading initial ramdisk ...'
+
  initrd /boot/initrd.img-2.6.35-trunk-amd64
+
  }
+
 
+
Or you can install [https://aur.archlinux.org/packages.php?ID=35572 os-prober] and regenerate {{ic|/boot/burg/burg.cfg}}:
+
# burg-mkconfig -o /boot/burg/burg.cfg
+
 
+
Now BURG should display icons for the other systems.
+
 
+
=== Folding (grouping) ===
+
 
+
If you want to use BURG's folding feature (folding categorises the menu items, e.g. Arch and Arch Fallback will be collected under one category), you can press {{ic|F}} when burg is loaded.
+
 
+
In {{ic|burg.cfg}}, entries which has the same '''group''' will be folded when you enable folding.
+
 
+
Icons of entries will be set according to an entry's '''class'''. For example, '''--class arch''' makes an entry Arch Linux and the Arch logo will be displayed.
+
 
+
=== Linux 3.0 detection ===
+
 
+
''burg-mkconfig'' might not add an initrd line for Linux 3.0 to menu entries. You can add the line manually by editing {{ic|/boot/burg/burg.cfg}}, for example:
+
  menuentry 'Arch GNU/Linux, with Linux linux' --class arch --class gnu-linux --class gnu --class os --group group_main {
+
  {
+
      # ...
+
      # ...
+
      # ...
+
      initrd    /boot/initramfs-linux.img # for normal boot entry
+
      initrd    /boot/initramfs-linux-fallback.img # for fallback boot entry
+
  }
+
 
+
{{Warning|Add just one of the above lines, not both!}}
+
 
+
== See also ==
+
 
+
* [https://bbs.archlinux.org/viewtopic.php?id=100130&p=1 Discussion thread on Arch BBS]
+
* [http://code.google.com/p/burg/ burg at Google Code]
+
* [https://help.ubuntu.com/community/Burg burg - Ubuntu Community Documentation (Wiki)]
+

Latest revision as of 17:57, 2 September 2015

Redirect to: