BR Indice(depth=1) BRBR Informazioni(forum="http://forum.ubuntu-it.org/index.php/topic,443984.0.html; rilasci="10.10 10.04";)

Introduzione

Burg è un bootloader derivato da Grub e consiste praticamente in una modifica di esso che aggiunge alcune funzioni tra le quali una facile gestione dei temi. In questa pagina vedremo come farlo funzionare.

Installazione

Installare burg è molto semplice. Basta aggiungere il ppa dando da terminale il seguente comando

sudo apt-add-repository ppa:bean123ch/burg

e aggiornare il database dei pacchetti

sudo apt-get update

ed installare il pacchetto [apt://burg burg].

sudo apt-get install burg

Per utilizzare Burg come bootloader predefinito bisogna dare il comando:

sudo burg-install "(hd0)"

Nuovi menù di sistema

Utilizzo

Per abilitare il menù di sistema è necessario scaricare un tema. Per farlo è possibile seguire il seguente link:

[http://groups.google.com/group/burg-devel http://groups.google.com/group/burg-devel]

Oppure è possibile installare semplicemente il pacchetto dei temi dando il comando

sudo apt-get install burg-themes burg-themes-common

Una volta installato il pacchetto contenente i temi, applicare un nuovo tema sarà semplicissimo. Basterà infatti premere il tasto t alla schermata di Burg e scegliere il tema che si preferisce dalla lista dei disponibili.

Altre opzioni che si possono richiamare alla pressione di alcuni tasti durante la schermata di Burg sono:

* e - modifica la voce presente il /boot/burg/burg.cfg riguardante il sistema operativo selezionato BR * t - modifica il tema BR * c - apre una finestra di terminale BR * 2 - apre due finestre di terminale BR * F5 - equivalente a Ctrl+x, usato per finire e salvare le modifiche BR * F6 - sposta la selezione all'elemento successivo BR * F8 - cambia da modalità grafica a modalità testuale BR * F9 - arresta BR * F10 - riavvia BR * ESC - ritorna alla finestra di burg BR

Struttura basa

Il formato dei file dei temi è molto semplice, {} è usato per determinare un blocco di istruzioni, e = è usato per settare una proprietà, ad esempio:

screen {
  panel {
    extend = 1
    valign = center
    halign = center

    panel {
      class = frame
      id = __menu__
    }
  }
  
  panel {
    id = __timeout__
    attach_bottom = 1
    width = 60%
    halign = center
    height = 1
    progressbar {
     width = 100%
     height = 100%
     color = "red:brown"
    }
  }
}

mapkey {
  f5 = ctrl-x
}

Gli elementi più importanti il un file del tema si definiscono in sezioni, ogni sezione ha delle funzioni specifiche. Per esempio, la sezione screen è usata per definire il layout dello schermo, mentre la sezione mapkey definisce la mappatura della tastiera.

Ci sono due comandi per leggere i file dei temi, load_config e merge_config:

load_config /boot/burg/default.txt

La differenza tra load_config e merge_config è che se una sezione esiste già, merge_config utilizza le nuove sezioni più le esistenti, mentre load_config le sovrascrive.

Data Representation

The theme file is supposed to work in both text and graphic mode, so there can be multiple components packed inside a single property.

Size

All properties that specify size uses the following representation:

10

10 character size in text and graphic mode. In graphic mode, the size is calculated using system default font, which is set using gfxfont variable. Please note that width=1 and height=1 is not the same size in pixels.

10%

The size is 10 percentage of parent widget, in both text and graphic mode.

10/1

10 pixels in graphic mode, and 1 character in text mode. Either component can use the percentage notion as well, such as:

10%/20%

10 percent in graphic mode, 20 percent in text mode.

Color

red

Red, in both text and graphic mode.

The recognized color named is as follows:

• black, blue, green, cyan, red, magenta, brown, light-gray - can be used as foreground or background color in text mode.
• dark-gray, light-blue, light-green, light-cyan, light-red, light-magenta, yellow, white - can only be used as foreground in text mode.

red/blue

Foreground color is red, background color is blue, works in both text and graphic mode.

#808080/red/blue

Use #808080 in graphic mode, foreground color red, background color blue in text mode.

Widgets become selectable if there is associated command. In this case, you may want to use different color when the widget is in selected state, this can be achieved by joining two color together with ":":

cyan/blue:light-gray/blue

When the widget is selected, foreground color is light-gray, otherwise it's cyan. Background color is blue in both situation.

Image

,,blue,#0

Draws a blue rectangle box, in both text and graphic mode.

,,blue,c

Draws a blue rectangle box using fill character 'c', in both text and graphic mode.

,,blue,#0x250F

Draws a blue rectangle box, using unicode glyph 0x250f as fill character, in both text and graphic mode.

/splash.png,,blue,#0

Draws image /splash.png in graphic mode, blue rectangle box in text mode, you can also specify a fill character.

/splash.png,,blue

Draws image /splash.png in graphic mode, nothing in text mode.

/splash.png

Same as above, but uses default scaling method and background color.

none,,blue,#0

Draws blue rectangle box in text mode, nothing in graphic mode.

In the above examples, the second parameter are all empty, it specify the scaling method of images, and can use one of the following value:

• scaling (default) - scale the image to fit the width/height of widget.
• center - draw the image at the center
• tiling - repeat the image until it fills the area.
• minfit - keeps ratio scaling, it ensures the entire image is shown, but it can leave blank at top/bottom or left/right.
• maxfit - keeps ratio scaling, it ensures no blank is left, but the image can be truncated at top/bottom or left/right.

For drawing methods that leaves blanks (center and minfit), it uses the color in third parameter as background.

Just like color, you can joined two image together using ":" to specify different image when the widget is selected.

,,cyan/blue,#0x250F:,,light-gray/blue,#0x2554

Common Properties

Some properties are shared by all widgets. This includes properties used by layout manger, command, anchor and class.

Layout manager

You can place a widget in one of two ways. You can set its location directly, or you can let the layout manager figure it out for you.

For absolute positioning, you can use the following properties:

• attach_top - distance to the top border of parent
• attach_bottom - distance to the bottom border of parent
• attach_left - distance to the left border of parent
• attach_right - distance to the right border of parent
• attach_hcenter - offset from the horizontal central line
• attach_vcenter - offset from the vertical central line

If none of the above properties are set, layout manager would try to calculate the position of widget for you. You can control its placement using these properties:

• extend - if set to 1, extend the widget in the direction of parent.
• valign - can be top, center, bottom or extend (default).
• halign - can be left, center, right or extend (default).

The parent widget uses the following properties to control the placement of children:

• direction - The direction, its value can be top_to_bottom (default), bottom_to_top, left_to_right or right_to_left.
• space - The space left between two children.

You can also set the size of widget with these properties:

• width - width of widget
• height - height of widget

If one of the above properties is not set, layout manager would try to calculate the width/height for you, which is normally the minimum size to contain its children, although it can also be expanded using the extend property mentioned above.

Sometimes you want the layout manager to calculate the size for you, but you don't want the widget to because too large or too small. In this case, you can use the following properties to limit the size of auto calculated widgets:

• min_width - minimum width of widget
• max_width - maximum width of widget
• min_height - minimum height of widget
• max_height - maximum height of widget

Please note that these properties have no effect if the size is set explicitly using width/height property.

Command

The command property associate action for current widget. Once it's set, the widget become selectable, navigation keys like up/down/left/right jumps to the next widget with command property set, and enter key execute the command.

To specify multiple commands to run in this property, use '\n' as separator. For example:

command = "chainloader +1\nboot"

Anchor

Sometime you need to group some widgets together. For example. when navigating inside a menu, you may want to loop back to the last item when using the previous key on the first item. This can be archived by setting anchor to 1 in the parent widget. Key like tab jumps to the next selectable widget in another anchor, so it can be used to switch between different menus.

Class

Many widgets share the same property value. For example, we need to draw a rectangle box in many occasion, such as in menu, sub menu, terminal window, etc. Instead of duplicate the same set of properties many times, we can give it a name using the class property, the real property is set in the class section.

If class property is not set, it would try to locate default properties using widget name.

screen {
 panel { class = frame }
 panel { class = frame }
}

class {
 frame {
  top_left = ",,cyan/blue,#0x250F:,,light-gray/blue,#0x2554"
  top = ",tiling,cyan/blue,#0x2501:,,light-gray/blue,#0x2550"
  top_right = ",,cyan/blue,#0x2513:,,light-gray/blue,#0x2557"
  left = ",tiling,cyan/blue,#0x2503:,,light-gray/blue,#0x2551"
  right = ",tiling,cyan/blue,#0x2503:,,light-gray/blue,#0x2551"
  bottom_left = ",,cyan/blue,#0x2517:,,light-gray/blue,#0x255A"
  bottom = ",tiling,cyan/blue,#0x2501:,,light-gray/blue,#0x2550"
  bottom_right = ",tiling,cyan/blue,#0x251B:,,light-gray/blue,#0x255D"
 }

 screen {
  background = ":,,blue,#0"
 }
}

Widgets

I widget sono gli elementi basa che costituiscono un interfaccia utente. Ci sono vari widget, ognuno personalizzabile tramite dei settaggi.

panel

Panel è un contenitore di altri widget. La sua posizione può essere settata. Ci sono quattro settaggi diversi per la posizione del pannello, dall'esterno all'interno:

• padding_size, padding_top, padding_bottom, padding_left, padding_right - This is the most outward layer of empty strip for panel, padding_size set the default value for all four borders, you can overwrite specific size with property like padding_top.
• border_color, border_size, border_top, border_bottom, border_left, border_right - The second layer, consists of solid color.
• top_left, top, top_right, left, right, bottom_left, bottom, bottom_right - The third layer, consist of 8 images.
• margin_size, margin_top, margin_bottom, margin_left, margin_right - The most inward layer, an empty strip to prevent children widgets from getting too closed to borders,
• background - L'immagine di sfondo

screen

Screen è il widget più importante. È come un pannello, ma non ha bordi esterni quindi ha solo le proprietà relative al bordo e allo sfondo.

text

Text è un widget che mostra una singola linea di testo. Text ha le seguenti proprietà:

• text - La stringa da mostrare
• gfx_text - La stringa da mostrare in modalità grafica, se non è settato, sia la modalità testuale che grafica sono uguali.
• color - Colore del testo
• font - Carattere del testo

image

Image è il widget che ti consente di mostrare un immagine. Proprietà:

• image - l'immagine da mostrare

edit

Edit is a widget to show a edit box. Properties:

• max_lines - The maximum number of lines to store. max_lines=1 means single line edit. max_lines=0 means unlimited lines. If it's not set, default value 100 is used.
• lines - The number of lines to show in screen. This is used to calculate the height of widget, so don't mix it with height property.
• columns - The number of columns to show in screen. This is used to calculate the width of widget, so don't mix it with width property.
• text - The initial text. You can set multiple lines of using the \n separator.
• color - Text color.
• font - Text font.

In the edit widget, use ctrl-x to save the current edit and returns, ESC to cancel.

term

Term non è altro che un emulatore di terminale, ha le stesse proprietà degli altri widget.

password

Password è un widget composto da una sola riga di immissione testo, ma diversamente dalle normali righe, mostra il carattere * invece dei reali caratteri inseriti. Usa le proprietà columns, color e font.

progressbar

Questo è usato per mostrare una barra di progresso prima che il timeout sia raggiunto. Proprietà:

• color - Il colore della progressbar. Il primo componente è il colore della barra in avanzamento, il secondo è usato per la restante parte della progressbar. Se il secondo componente viene omesso, sarà visibile la barra in un solo colore.

Template

Template è usato per definire un componente composito. Per esempio:

dialog_hello {
  panel {
    parameters = "text=text.text"
    class = frame
    text {}
  }
}

The property parameters defines the mapping between parameters and internal properties. This template accepts one parameter text, which is mapped to the text property of text widget.

Some template are used internally so they must be defined in the theme file:

• dialog_message - shows a dialog box with single text message. Must accepts text parameter which is the content of the text.
• dialog_password - shows a password input dialog. Must accepts username and password parameter which mapping to the username and password input text.
• template_submenu - Template used to generate sub menus.
• template_menuite - Template used to generate the boot menu items. Must accepts title and class parameter.

Here are the definition of these templates in the default theme file:

dialog_message {
  panel {
    parameters = "text=text.text"
    class = frame
    margin_size = 1
    margin_bottom = 0
    space = 1
    attach_hcenter = 0
    attach_vcenter = 0
    text {}
    panel {
      class = frame
      command = true
      halign = center
      margin_left = 1
      margin_right = 1
      text { text = OK }
    }
  }
}

dialog_password {
  panel {
    parameters = "username=__user__.text:password=__pass__.text"
    class = frame
    margin_size = 1
    margin_bottom = 0
    attach_hcenter = 0
    attach_vcenter = 0

    panel {
      direction = left_to_right
      space = 1
      text {
        extend = 1
        valign = center
        text = Username
      }
      panel {
        class = frame
        margin_left = 1
        margin_right = 1
        edit {
          id = __user__
          max_lines = 1
        }
      }
    }

    panel {
      direction = left_to_right
      space = 1
      text {
        extend = 1
        valign = center
        text = Password
      }
      panel {
        class = frame
        margin_left = 1
        margin_right = 1
        password {
          id = __pass__
        }
      }
    }

    panel {
      class = frame
      command = true
      halign = center
      margin_left = 1
      margin_right = 1
      text {
        text = OK
      }
    }
  }
}

template_submenu {
  panel {
    class = frame
  }
}

template_menuitem {
  panel {
    parameters = "class=image.class:title=text.text"
    class = select
    direction = left_to_right
    image {}
    text { valign = center }
  }
}

This theme pop up the sub menu alongside parent, if you prefer to show the sub menu full screen, you can replace template_submenu with this:

template_submenu {
  panel {
    width = 100%
    height = 100%

    panel {
      id = __child__
      class = frame
      valign = center
      halign = center
      extend = 1
    }
  }
}

Here, the widget with id child is the place to insert auto generated (using template_menuitem) sub menu items.

You can control the placement of popup submenu using the popup property, for example:

screen {
  panel {
   id = __menu__
   popup = left
  }
}

template_submenu {
 panel {
  class = frame
  popup = right
 }
}

The values can be:

• left, right, top, bottom - the position of popup submenu related to the current selected widget.
• abs - Absolute position, submenu starts at (0, 0).

The popup is not set, menu system tries to decide popup position automatically,

With template, the screen section is very simple:

screen {
  panel {
    extend = 1
    valign = center
    halign = center

    panel {
      class = frame
      id = __menu__
    }
  }

  panel {
    id = __timeout__
    attach_bottom = 1
    width = 60%
    halign = center
    height = 1
    progressbar {
      width = 100%
      height = 100%
      color = "red:brown"
    }
  }
}

The widget with id menu is the place to insert auto generated top level menu items defined with menuentry statement in grub.cfg. The widget with id timeout is used for timeout control. When auto booting is paused by key press, widget with id timeout and all its children would be hidden.

You can also use command menu_popup to create a dialog box based on templates. For example, to create a hello world message box, we can use the dialog_message template:

menu_popup dialog_message "text=Hello, World"

Command menu_edit is quite similar to menu_popup, but it uses two direction parameter assignment, it's used to implement the command edit box. First, we define the template in theme file:

dialog_edit {
  panel {
    parameters = "text=edit.text"
    class = frame
    width = 80%
    attach_hcenter = 0
    attach_vcenter = 0

    edit {
      lines = 10
    }
  }
}

Then uses this command to start the dialog box:

menu_edit dialog_edit text=command

In entry, the text parameter of the dialog box is set to the command parameter of current widget. After edit is done, we reverse the order and update the command parameter to the new text.

Interazione dell'utente

Con il nuovo aggiornamento del pacchetto del ppa (2010.06.07) c'è un nuovo comando chiamato menu_read. è usato per inserire una proprietà da finestra di dialogo ed assegnarla ad una variabile. Questo modello per l'interazione dell'utente, per esempio, aggiungere questo modello di dialogo al file di tema.

dialog_input {
  panel {
    parameters = "old_value=__old__.text:new_value=__new__.text"
    class = frame
    margin_size = 1
    margin_bottom = 0
    attach_hcenter = 0
    attach_vcenter = 0

    panel {
      direction = left_to_right
      space = 1
      text {
        extend = 1
        valign = center
        text = "Old value"
      }
      text {
        id = __old__       
      }
    }

    panel {
      direction = left_to_right
      space = 1
      text {
        extend = 1
        valign = center
        text = "New value"
      }
      panel {
        class = frame
        margin_left = 1
        margin_right = 1
        edit {
          id = __new__
          max_lines = 1
        }
      }
    }

    panel {
      class = frame
      command = "menu_read new_value AA"
      halign = center
      margin_left = 1
      margin_right = 1
      text {
        text = OK       
      }
    }
  }
}

Il modello di sopra può essere visualizzato usando:

menu_popup dialog_input old_value=${AA}

Il campo "Old value" mostra il valore della variabile AA, e il valore dell' edit box "New value" sarà assegnato a AA quando si fa clic su "OK".

Scorciatoie da tastiera

E' possibile utilizzare la sezione keymap per mappare qualche tasto per un altro. Questo è utile in piattaforme come EFI dove tasti come ctrl non possono essere di input.

la sezione onkey associa i comandi di Grub per i stasti. Se ub tasto è già gestito dal widget in corso, il comando definito nella sezione onkey section è ignorato. Per esempio, dentro una finestra di terminale, c è usato come carattere di input, così il comando definito in onkey è ignorato.

onkey {
  e = "*menu_edit dialog_edit text=command"
  t = "if menu_edit dialog_line text=title; then menu_refresh; fi"
  c = "*menu_popup term_window"
  2 = "*menu_popup two_term"
  f6 = ui_next_anchor
  f8 = menu_toggle_mode
  f9 = halt
  f10 = reboot
}

mapkey {
  f5 = ctrl-x
}

L'asterisco all'inizio del comando indica che questo comando è protetto da password, questo sarà spiegato al paragrafo successivo..

Password

Per abilitare la protezione con password, aggiungere il seguente comando all'inizio del file grub.cfg:

set superusers=admin
password --md5 admin '$1$A1tpOB3$bTHEMeIVvBbQsLZIWmJp/.'
password user1 user1

La variabile superusers imposta i super users. I comando password imposta la password for singolo utente. Con l'opzione --md5, la password deve esser la password, altrimenti è solo testo.

Per generare una passsword md5, usare il comando:

grub-mkpasswd admin

Il cui output è del tipo:

$1$A1tpOB3$bTHEMeIVvBbQsLZIWmJp/.

E' possibile usare anche il comando openssl per generarla:

openssl passwd -1 -salt 1234567 admin

Il cui output è del tipo:

$1$1234567$ergpnZu0mLdD77Dbmwjpb1

Per proteggere certe voci di avvio, aggiungere l'opzione --users nella dichiarazione del menuentry:

menuentry Item1 --users user1 {
  true
}

Solo user1 e i super utenti possono accedere a questa voce di avvio .

Nella definizione delle scorciatoie da tastiera, è possibile aggiungere * all'inizio del comando così che solo i super utenti possano accedervi.

Save default

To enable save default, you first need to generate a environment file using grub-editenv:

sudo grub-editenv /boot/grub/grubenv create

Default location for environment file is grubenv in the grub directory, although you can overwrite it with envfile variable. Command load_env read the environment file from disk.

To enable save default for all items, you can set savedefault=1 in grub.cfg, to skip some item, adds --nosave option in menuentry statement. If you only want to save a few items, then you can skip savedefault=1, but adds --save option in items you want to save. For example:

set envfile=/boot/grub/grubenv
set savedefault=1
load_env

menuentry Item1 --nosave {
  true
}

menuentry Item2 --save {
  true
}

You also set default item using config file, for example, to boot the first item, add this line to /etc/default/grub:

GRUB_DEFAULT=0

To boot the saved item from last boot:

GRUB_DEFAULT=saved

Don't forget to use grub-mkconfig/update-grub to update the real grub.cfg.

Timeout

E' possibile utilizzare la variabile timeout per abilitare l'avvio automatico se nessun tasto è premuto in N secondi:

set timeout=5

Se timeout è impostato a 0, si avvierà immediatamente, altrimenti è possibile fermarlo premendo un qualsiasi tasto all'avvio. In the case of timeout=0, the menu is not drawn unless auto boot process is halt.

Timeout può essere impostato nel file config usando la variable GRUB_TIMEOUT.

Icone del menu

Per aggiungere icone alle voci di boot, usare l'opzione --class:

menuentry Item1 --class image_ubuntu {
  true
}

Allora nel file di tema, definire la classe image_ubuntu:

class {
  image_ubuntu {
    image = "${prefix}/icons/ubuntu.png"
  }
}

Menu predefinito

È possibile aggiungere un menu predefinito seguendo le voci definite con menuentry. Il menu predefinito è definito nel file del tema usando la sezione menu:

menu {
  Tools {
    class = image_dir
    users = user
    save = 0

    "Toggle Mode" {
      class = image_tools
      command = menu_toggle_mode
    }

    "Terminal" {
      class = image_term
      command = "menu_popup term_window"
    }

    "Two Term" {
      class = image_term
      command = "menu_popup two_term"
    }

    "About" {
      class = image_about
      command = "menu_popup dialog_message \"text=This is GNU GRUB\""
    }
  }

  Shutdown {
    class = image_shutdown
    command = "halt"
  }

  Restart {
    class = image_restart
    command = "reboot"
  }
}

Qui, class corrisponde all'opzione --class nel menuentry, users corrisponde a --users, save=1/save=0 corrispondono a --save e --nosave.

Configurazione dinamica di PXE

Burg aggiunge un nuovo comando pxecfg, che può essere utilizzato per eseguire certi comandi in base agli attuali indirizzi IP / MAC.

Innanzitutto, scrivere un file config di pxe , il cui formato è molto simile al tema del menù.

ip {
  192 {
    168.2 {
      command = "echo ip 192.168.2.*"
    }

    169 {
      command = "echo ip 192.169.*.*"
    }

    command = "echo ip 192.*.*.*"
  }
}

mac {
  00-0c-29-1a {
    command = "echo mac 00-0c-29-1a-*-*"
  }

  command = "echo mac *-*-*-*-*-*"
}

Usare questo in grub.cfg per caricare il file config:

pxecfg /config.txt

Risoluzione problemi

Burg non troverà un grub.cfg.

Le versioni più recenti usano burg.cfg

Ulteriori risorse

• [http://code.google.com/p/burg/ Sito del progetto]

• [https://launchpad.net/burg Burg su Launchpad]

• [http://www.burgloader.com/bbs Forum di Burg]

• [http://groups.google.com/group/burg-devel Mailing list di Burg]

• [http://code.google.com/p/burg/wiki/Screenshots Schermate di Burg]

CategoryHomepage