MOL(1)

NAME
startmol - start a second Operating System

SYNOPSIS
startmol [OPTIONS]

DESCRIPTION
The startmol program is used to start Mac OS, Mac OS X or a second Linux system.

EXAMPLES
Mac-on-Linux is typically invoked as follows: Start Mac OS (classic) Start Mac OS X. Start Linux

OPTIONS
MOL is normally configured through the files in the /etc/mol directory, but some useful command line options are also recognized: Kernel Module Loading Allow a small kernel module version mismatch. By default, it is required that the MOL kernel module has been compiled using kernel headers corresponding to the running kernel. A small kernel version difference is usually not a problem but it could cause a kernel freeze or panic in certain situations. The config option 'allow_kver_mismatch: yes/no' can be used to change the default behavior. MOL will exit if the Mac-on-Linux kernel module was not compiled using kernel headers corresponding to the running kernel. A small kernel version difference is usually not a problem but in certain cases it could cause a kernel freeze or a panic. Load the kernel module and exit. List available kernel modules.

Client OS Selection Start Mac OS X (or Darwin). The file molrc.osx is the primary configuration file for this mode. Start Mac OS. The primary configuration file for this mode is molrc.macos. (Since MOL does a newworld boot by default, this switch is seldom needed.) Boot Mac OS though the use of an oldworld ROM image (this image must originate from a supported machine, e.g. the PowerMac 8500). This mode is only recommended for running old versions of MacOS (7.5.2-8.5). The configuration files molrc.macos and molrc.ow are used to configure this mode. Run Linux within MOL (experimental feature). The relevant configuration file is molrc.linux. Run a statically linked ELF binary in the MOL environment. Run a self-test of the MOL engine.

Configuration Tweaking Start session num. Multiple MOL sessions can be started simultaneously as long as they have different session numbers The session number is available in the ${session} variable. Run the keyboard configuration tool. Boot Mac OS [X] from the installation CD. Set the amount of RAM available to the client OS to size (in MB). The amount of physical RAM is not necessarily an upper limit (depends on the swap size among other things). Set the ${config} variable (this variable is available to the various config files MOL parses). Add a config setting directly from the command line (instead of editing one of the config files). Note that only root can do this. Specify the linux kernel to be run (Linux booting).

Miscellaneous Options Display a short description of the command line options. Print version information and exit. Activate the MOL debugger. Wait for the MOL debugger (moldeb) to start.

More Uncommon Options Use VT num for full-screen video. Detach the TTY. Set the MOL data directory to dir (root only). Set the MOL library directory to dir (root only).

Recent MOL versions are not compatible with 2.2 kernels.

FILES
Configuration files in /etc/mol:
   session.map - Session configuration
   molrc.macos - MacOS settings
   molrc.osx - MacOS X settings
   molrc.linux - Linux settings
   molrc.video - Video configuration
   molrc.input - Mouse and keyboard configuration
   molrc.net - Network configuration
   molrc.ow - MacOS oldworld configuration The following files are used to configure the virtual tun network (in most cases, the deafult settings should suffice):
   tunconfig - Script to setup the tun networking device
   dhcpd-mol.conf - DHCP configuration for the client OS

BUGS
This man page might not be up-to-date...

AUTHORS
This man page was written by Samuel Rydh <samuel@ibrium.se>.

REPORTING BUGS
Bugs in mol should be reported to Samuel Rydh <samuel@ibrium.se>.

SEE ALSO
molvconfig(1) molrc(5) molrc.macos(5) molrc.osx(5)
molrc.video(5) molrc.input(5) molrc.ow(5) molrc.net(5)
session.map(5)