=head1 conf.xml

Example of a commented conf.xml file. Keep in mind that most of those
parameters are correct, and you don't need to change whole of them.
Examples are available in this package, so please use one of them to 
base your configuration.

You should only change those one:
{nameid}
{version}
{arch}
{repo}{path}
{media}{list}*
{iso}{header}*

Fully commented file:
---------------------
first it's an xml file:
 <?xml version='1.0'?>

name of the product
 <productname desc="The Linux product">

identification of the product
 <nameid>XtreemOS</nameid>

you should really care about this parameter, how many urpmq could you launch at the same time ?
10 is an high value, use it only on multi-core computer.
 <nb_fork>10</nb_fork>

If you want to resign you packages, define in wich file you store the password to sign RPMS, and the
gnupg file used to sign them. BCD can only sign for the moment all packages with the same key. It will
be able to sign later a media with a specific public key.
 <signature>/home/xtreemos/.signature.gpg</signature>
 <rpmrc>/home/xtreemos/.rpmrc</rpmrc>

based_on parameter define on wich version of Mandriva this product will be built.
This parameter define if we need synthesis or hdlists (since 2009.1 only synthesis are needed)
It will be use to get the path of the Mandriva repositery
 <based_on>2009.0</based_on>

urpmqlogs paramater define the directory to store previous urpmq queries, if not defined the system will use the /var/lib/bcd dir.
 <urpmqlogs>/home/plop/urpmqlogs</urpmqlogs>

Arch parameter is mandatory, it will be also used to get the path of the MDV repositery
 <arch>i586</arch>

path to the repositery
 <repo desc="Where is the repositery of the distribution">
  <path>/mnt/BIG/dis</path>
 </repo>

so the full path of the Mandriva repositery will be in our example
 </mnt/BIG/dis/2009.0/i586>

workdir is where you want to store the result of the build
 <workdir desc="Where is my working dir">
  <path>/home/xtreemos/build_bcd</path>
 </workdir>

basename of log files
 <tocopy_file>tocopy_plop</tocopy_file>

all Isolinux information
 <isolinux desc="isolinux info">
  <defaultpath>isolinux</defaultpath>

if you want to use proprietary firmware in stage1 (from the non-free/initrd-firmware package) set the option to yes
 <firmware>yes</firmware>

if you want to point to a custom isolinux directory
 <fullpath>/home/xtreemos/export_i386/isolinux</fullpath>

if you want to add a entry in your isolinux.cfg
 <!-- add hdt entry in syslinux.cfg -->
  <entry name="hdt" desc="Main media">
   <bin>/usr/lib/syslinux/hdt.c32</bin>
   <label>hdt</label>
   <kernel>hdt.c32</kernel>
   <append>modules=modules.pci</append>
  </entry>

some section are mandatory to keep the array structure of the xml file
  <!-- keep this entry to create an array ref -->
  <entry></entry>

if you want to copy extra files to the isolinux buildir
 <tocopy name="pcimap">
  <file>/lib/modules/2.6.31-server-2mnb/modules.pcimap</file>
 </tocopy>
 <tocopy name="ids">
  <file>/usr/share/pci.ids</file>
 </tocopy>
 <tocopy></tocopy>
 </isolinux>

all information relatives to the installer (stage2)
 <installer desc="path to the Mandriva installer (stage1/stage2)">
  <defaultpath>install</defaultpath>

if you want to use a custom installer
 <fullpath>/home/xtreemos/export_i386</fullpath>

path to custom advertising
 <advertising>
  <defaultpath>advertising</defaultpath>
  <fullpath>/home/xtreemos/Build/pieces/advertising</fullpath>
 </advertising>

full path and name of your patch for stage2 to copy in the buildir/install directory
  <patch>/home/xtreemos/Build/pieces/patch-oem.pl</patch>
 </installer>

theme to use to patch all.rdz file
theme name will be used to install mandriva-release-THEMENAME and avoid
problem of mixing theme on a same product
 <!-- theme must be available to path altx/all.rdz files -->
 <theme name="mandriva-release-Free">
  <bootsplash>Mandriva-Free</bootsplash>
  <bootsplash_path>/usr/share/bootsplash</bootsplash_path>
  <gfxboot_path>/usr/share/gfxboot</gfxboot_path>
 </theme>

media section will defined wich media you want to use and you want to create on the DVD
 <media desc="media to take into account to build the ISO">
 <!-- WARNING this media must be named "Main" because main media is mandatory for all other media-->
 <!-- Morever the "Main" media is always the Name use for an MDV repositery -->
 <!-- futur feature will provide a way to specify another name for the basic repo of an MDV distribution -->
 <!-- use the supp_media option if you needed to use media option of urpmi, usefull for external media
  wich need main and contrib to be installed, use the urpmi syntax of \-\-media (no space, media separated by coma)
 <media_supp>Main,Main Updates,Contrib,Contrib Updates</media_supp>-->
 <list name="Main" desc="Main_media">

drop option is usefull to remove the media before the rpmcheck (usefull for media main32)
  <drop>yes</drop>

remove_noarch is used to remove all noarch.rpm from a media (usefull for media main32 on pwp64 and free64)
  <remove_noarch>yes</remove_noarch>

input files
  <!-- MANDATORY list of wanted packages on the iso -->
  <input name="base">
   <file>lists/input_main</file>
  </input>
  <input name="lang">
   <file>lists/languages</file>
  </input>
  <!-- to create an array you must keep this even if it is empty -->
  <input name="xos">
   <file>lists/xos_list</file>
  </input>

you can use an external media, but this media must have a media_info directory
you must use external media if this media is not available in the repositery.
IE: restricted32 packages on a PowerPack 64bits product
 <!-- external media repositery with hdlists -->
  <external name="xos">
   <fullpath_mediadir>/home/xtreemos/repo_xos/2009.0/i586/media/xtreemos/release</fullpath_mediadir>
  </external>

Packages unwated on the DVD, they will be removed at the end of the installation process
 <!-- MANDATORY list of unwanted packages on the iso -->
  <exclude name="exclude">
   <file>lists/exclude_main</file>
  </exclude>
  <!-- to create an array you must keep this even if it is empty -->
  <exclude>
  </exclude>

switch nosuggest options to yes if you don't want to use RPMS's suggests
 <!-- nosuggests options should be yes or no -->
 <nosuggests>no</nosuggests>

I will use the media name "mediadir" and put it in the directory media/'destmedia' on the DVD
 <!-- will be taken in {repo}{version}{arch}/media -->
  <mediadir>main</mediadir>
  <destmedia>main</destmedia>

where to find the pubkey in the repositery (the path will be media/'mediadir'/'pubkey')
If you want to specify a specific file to use as pubkey, leave <pubkey> empty.
 <pubkey>release/media_info/pubkey</pubkey>
 <file_pubkey>/path_to_file/the_pubkey</file_pubkey>

if you want to use backports, testing or updates sub-media, set option to yes, note: release media should be mandatory
  <release>yes</release>
  <updates>yes</updates>
  <backport>no</backport>
  <testing>no</testing>
 </list>
 <!-- keep this entry to create an array ref -->
  <list></list>
 </media>

all media_info informations are in this section
 <mediainfo desc="All files relatives to media_info dir">

version will be used to generate a good media.cfg files (we don't use hdlits.cz since 2009.1 release)
 <version>2009.0</version>

use 'fullpath' parameter to use custom files
 <!-- set fullpath if you want to use an files in a non MDV repositery -->
 <fullpath>/home/xtreemos/Build/pieces</fullpath>
 <mediainfo_dir>media/media_info</mediainfo_dir>
 <rpmsrate>rpmsrate</rpmsrate>
 <compssusers>compssUsers.pl</compssusers>
 <filedeps>file-deps</filedeps>

if you want to add an urpmi options to install packages
 <urpmi_option>-a</urpmi_option>

If you want to do some extra filter to keep latest release of a packages on the DVD.
All packages listed in extra-filter are NOT filtered: so if you have more than one
version of a package in the builddir, it will bypass the rpm comparaison.
For all other packages available in the builddir, BCD 
will keep the latest one (rpm version comparaison)
 <filter>lists/extra-filter</filter>

media.cfg options
 <askmedia desc="add for other media ?">
  <todo>yes</todo>
 </askmedia>
 <suppl desc="add an external media ?">
  <todo>yes</todo>
 </suppl>
  <xmlinfo>
 <todo>no</todo>
  </xmlinfo>
 </mediainfo>
	
ISO section
 <iso>

tag name and some extra parameters
 <tag>rc1</tag>
 <minor>0</minor>
 <subversion>1</subversion>
 <product>Download</product>
 <branch>Devel</branch>
 <type>basic</type>
 <!-- dual arch not yet supported -->
 <dualarch>no</dualarch>
 <!-- SIZE is not YET USED !!! -->
 <size>700</size>
 <!-- media.cfg will be stored on genisoimage->{builddir}/{nameid}/{arch} -->
 <mediacfg>media/media_info/media.cfg</mediacfg>
 <hdlist>yes</hdlist>
 <synthesis>yes</synthesis>

info used by the genisoimage tool
 <header desc="Iso header info">
  <systemid>XtreemOS Linux</systemid>
  <volumeid>XOS-2.0-i586</volumeid>
  <volumesetid>XtreemOS Linux - 2.0 - i586 DVD </volumesetid>
  <publisherid>XtreemOS</publisherid>
  <datapreparer>XtreemOS-Linux</datapreparer>
  <applicationid>XtreemOS Linux - 2.0</applicationid>
  <copyrightid>XtreemOS Linux</copyrightid>
 </header>

genisoimage paramater
 <genisoimage desc="iso generation tool">
  <options>-f -r -J -hide-rr-moved -nobak -cache-inodes -no-emul-boot -boot-load-size 4 </options>
  <bootcat>isolinux/boot.cat</bootcat>
  <!-- builddir and destdir will always use the workdir -->
  <builddir>build</builddir>
  <isodir>iso</isodir>
 </genisoimage>
 </iso>
 </productname>

=cut