Wolvix Wiki: Using Modules in Wolvix

Using Modules in Wolvix

Loading modules running 'live':

Note! All modules loaded when 'running live' are lost on reboot, see below for how to add modules permanently to the ISO.

Loading a module is simple, after acquiring the module you wish to load, use this command from a terminal:

uselivemod module.lzm

Where 'module.mo' is the file name of the module you intend to load.

If you've downloaded or placed the module in a particular directory the command would be:

uselivemod /path/module.lzm

Where /path/ is the path to the directory where the module is located.

Note! If the module you load is stored in memory, like in your 'home' directory when running Wolvix live from CD, instead of on physical storage media, it will be moved to the /mnt/live/memory directory before it's loaded.

This is a workaround to prevent modules from causing problems when loading. Not working 100%, see below.

Warning! Some modules may still cause the system to freeze, requireing the system to be hard rebooted, so make sure you've save everything you like to keep to a physical media before loading modules you don't know for sure will work.

What's causing these modules to crash the system I don't know, but it could be modules with wrong permissions on files and/or directories.

Adding modules to the Wolvix ISO:

The easy way:

Start the program ISO Master∞ found under: System --> ISO Master In the programs menu and open ISO you want to edit. The content of the ISO will be in the bottom window and you should see a wolvix directory there. Open it and you'll see:
COPYING LICENSE README base livecd.sgn make_iso.bat make_iso.sh modules optional rootcopy save tools
Copy all the modules you'd like to add to your new ISO to the modules/ directory found here. Modules which you just want to load on demand with the load= CheatCode can be placed in the optional/ directory.
Once you are done open the Image menu in ISO Master and select Save As. Give the new ISO a name and save it.

The hard way:

Note! You need some hard disk space which is writable from Wolvix to do this. 1.5GB should be enough.

Tip! You can use the hard drive partition program 'GParted' to create a partition with a Linux writable filesystem. I recommend using the 'ext3' filesystem.

You need to mount the Wolvix ISO you are going to remaster to a directory, so you can copy the files inside it to somewhere writable. It's not possible to add files to the existing ISO as it is read-only.

OK. It might be possible, but I don't know how to do it.

Once you have a place to perform the remaster it's time to create some work directories. So 'cd' to where you'd like to work and make your directories:

cd /mnt/hdb3/
mkdir -p mywolvix/mount
mkdir -p mywolvix/remaster
cd mywolvix/

Replace /mnt/hdb3/ with the hard drive and partition you are going to use. (If you just created a new partition, you may have to reboot to access it, unless you know how to mount it manually).

You should now be inside the 'mywolvix' directory, so mount the Wolvix ISO to the mount/ directory you just created:

mount -o loop /mnt/hdb3/wolvix.iso mount/

Replace /mnt/hdb3/wolvix.iso with the path to where your Wolvix ISO is located.

Now copy all the files from the mount/ directory to the remaster/ directory:

cp -ra mount/* remaster/

This may take a little while, depending on how fast your computer is.

If you take a look inside the remaster/ directory now, you should see two directories:
boot wolvix
The boot directory contains the kernel and boot loader and the wolvix directory contains the data files.

Open the wolvix directory and you'll see some files and directories:
COPYING LICENSE README base livecd.sgn make_iso.bat make_iso.sh modules optional rootcopy save tools

Take note of the modules/ directory and the 'make_iso.sh' file.

Copy all the modules you'd like to add to your new ISO to the modules/ directory found here. Modules which you just want to load on demand with the load= CheatCode can be placed in the optional/ directory.

Once you've copied over all the modules you'd like to include, it's time to create the new ISO.

Change into to remaster/wolvix/ directory.

cd remaster/wolvix/

And run the make_iso.sh script:

sh make_iso.sh ../../myresmaster.iso

This will create the new ISO in the mywolvix/ directory with the file name 'myremaster.iso'. ('../../' means go back two steps.)

Go back one step to the mywolvix/ directory again with the command:

cd ../

And unmount the original ISO like this:

umount mount/

There you have it, a new and shiny remastered ISO. Burn it to a CD, boot it and marvel at your newfound remastering skills.

CategoryGuide