Simple User Guide for Smart Boot Manager 3.x: How to compile and customize Smart Boot Manager 3.x?

Next Previous Contents

## 2. How to compile and customize Smart Boot Manager 3.x?

This section introduces the method of compiling and customizing Smart Boot Manager 3.x.

## 2.1 How to compile Smart Boot Manager 3.x?

### What software is needed to compile SmartBtmgr?

For Linux users, you need gcc, make and nasm (Netwide Assembler, URL: http://www.web-sites.co.uk/nasm/). For DOS users, you must have DJGPP (a DOS porting of GCC, URL: http://www.delorie.com/djgpp/), and nasm.

You also must have UCL compression library (URL: http://wildsau.idv.uni-linz.ac.at/mfx/ucl.html) to compile Smart BootManager.

### How to compile it?

Edit the Makefile, change the line that including `'TARGET_OS=xxx'`. If you are using Linux, change the line to `TARGET_OS=linux`, if you are using DOS, change it to `TARGET_OS=dos`.

Then just type make to compile it.

the executable file is placed in release/ directory.

type make install to install it. For linux, the default binary installation dir is /usr/sbin/, themes will be stored into /usr/share/btmgr/ and documentation is placed in /usr/share/doc/btmgr/ if you want to change them, edit the Makefile.

## 2.2 How to customize and install the theme file?

You can start your own theme file from one of the two standard theme files provided with the program. These are placed in manager/themes/ dir.

In order to change it, please refer to the comments in the theme file.

You must have nasm to compile the theme file. The compile method is very simple, for example, assume that the new theme file is mytheme.asm, the following command will generate a binary version of mytheme.asm:

> `

>     % nasm -fbin -o mytheme.bin mytheme.asm

> `

If you want to compile the theme file with a non-standard keyboard map, use the command:

> `

>     % nasm -DKEYMAP_XXX -fbin -o mytheme.bin mytheme.asm

> `

Where KEYMAP_XXX can be one of the following four symbols:

> `

>     KEYMAP_AZERTY           (AZERTY Keyboard)
>     KEYMAP_QWERTZ           (QWERTZ Keyboard)
>     KEYMAP_DVORAK           (Dvorak Keyboard)
>     KEYMAP_DVORAK_ANSI      (ANSI Dvorak Keyboard)

> `

Be sure that the keymap files (azerty.kbd ...) are in the current directory.

Now you can use installation program to install Smart Boot Manager with the new theme(see section Install Smart Boot Manager ):

for linux:

> `

>     % sbminst -t mytheme.bin -d /dev/hda

> `

or for dos:

> `

>     > sbminst -t mytheme.bin -d 128

> `

Next Previous Contents