Configuration files

PearPC's configuraton files are plain text files and can be editted with a simple text editor (e.g. HT, Wordpad, Word, VIM, Nano, Emacs, KEdit, etc..).

The format of a configuration file is very simple. Each line is either ignored (e.g. an empty line or a line containing only a comment) or an assignment.

Example for a comment:
	# this is a comment
Example for an assigment:

	key1 = value1
Another assigment:

	key2 = "value2"
An assigment with a comment:

	key3 = "value3"		# here we assign value3 to key3

Here's a list of all available options in the configuration file from PearPC 0.4:

key name default value description
ppc_start_resolution "800x600x15" The size and depth of the PearPC window. The format is "(width)x(height)x(depth)" or "(width)x(height)x(depth)@(frequency)". (depth) can only be 15 or 32. The (frequency) is only used for full screen modes.

Note that this is only the start resolution, you can select other solutions with clients that use the video.x driver at runtime.

ppc_start_full_screen 0 Set to 1 to directly switch into full screen mode on startup.
key_toggle_mouse_grab "F12" The key code for toggling the mouse grab.
key_toggle_full_screen "Ctrl+Alt+Return" The key code for toggling full screen mode.
redraw_interval_msec 20 Redraw interval (in ms)
Must be between 10 and 500
If you set this higher, PearPC will spend less time doing redraws (and so run faster) but feel less responsive. You should adjust this to your computer speed and personal preference.
prom_bootmethod "auto" Boot method, this can be
  1. "auto", prom will boot the first bootable partition found
  2. "select", prom will show you a list of bootable partitions
  3. "force", prom will load and boot the local file prom_loadfile
prom_loadfile   A local file prom should load. (Only if prom_bootmethod="force")
prom_env_bootpath   The bootpath prom should set. (Only if prom_bootmethod="force")
bootargs   Don't change unless you know what you are doing
machargs   Set to "-v" to get a verbose startup of mach kernels (recommended)
prom_driver_graphic   A special graphic driver prom should load. ("video.x" if you want to boot Mac OS X)
page_table_pa 0x00300000 This will adjust the position of the initial page table (don't change)
cpu_pvr 0x00088302 Processor Version Register
Set to 0x000c0201 to enable G4 emulation.
memory_size 0x08000000 Size of memory (must be >= 64 MiB)
pci_ide0_master_installed 0 PCI IDE0 master installed.
pci_ide0_master_image   The file name of the image.
pci_ide0_master_type   Can be set to "hd" or "cdrom"
pci_ide0_slave_installed 0 see pci_ide0_master_installed
pci_ide0_slave_image   see pci_ide0_master_image
pci_ide0_slave_type   see pci_ide0_master_type
pci_3c90x_installed 0 3c90x network card installed.
pci_3c90x_mac "de:ad:ca:fe:12:34" The MAC address of this network card.
pci_rtl8139_installed 0 RealTek 8139 network card installed.
pci_rtl3139_mac "de:ad:ca:fe:12:35" The MAC address of this network card.
pci_usb_installed 0 USB adapter installed.
nvram_file "nvram" The file name of the file that should contain the NVRAM. Will be created if needed.

All trademarks are properties
of their respective owners.
Copyright © 2003-2006 Sebastian Biallas
Artwork by Stefan Weyergraf