Configuration XML format

Configuration XML Format

coLinux uses an XML config file. So you may follow the Simple XML Rules to edit this file.

Note:: Configuration by an XML config file is obsolete. You can use it only in stable 0.6.X version of coLinux. The devel version 0.7.1 inform you:

XML configuration files are obsolete. Please pass command line
options, or use '@' to pass a command-line compatible configuration
file (e.g. @config.txt)

TODO: The format for the 0.7.1 configuration files are at ...?

Note:: Colinux's XML parser will not accept leading byte order mark in the XML file (and outputs strange error message when it fails to read the characters). If you're unsure what encoding your text/xml editor uses when saving the file, and you're not using any accentuated characters or other non-ASCII ones, it is safer to save the file in ASCII rather than using any UTF-8 or Unicode-like encoding (ASCII is a subset of UTF-8, so you can leave encoding='UTF-8' in the XML prologue).

Here are the keys (click on one of the key names to get more information about that particular key):

<block_device index='IDNUM' path='DEVICEPATH' enabled='true'/>	the block devices to be emulated
<bootparams>BOOT PARAMS</bootparams>	boot parameters passed to the kernel
<image path='VMLINUXIMAGE'/>	the Linux kernel to boot (with the colinux patches)
<memory size='QUANTITY'/>	how much physical memory to use
<network index='IDNUM' name='SUBSTRING' type='TYPE' mac='MACADDRESS'/>	the network cards to be emulated

Here is an example file:

<?xml version="1.0" encoding="UTF-8"?>
<colinux>
    <block_device index="0" path="\DosDevices\c:\coLinux\gentoo-i586-ext3-2g-deluxe" enabled="true"/>
    <block_device index="1" path="\DosDevices\c:\coLinux\swap_256M" enabled="true"/>
    <block_device index="2" path="\Device\Cdrom0" enabled="true"/>
    <block_device index="3" path="\Device\Harddisk1\Partition2" enabled="true"/>
    <bootparams>root=/dev/cobd0</bootparams>
    <image path="vmlinux"/>
    <memory size="64"/>
    <network index="0" name="VMnet8" type="tap"  mac="11:11:11:11:11:12"/>
</colinux>

Other example config files.

---

MassTranslated on Sun Apr 23 17:35:55 UTC 2006

---

ManuallyAdjusted on 13:45, 8 May 2006 (CEST)