coLinux
Don't have an account?
Register
Register
in: Configuration

Changes: Configuration XML format

Back to page
Edit
mNo edit summary
 
(16 intermediate revisions by 8 users not shown)
Line 1: Line 1:
  +
[[Category:Configuration]]
−
<!-- '''ConfigurationXMLFormat''' -->
  
  +
=Configuration CFG Format=
⚫
[[coLinux]] uses an XML config file. So you may follow the [[simplexmlrules]] to edit this file.
  
  ⚫
Configuration by an [[Configuration file format|XML config]] file is obsolete. You can use it only in stable 0.6.X version of coLinux. The version 0.7.1 informs you:
−  
−
Note:<br/>
  
⚫
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:
  
 
<pre>XML configuration files are obsolete. Please pass command line
  
<pre>XML configuration files are obsolete. Please pass command line
 
options, or use '@' to pass a command-line compatible configuration
  
options, or use '@' to pass a command-line compatible configuration
 
file (e.g. @config.txt)</pre>
  
file (e.g. @config.txt)</pre>
   
  +
The complete list of all entries for the new format is installed as file [http://colinux.svn.sourceforge.net/svnroot/colinux/branches/stable/doc/colinux-daemon colinux-daemon.txt] in your coLinux installation.
   
  +
A converter from XML to CFG is available as xml2cfg-0.1.0.zip on [http://downloads.sourceforge.net/colinux/xml2cfg-0.1.0.zip?download SF] or [http://www.henrynestler.com/colinux/tools/ here]
⚫
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).
  
  +
=Overview of replacements from XML into CFG format=
  +
{| border="1"
  +
! old XML format !! new Text format
  +
|-
  +
|<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki><br><nowiki><colinux></nowiki> || ''This XML headers needs to remove''
  +
|-
  +
|<nowiki><block_device index="0" path="\DosDevices\c:\coLinux\debian-image" enabled="true"/></nowiki> || cobd0="c:\coLinux\debian-image"
  +
|-
  +
|<nowiki><block_device index="1" path="\DosDevices\c:\coLinux\swap_256M" enabled="true"/></nowiki> || cobd1="c:\coLinux\swap_256M"
  +
|-
  +
|<nowiki><block_device index="2" path="\Device\Cdrom0" enabled="true"/></nowiki> || cobd2=\Device\Cdrom0
  +
|-
  +
|<nowiki><block_device index="3" path="\Device\Harddisk1\Partition2" enabled="true"/></nowiki> || cobd3=\Device\Harddisk1\Partition2
  +
|-
  +
|<nowiki><bootparams>root=/dev/cobd0</bootparams></nowiki> || root=/dev/cobd0
  +
|-
  +
|<nowiki><image path="vmlinux"/></nowiki> || kernel=vmlinux
  +
|-
  +
|<nowiki><memory size="64"/></nowiki> || mem=64
  +
|-
  +
|<nowiki><network index="0" name="VMnet8" type="tap" mac="11:11:11:11:11:12"/></nowiki> || eth0=tuntap,"VMnet8",11:11:11:11:11:12
  +
|-
  +
|<nowiki></colinux></nowiki> || ''This XML footer needs to remove''
  +
|}
  +
  +
=Configuration XML Format=
  ⚫
[[coLinux]] used to use an XML config file. So you may follow the [[Simple XML Rules]] to edit this file.
  +
  ⚫
'''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).
   
   
Line 43: Line 72:
   
 
Other [[UserConfigs|example config files]].
  
Other [[UserConfigs|example config files]].
−  
−
----[[MassTranslated]] on Sun Apr 23 17:35:55 UTC 2006
  

Latest revision as of 22:25, 19 March 2009

Configuration CFG Format[]

Configuration by an XML config file is obsolete. You can use it only in stable 0.6.X version of coLinux. The version 0.7.1 informs 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)

The complete list of all entries for the new format is installed as file colinux-daemon.txt in your coLinux installation.

A converter from XML to CFG is available as xml2cfg-0.1.0.zip on SF or here

Overview of replacements from XML into CFG format[]

old XML format new Text format
<?xml version="1.0" encoding="UTF-8"?>
<colinux>		 This XML headers needs to remove
<block_device index="0" path="\DosDevices\c:\coLinux\debian-image" enabled="true"/> cobd0="c:\coLinux\debian-image"
<block_device index="1" path="\DosDevices\c:\coLinux\swap_256M" enabled="true"/> cobd1="c:\coLinux\swap_256M"
<block_device index="2" path="\Device\Cdrom0" enabled="true"/> cobd2=\Device\Cdrom0
<block_device index="3" path="\Device\Harddisk1\Partition2" enabled="true"/> cobd3=\Device\Harddisk1\Partition2
<bootparams>root=/dev/cobd0</bootparams> root=/dev/cobd0
<image path="vmlinux"/> kernel=vmlinux
<memory size="64"/> mem=64
<network index="0" name="VMnet8" type="tap" mac="11:11:11:11:11:12"/> eth0=tuntap,"VMnet8",11:11:11:11:11:12
</colinux> This XML footer needs to remove

Configuration XML Format[]

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

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.

Community content is available under CC-BY-SA unless otherwise noted.