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 "auto", prom will boot the first bootable partition found "select", prom will show you a list of bootable partitions "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.