Changeset 986 in ProjectBuilder for devel/pb-doc

Timestamp:

Feb 21, 2010, 7:16:55 PM (14 years ago)

Author:

Bruno Cornec

Message:

r3700@localhost: bruno | 2010-02-20 16:35:59 +0100

• Continue to improve pb.conf documentation
• veconf renamed as rbsconf
• ve4pi renamed rbs4pi
• new pb_get_postinstall generic function for rinse and rpmbootstrap
• ventp/vmntp is now optional
• licom_err needed by fedora 12
• make rpmbootstrap work for i386 distros

File:

• devel/pb-doc/pb.conf.pod (modified) (3 diffs)

devel/pb-doc/pb.conf.pod

@@ -17 +17 @@
 The key could be also default, in which case it will be used as a default value if no more precise content is given for the key.
 
-Each value is detailed below giving the nature of its use (Mandatory or Optional - only used for certain feature), the value of the key (could be the project, a distribution name, default, ...), the value of the parameter field and its format, the default configuration file in which it should be defined and an example of use.
+Each value is detailed below giving the nature of its use (Mandatory or Optional - only used for certain feature), the value of the key (could be the project, an OS name, default, ...), the value of the parameter field and its format, the default configuration file in which it should be defined (home $HOME/.pbrc, conf /etc/pb/pb.conf or /usr/local/etc/pb/pb.conf, VE vepath/.pbrc, VM vmpath/.pbrc,  or project project.pb) and an example of use.
 
 =head1 OPTIONS
@@ -261 +261 @@
 Nature: Optional
 Key: package (as provided in defpkgdir or extpkgdir)
-Value: Tag that needs to be used in package name (on rpm: name-ver-tag.arch.rpm). Useful when republishing a package due to package build modification (not code).
+Value: Tag that needs to be used in package name (on rpm: name-ver-tag.arch.rpm).  Useful when different from the project version B<projtag> and when republishing a package due to package build modification (not code).
 Conffile: project
 Example: pkgtag mindi-busybox = 2
@@ -269 +269 @@
 Nature: Optional
 Key: package (as provided in defpkgdir or extpkgdir)
-Value: Version that needs to be used in package name (on rpm: name-ver-tag.arch.rpm).
-Conffile: project
-Example: 
+Value: Version that needs to be used in package name (on rpm: name-ver-tag.arch.rpm). Useful when different from the project version B<projver>.
+Conffile: project
+Example: pkgver mindi-busybox = 1.7.3
 
 =item B<projtag>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: tag that will be used for all packages names (on rpm: name-ver-tag.arch.rpm) in the project. Each package can overwrite it using B<pkgtag>.
+Conffile: project
+Example: projtag mondorescue = 1
+
 =item B<projver>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: version that will be used for all packages names (on rpm: name-ver-tag.arch.rpm) in the project. Each package can overwrite it using B<pkgver>.
+Conffile: project
+Example: projver mondorescue = 2.2.9
+
+=item B<rbsconf>
+
+Nature: Optional
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: for mock it's the configuration directory. For rinse it's its configuration file. For rpmbootstrap it's not used yet.
+Conffile: ve
+Example: rbsconf default = /etc/mock, rbsconf default = /etc/pb/pb-rinse.conf
+
+=item B<rbsb4pi>
+
+Nature: Optional
+Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). The family name is generaly used here.
+Value: for mock it's not used. For rinse it's the script to call before doing installation (in order change the mirror location). For rpmbootstrap it's not used yet.
+Conffile: ve
+Example: rbsb4pi centos = /home/rinse/bin/before-post-install.sh
+
 =item B<supfiles>
+
+Not used yet.
+
 =item B<testver>
-=item B<veb4pi>
-=item B<veconf>
+
+Nature: Optional
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: true (meaning this is a test version, whose tag will be generated automatically, based on 0+date in order to allow regular updates, and still be inferior to tag 1 of the official version, and delivered under the test subdirectory of the ftp server). By default false.
+Conffile: project
+Example: testver mondorescue = true
+
 =item B<vedebtype>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: debootstrap (no other tool to create deb distro based chroot)
+Conffile: ve
+Example: vedebtype default = debootstrap
+
 =item B<velist>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: list of coma separated OS (under the form of os-ver-arch).
+Conffile: ve
+Example: velist default = centos-4-i386,centos-5-i386,centos-4-x86_64,centos-5-x86_64,debian-5.0-i386,debian-5.0-x86_64,lsb-4.0.1-i386,lsb-4.0.1-x86_64
+
 =item B<velogin>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: account name to use in the VE to build packages.
+Conffile: ve
+Example: velogin default = pb
+
 =item B<ventp>
+
+Nature: Optional
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: NTP server to contact for time accuracy with B<ventpcmd> before building.
+Conffile: ve
+Example: ventp default = 1.pool.ntp.org
+
 =item B<ventpcmd>
+
+Nature: Optional
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: NTP command to use to perform time synchronization with the B<ventp> server.
+Conffile: ve
+Example: ventpcmd default = /usr/sbin/ntpdate
+
 =item B<vepath>
+
+Nature: Optional
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: path where to find VEs. Ve will be created and used under that path. For each VE os-ver-arch, it will create a subdirectory tree os/ver/arch below that point.
+Conffile: ve
+Example: vepath default = /home/rpmbootstrap
+
 =item B<vepi>
 =item B<vepkglist>
 =item B<verebuild>
 =item B<verpmtype>
-=item B<version>
 =item B<vesnap>
 =item B<vetmout>
 =item B<vetype>
+
 =item B<vmhost>
 =item B<vmlist>
+
+Nature: Mandatory
+Key: project (as defined in the -p option or PBPROJ environment variable)
+Value: list of coma separated OS (under the form of os-ver-arch).
+Conffile: vm
+Example: vmlist default = asianux-2-i386,asianux-3-i386,mandrake-10.1-i386,mandrake-10.2-i386,mandriva-2006.0-i386,mandriva-2007.0-i386,mandriva-2007.1-i386,mandriva-2008.0-i386,mandriva-2008.1-i386,mandriva-2009.0-i386,mandriva-2009.1-i386,mandriva-2010.0-i386,redhat-7.3-i386,redhat-9-i386,fedora-4-i386,fedora-5-i386,fedora-6-i386,fedora-7-i386,fedora-8-i386,fedora-9-i386,fedora-10-i386,fedora-11-i386,fedora-12-i386,rhel-2.1-i386,rhel-3-i386,rhel-4-i386,rhel-5-i386,suse-10.0-i386,suse-10.1-i386,suse-10.2-i386,opensuse-10.3-i386,opensuse-11.0-i386,opensuse-11.1-i386,opensuse-11.2-i386,sles-9-i386,sles-10-i386,sles-11-i386,gentoo-nover-i386,debian-3.1-i386,debian-4.0-i386,debian-5.0-i386,ubuntu-6.06-i386,ubuntu-7.04-i386,ubuntu-7.10-i386,ubuntu-8.04-i386,ubuntu-8.10-i386,ubuntu-9.04-i386,ubuntu-9.10-i386,solaris-10-i386,asianux-2-x86_64,asianux-3-x86_64,mandriva-2007.0-x86_64,mandriva-2007.1-x86_64,mandriva-2008.0-x86_64,mandriva-2008.1-x86_64,mandriva-2009.0-x86_64,mandriva-2009.1-x86_64,mandriva-2010.0-x86_64,fedora-6-x86_64,fedora-7-x86_64,fedora-8-x86_64,fedora-9-x86_64,fedora-10-x86_64,fedora-11-x86_64,fedora-12-x86_64,rhel-3-x86_64,rhel-4-x86_64,rhel-5-x86_64,suse-10.2-x86_64,opensuse-10.3-x86_64,opensuse-11.0-x86_64,opensuse-11.1-x86_64,opensuse-11.2-x86_64,sles-10-x86_64,sles-11-x86_64,gentoo-nover-x86_64,debian-4.0-x86_64,debian-5.0-x86_64,ubuntu-7.04-x86_64,ubuntu-7.10-x86_64,ubuntu-8.04-x86_64,ubuntu-8.10-x86_64,ubuntu-9.04-x86_64,ubuntu-9.10-x86_64,solaris-10-x86_64
+
 =item B<vmlogin>
 =item B<vmmonport>