Editing Mer/Documentation/Bootmenu

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

When flashing the new bootloader (bootmenu) via the Mer installer it will look for items in /etc/bootmenu.d/ and include those in the bootmenu. This is important when you have an operating system e.g. on your external card.

You could have multiple OSes on your tablet, eg:
* Maemo in internal flash, Mer on SD,
* Mer in internal flash
* Maemo in internal flash, Mer on SD, 2nd Maemo on SD

==Setting up your Bootmenu .item files for Mer==

Assuming that you have booted Maemo (or equivalent) from your internal flash and you are currently running Maemo.

(Note that you will need to look in /mnt/initfs/ for etc/bootmenu.d/ if you are running Mer or Maemo from an SD card).

After downloading and installing the Mer installer (see [[Mer/Documentation/Installation]]) you need to work as root (see [[Root_access]]).

Go to /etc/bootmenu.d/ (<code>cd /etc/bootmenu.d</code>) and check for files (<code>ls -la</code>). Every file with the ending .item in this folder will result in an entry in the bootmenu. The internal flash is always part of the bootmenu.conf, so you dont need a .item file for that.

The following example (<code>vi mer.ext.item</code>) will make an option in the bootmenu which allows you to boot Mer from the 3rd partition of the external sd card, formatted with ext3:

<pre>
<nowiki>
# will be shown in the bootmenu
ITEM_NAME="Mer on external card, p3"
# needs to be an unique string to identify this item
ITEM_ID="mer"
# which hardware device and partition should be booted. 
# use ${EXT_CARD} for the external card (slot) or ${INT_CARD} for the internal mmc
# followed by p3 for partition three
ITEM_DEVICE="${EXT_CARD}p3"
# which modules to load at boottime
ITEM_MODULES="mbcache jbd ext3"
# filesystem used on that partition
ITEM_FSTYPE="ext3"
# mounting options
ITEM_FSOPTIONS="noatime,ro"
# Use the Mer linuxrc to continue to Boot (IMPORTANT for Mer)
ITEM_LINUXRC="linuxrc"
</nowiki>
</pre>
Once finished entering the above 'code' type <code>:w</code>, press return. Then type <code>:q</code> and press return again. You'll then be back at /etc/bootmenu.d/

Don't forget to [[Mer/Documentation/Bootmenu#How_to_get_.item_files_into_the_bootmenu|use the refresh_bootmenu.d command]].

==Setting the Default bootmenu item==

With cal-tool found in initfs, it is possible to set which item to boot as default or/and set bootmenu to show up without pressing any key.

You'll need to work as root (see [[Root_access]]).

=== How to set Mer to boot as default?===

First you need to set up your .item files stored in /etc/bootmenu.d/ (see above) ''Please set the ITEM_ID to something small with nothing useless and no spaces.''

The basic command to set ID "mer" to default is :
<pre>
<nowiki>
chroot /mnt/initfs cal-tool --set-root-device mer
</nowiki>
</pre>

If the ID you set doesn't exist, it will be boot to Internal Flash as default.<br />
It ''may'' be necessary to [[Mer/Documentation/Bootmenu#How_to_get_.item_files_into_the_bootmenu|use the refresh_bootmenu.d command]] before this change is put into effect.

=== How to make bootmenu pop up without pressing any key?===

Bootmenu will pop up automatically if you add "ask:" to the command above.
For example, this will make bootmenu show up automaticlly, and ITEM_ID "mer" will be preselected:
<pre>
<nowiki>
chroot /mnt/initfs cal-tool --set-root-device ask:mer
</nowiki>
</pre>
<br />
It ''may'' be necessary to [[Mer/Documentation/Bootmenu#How_to_get_.item_files_into_the_bootmenu|use the refresh_bootmenu.d command]] before this change is put into effect.

==Setting up your Bootmenu .item files for other operating systems==

Assuming that you have booted Maemo (or equivalent) from your internal flash and are running it.

The following example (<code>vi mer.ext.item</code>) will make an option in the bootmenu which allows you to boot another operating system (e.g maemo or Deblet) from the 4th partition of the external sd card, formatted with ext3:

<pre>
<nowiki>
# will be shown in the bootmenu
ITEM_NAME="Maemo on external card, p4"
# needs to be an unique string to identify this item
ITEM_ID="maemo2"
# which hardware device and partition should be booted. 
# use ${EXT_CARD} for the external card (slot) or ${INT_CARD} for the internal mmc
# followed by p4 for partition four
ITEM_DEVICE="${EXT_CARD}p4"
# which modules to load at boottime
ITEM_MODULES="mbcache jbd ext3"
# filesystem used on that partition
ITEM_FSTYPE="ext3"
# mounting options
ITEM_FSOPTIONS="noatime,rw"
</nowiki>
</pre>

Don't forget to [[Mer/Documentation/Bootmenu#How_to_get_.item_files_into_the_bootmenu|use the refresh_bootmenu.d command]].

==How to get .item files into the bootmenu==
After editing or creating an .item file take care that you run the following command as root:
<pre>
<nowiki>
# refresh_bootmenu.d
</nowiki>
</pre>

After answering all questions with 'yes' the tablet reboots and you can choose your new or modified menu entry.

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)
Template:Mer (view source) (semi-protected)

Retrieved from "http://wiki.maemo.org/Mer/Documentation/Bootmenu"

Personal tools

Navigation

Views

Editing Mer/Documentation/Bootmenu

@@ Line 7: / Line 7: @@
 * Mer in internal flash
 * Maemo in internal flash, Mer on SD, 2nd Maemo on SD
-Remember that you need to press the menu button as you boot to access the bootmenu.
 ==Setting up your Bootmenu .item files for Mer==