Changeset 989 in ProjectBuilder


Ignore:
Timestamp:
Feb 23, 2010, 8:22:13 AM (15 years ago)
Author:
Bruno Cornec
Message:

r3705@localhost: bruno | 2010-02-22 01:48:44 +0100

  • Improved pod format for pb.conf.pod
  • man page generated from pod now included in Makefile.PL and packages
  • Move the pod file into the etc conf dir
Location:
devel
Files:
2 edited
1 moved

Legend:

Unmodified
Added
Removed

  • devel/pb-modules/Makefile.PL

    r969 r989  
    3232    my $text ="";
    3333
    34     # Grab out any CONFDIR param
     34    # Grab out any CONFDIR or MANDIR param
    3535    my $confdir = undef;
     36    my $mandir = undef;
    3637
    3738    while (my $arg = shift @ARGV) {
    … …  
    3940        if ($key =~ /^CONFDIR$/) {
    4041            $confdir = $value;
     42        } elsif ($key =~ /^MANDIR$/) {
     43            $mandir = $value;
    4144        }
    4245    }
    4346
    4447    my $etcdir = $confdir || "/usr/local/etc/pb";
     48    my $mandir = $mandir || "/usr/local/share/man";
    4549
    4650    # Use that conf dir info to modify Distribution.pm
    … …  
    5155    $text .= "\t".'chmod 755 $(DESTDIR)'."$etcdir\n";
    5256    $text .= "\t".'cp etc/pb.conf $(DESTDIR)'."$etcdir\n";
     57
     58    # Produce the man page for pb.conf
     59    $text .= "\t".'mkdir -p $(DESTDIR)'."$mandir/man5\n";
     60    $text .= "\t".'pod2man etc/pb.conf.pod > $(DESTDIR)'."$mandir/man5/pb.conf.5\n";
    5361    return($text);
    5462}

  • devel/pb-modules/etc/pb.conf.pod

    r988 r989  
    2323=over 4
    2424
    25 =item B<defpkgdir>>
    26 
    27 Nature: Mandatory
    28 Key: project (as defined in the -p option or PBPROJ environment variable)
    29 Value: coma separated list of packages built by default in this project. When not using any package name as a parameter to pb commands, this list will be used.
    30 Conffile: project
    31 Example: defpkgdir mondorescue = mondo,mindi
    32 NB: a default value is not really meaningful.
     25=item B<defpkgdir>
     26
     27 Nature: Mandatory
     28 Key: project (as defined in the -p option or PBPROJ environment variable)
     29 Value: coma separated list of packages built by default in this project. When not using any package name as a parameter to pb commands, this list will be used.
     30 Conffile: project
     31 Example: defpkgdir mondorescue = mondo,mindi NB: a default value is not really meaningful.
    3332
    3433=item B<extpkgdir>
    3534
    36 Nature: Optional
    37 Key: project (as defined in the -p option or PBPROJ environment variable)
    38 Value: coma separated list of packages built in addition in this project. When using the all package name as a parameter to pb commands, this list will be used, in addition to the defpkgdir list.
    39 Conffile: project
    40 Example: extpkgdir mondorescue = mondo-doc,mindi-mindibusybox
     35 Nature: Optional
     36 Key: project (as defined in the -p option or PBPROJ environment variable)
     37 Value: coma separated list of packages built in addition in this project. When using the all package name as a parameter to pb commands, this list will be used, in addition to the defpkgdir list.
     38 Conffile: project
     39 Example: extpkgdir mondorescue = mondo-doc,mindi-mindibusybox
    4140
    4241=item B<filteredfiles>
    4342
    44 Nature: Optional
    45 Key: package (as provided in defpkgdir or extpkgdir)
    46 Value: coma separated list of files that will be filtered using the macro system from pb, during the creation of the compressed source tar files for this package. Their path is relative to the directory containing the package.
    47 Conffile: project
    48 Example: filteredfiles mindi = rootfs/sbin/init,mindi,install.sh,doc/mindi.8
     43 Nature: Optional
     44 Key: package (as provided in defpkgdir or extpkgdir)
     45 Value: coma separated list of files that will be filtered using the macro system from pb, during the creation of the compressed source tar files for this package. Their path is relative to the directory containing the package.
     46 Conffile: project
     47 Example: filteredfiles mindi = rootfs/sbin/init,mindi,install.sh,doc/mindi.8
    4948
    5049=item B<namingtype>
    5150
    52 Nature: Optional
    53 Key: package (as provided in defpkgdir or extpkgdir)
    54 Value: perl, if packages are CPAN perl modules that need to be named respecting the distribution perl convention (perl-Name for rpm, libname-perl for deb)
    55 Conffile: project
    56 Example: namingtype ProjectBuilder = perl
     51 Nature: Optional
     52 Key: package (as provided in defpkgdir or extpkgdir)
     53 Value: perl, if packages are CPAN perl modules that need to be named respecting the distribution perl convention (perl-Name for rpm, libname-perl for deb)
     54 Conffile: project
     55 Example: namingtype ProjectBuilder = perl
    5756
    5857=item B<osambiguous>
    5958
    60 Nature: Optional
    61 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an OS name.
    62 Value: coma separated list of distributions which use the same file name in /etc for different distributions (ex: /etc/redhat-release for redhat, rhel, mandriva,...). Cf: B<osrelambfile>
    63 Conffile: pb
    64 Example: osambiguous debian = debian,ubuntu
     59 Nature: Optional
     60 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an OS name.
     61 Value: coma separated list of distributions which use the same file name in /etc for different distributions (ex: /etc/redhat-release for redhat, rhel, mandriva,...). Cf: B<osrelambfile>
     62 Conffile: pb
     63 Example: osambiguous debian = debian,ubuntu
    6564
    6665=item B<oscodename>
    6766
    68 Nature: Optional
    69 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an os-ver.
    70 Value: code name. Mostly useful for debian and ubuntu, due to debootstrap.
    71 Conffile: pb
    72 Example: oscodename debian-5.0 = lenny
     67 Nature: Optional
     68 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an os-ver.
     69 Value: code name. Mostly useful for debian and ubuntu, due to debootstrap.
     70 Conffile: pb
     71 Example: oscodename debian-5.0 = lenny
    7372
    7473=item B<osfamily>
    7574
    76 Nature: Mandatory
    77 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an os.
    78 Value: OS family name (used to group similar distribution for handling)
    79 Conffile: pb
    80 Example: osfamily debian = du
     75 Nature: Mandatory
     76 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). In that case, should be an os.
     77 Value: OS family name (used to group similar distribution for handling)
     78 Conffile: pb
     79 Example: osfamily debian = du
    8180
    8281=item B<osmindep>
    8382
    84 Nature: Optional
    85 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
    86 Value: coma separated list of packages needed before setupvm|ve can be run. Install them with your distribution in VM or automatically in VE when possible.
    87 Conffile: pb
    88 Example: osmindep default = perl,sudo,wget,tar,make,gzip
     83 Nature: Optional
     84 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
     85 Value: coma separated list of packages needed before setupvm|ve can be run. Install them with your distribution in VM or automatically in VE when possible.
     86 Conffile: pb
     87 Example: osmindep default = perl,sudo,wget,tar,make,gzip
    8988
    9089=item B<osnover>
    9190
    92 Nature: Optional
    93 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    94 Value: true|false. True means that this OS has no need to keep the version
    95 Conffile: pb
    96 Example: osnover gentoo = true
     91 Nature: Optional
     92 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     93 Value: true|false. True means that this OS has no need to keep the version
     94 Conffile: pb
     95 Example: osnover gentoo = true
    9796
    9897=item B<osperldep>
    9998
    100 Nature: Optional
    101 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    102 Value: coma separated list of perl modules needed by pb and not provided in a package format for the relative OS, and that will be installed from CPAN in your VM/VE.
    103 Conffile: pb
    104 Example: osperldep rhel-5 = Module-Build,File-MimeInfo,File-BaseDir,Mail-Sendmail
     99 Nature: Optional
     100 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     101 Value: coma separated list of perl modules needed by pb and not provided in a package format for the relative OS, and that will be installed from CPAN in your VM/VE.
     102 Conffile: pb
     103 Example: osperldep rhel-5 = Module-Build,File-MimeInfo,File-BaseDir,Mail-Sendmail
    105104
    106105=item B<osperlver>
    107106
    108 Nature: Mandatory (for each module mentioned in B<osperldep>)
    109 Key: Perl Module (as defined in B<osperldep>)
    110 Value: Version of the perl module that needs to be found on CPAN.
    111 Conffile: pb
    112 Example: Date-Manip = 5.54
     107 Nature: Mandatory (for each module mentioned in B<osperldep>)
     108 Key: Perl Module (as defined in B<osperldep>)
     109 Value: Version of the perl module that needs to be found on CPAN.
     110 Conffile: pb
     111 Example: Date-Manip = 5.54
    113112
    114113=item B<ospkgdep>
    115114
    116 Nature: Optional
    117 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    118 Value: coma separated list of packages that are needed by pb and should be installed automatically in the VM/VE during the setupvm|ve phasis by pb.
    119 Conffile: pb
    120 Example: ospkgdep rhel-5 = wget,make,ntp,patch,perl-DateManip
     115 Nature: Optional
     116 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     117 Value: coma separated list of packages that are needed by pb and should be installed automatically in the VM/VE during the setupvm|ve phasis by pb.
     118 Conffile: pb
     119 Example: ospkgdep rhel-5 = wget,make,ntp,patch,perl-DateManip
    121120
    122121=item B<osrelambfile>
    123122
    124 Nature: Mandatory (per OS mentioned in B<osambiguous>)
    125 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). Should be the OS name here.
    126 Value: full path name of the ambiguous file describing that distribution, as well as some others. All the distributions mentioned here should also be mentioned with their ambiguous other distribution in the B<osambiguous> parameter.
    127 Conffile: pb
    128 Example: osrelambfile debian = /etc/debian_version
     123 Nature: Mandatory (per OS mentioned in B<osambiguous>)
     124 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). Should be the OS name here.
     125 Value: full path name of the ambiguous file describing that distribution, as well as some others. All the distributions mentioned here should also be mentioned with their ambiguous other distribution in the B<osambiguous> parameter.
     126 Conffile: pb
     127 Example: osrelambfile debian = /etc/debian_version
    129128
    130129=item B<osrelexpr>
    131130
    132 Nature: Mandatory (per OS mentioned in B<osrelambfile> and B<osrelfile>)
    133 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    134 Value: the perl regular expression used to parse the B<osrelambfile> in order to extract from it the version of the distribution (in parenthesis to allow its usage as $1 by perl)
    135 Conffile: pb
     131 Nature: Mandatory (per OS mentioned in B<osrelambfile> and B<osrelfile>)
     132 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     133 Value: the perl regular expression used to parse the B<osrelambfile> in order to extract from it the version of the distribution (in parenthesis to allow its usage as $1 by perl)
     134 Conffile: pb
    136135osrelexpr rhel = Red Hat (?:Enterprise Linux|Linux Advanced Server) .*release ([0-9.]+).* \(
    137 Example:
     136 Example:
    138137
    139138=item B<osrelfile>
    140139
    141 Nature: Mandatory
    142 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). Should be the OS name here.
    143 Value: full path name of the file describing non-ambiguously that distribution. There should be a bijection between the file and the distribution name.
    144 Conffile: pb
    145 Example: osrelfile fedora = /etc/fedora-release
     140 Nature: Mandatory
     141 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). Should be the OS name here.
     142 Value: full path name of the file describing non-ambiguously that distribution. There should be a bijection between the file and the distribution name.
     143 Conffile: pb
     144 Example: osrelfile fedora = /etc/fedora-release
    146145
    147146=item B<osremovedotinver>
    148147
    149 Nature: Optional
    150 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    151 Value: true|false. If true, then no '.' (dot) character is kept in the version name of that OS.
    152 Conffile: pb
    153 Example: osremovedotinver redhat = true
     148 Nature: Optional
     149 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     150 Value: true|false. If true, then no '.' (dot) character is kept in the version name of that OS.
     151 Conffile: pb
     152 Example: osremovedotinver redhat = true
    154153
    155154=item B<ossuffix>
    156155
    157 Nature: Optional
    158 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
    159 Value: suffix that will be used in the name of the packages created. By default, concatenation of OS name and version.
    160 Conffile: pb
    161 Example: ossuffix mandriva = mdv
     156 Nature: Optional
     157 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch).
     158 Value: suffix that will be used in the name of the packages created. By default, concatenation of OS name and version.
     159 Conffile: pb
     160 Example: ossuffix mandriva = mdv
    162161
    163162=item B<ostype>
    164163
    165 Nature: Mandatory
    166 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.
    167 Value: build type grouping packages family. This is used internaly by pb to make various handling depending on that build type.
    168 Conffile: pb
    169 Example: ostype rh = rpm, ostype md = rpm, ostype novell = rpm
     164 Nature: Mandatory
     165 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.
     166 Value: build type grouping packages family. This is used internaly by pb to make various handling depending on that build type.
     167 Conffile: pb
     168 Example: ostype rh = rpm, ostype md = rpm, ostype novell = rpm
    170169
    171170=item B<osupd>
    172171
    173 Nature: Optional
    174 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.
    175 Value: OS command to lauch in order to automatically install packages on it.
    176 Conffile: pb
    177 Example: ostype rh = rpm, ostype md = rpm, ostype novell = rpm
     172 Nature: Optional
     173 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.
     174 Value: OS command to lauch in order to automatically install packages on it.
     175 Conffile: pb
     176 Example: ostype rh = rpm, ostype md = rpm, ostype novell = rpm
    178177
    179178=item B<pbconfurl>
    180179
    181 Nature: Mandatory
    182 Key: project (as defined in the -p option or PBPROJ environment variable)
    183 Value: B<pb URL> giving access to where the pb configuration dir is stored. Under that directory you have the same tree infrastructure as the upstream project, and under the pb packaging infra, including the project configuration file. Cf: man
    184 Conffile: home|project
    185 Example: pbconfurl fossology = svn+ssh://user@svn.project-builder.org/mondo/svn/pb/projects/fossology/pbconf, cvs+ssh://:ext:user@linuxcoe.cvs.sourceforge.net:/cvsroot/linuxcoe/pbconf
     180 Nature: Mandatory
     181 Key: project (as defined in the -p option or PBPROJ environment variable)
     182 Value: B<pb URL> giving access to where the pb configuration dir is stored. Under that directory you have the same tree infrastructure as the upstream project, and under the pb packaging infra, including the project configuration file. Cf: man
     183 Conffile: home|project
     184 Example: pbconfurl fossology = svn+ssh://user@svn.project-builder.org/mondo/svn/pb/projects/fossology/pbconf, cvs+ssh://:ext:user@linuxcoe.cvs.sourceforge.net:/cvsroot/linuxcoe/pbconf
    186185
    187186=item B<pbdefdir>
    188187
    189 Nature: Optional
    190 Key: project (as defined in the -p option or PBPROJ environment variable)
    191 Value: local directory under which every pb related operation will take place. if not defined then /var/cache. A default value is highly interesting here. If you want to use VMs/VEs, then use $ENV{'HOME'} to make it portable to it.
    192 Conffile: home
    193 Example: pbdefdir default = $ENV{'HOME'}/local/pb/projects
     188 Nature: Optional
     189 Key: project (as defined in the -p option or PBPROJ environment variable)
     190 Value: local directory under which every pb related operation will take place. if not defined then /var/cache. A default value is highly interesting here. If you want to use VMs/VEs, then use $ENV{'HOME'} to make it portable to it.
     191 Conffile: home
     192 Example: pbdefdir default = $ENV{'HOME'}/local/pb/projects
    194193
    195194=item B<pbml>
    196195
    197 Nature: Optional (Mandatory if using announce command)
    198 Key: project (as defined in the -p option or PBPROJ environment variable)
    199 Value: white space separated list of e-mail adresses used to send announces with the pb announce option.
    200 Conffile: project
    201 Example: pbml pb = pb-announce@project-builder.org pb-devel@project-builder.org
     196 Nature: Optional (Mandatory if using announce command)
     197 Key: project (as defined in the -p option or PBPROJ environment variable)
     198 Value: white space separated list of e-mail adresses used to send announces with the pb announce option.
     199 Conffile: project
     200 Example: pbml pb = pb-announce@project-builder.org pb-devel@project-builder.org
    202201
    203202=item B<pbpackager>
    204203
    205 Nature: Mandatory
    206 Key: project (as defined in the -p option or PBPROJ environment variable)
    207 Value: Firstname Name and e-mail address of the person packaging the software.
    208 Conffile: project
    209 Example: pbpackager pb = Bruno Cornec <bruno@project-builder.org>
     204 Nature: Mandatory
     205 Key: project (as defined in the -p option or PBPROJ environment variable)
     206 Value: Firstname Name and e-mail address of the person packaging the software.
     207 Conffile: project
     208 Example: pbpackager pb = Bruno Cornec <bruno@project-builder.org>
    210209
    211210=item B<pbprojdir>
    212211
    213 Nature: Optional
    214 Key: project (as defined in the -p option or PBPROJ environment variable)
    215 Value: local directory under which the project is locally exported. NB: a default value is highly interesting here. By default pbdefdir/projectname
    216 Conffile: home
    217 Example: pbprojdir mondorescue = $ENV{'HOME'}/local/mondorescue
     212 Nature: Optional
     213 Key: project (as defined in the -p option or PBPROJ environment variable)
     214 Value: local directory under which the project is locally exported. NB: a default value is highly interesting here. By default pbdefdir/projectname
     215 Conffile: home
     216 Example: pbprojdir mondorescue = $ENV{'HOME'}/local/mondorescue
    218217
    219218=item B<pbrepo>
    220219
    221 Nature: Mandatory
    222 Key: project (as defined in the -p option or PBPROJ environment variable)
    223 Value: URL of the server hosting the upstream tar file.
    224 Conffile: project
    225 Example: pbrepo mondorescue = ftp://ftp.mondorescue.org
     220 Nature: Mandatory
     221 Key: project (as defined in the -p option or PBPROJ environment variable)
     222 Value: URL of the server hosting the upstream tar file.
     223 Conffile: project
     224 Example: pbrepo mondorescue = ftp://ftp.mondorescue.org
    226225
    227226=item B<pbsmtp>
    228227
    229 Nature: Optional (Mandatory if using the announce command)
    230 Key: project (as defined in the -p option or PBPROJ environment variable)
    231 Value: FQDN of the mail server to use to send announces. NB: a default value is highly interesting here.
    232 Conffile: home
    233 Example: pbsmtp mondorescue = localhost
     228 Nature: Optional (Mandatory if using the announce command)
     229 Key: project (as defined in the -p option or PBPROJ environment variable)
     230 Value: FQDN of the mail server to use to send announces. NB: a default value is highly interesting here.
     231 Conffile: home
     232 Example: pbsmtp mondorescue = localhost
    234233
    235234=item B<pbsockscmd>
    236235
    237 Nature: Optional
    238 Key: project (as defined in the -p option or PBPROJ environment variable)
    239 Value: name of the command to use to socksify network calls. NB: a default value is highly interesting here.
    240 Conffile: home
    241 Example: pbsockscmd default = tsocks
     236 Nature: Optional
     237 Key: project (as defined in the -p option or PBPROJ environment variable)
     238 Value: name of the command to use to socksify network calls. NB: a default value is highly interesting here.
     239 Conffile: home
     240 Example: pbsockscmd default = tsocks
    242241
    243242=item B<pburl>
    244243
    245 Nature: Optional
    246 Key: project (as defined in the -p option or PBPROJ environment variable)
    247 Value: B<pb URL> giving access to where the project is stored. Normaly provided by the project, but could be overloaded for specific authentication information in the home configuration file or when using a DVCS
    248 Conffile: home|project
    249 Example: pburl linuxcoe = cvs+ssh://:ext:user@linuxcoe.cvs.sourceforge.net:/cvsroot/linuxcoe, pburl pb = svk:////local/pb
     244 Nature: Optional
     245 Key: project (as defined in the -p option or PBPROJ environment variable)
     246 Value: B<pb URL> giving access to where the project is stored. Normaly provided by the project, but could be overloaded for specific authentication information in the home configuration file or when using a DVCS
     247 Conffile: home|project
     248 Example: pburl linuxcoe = cvs+ssh://:ext:user@linuxcoe.cvs.sourceforge.net:/cvsroot/linuxcoe, pburl pb = svk:////local/pb
    250249
    251250=item B<pbwf>
    252251
    253 Nature: Optional
    254 Key: project (as defined in the -p option or PBPROJ environment variable)
    255 Value: whatever. As soon as this is defined, then that project is known as not well formed (have a subdirectory in its tar file under which all sources are put named project-version). This should be reported upstream to the project. tar files generated by project-builder to not suffer from that. This is valid when packaging for tar files and not CMS.
    256 Conffile: project
    257 Example: pbwf afio = 1
     252 Nature: Optional
     253 Key: project (as defined in the -p option or PBPROJ environment variable)
     254 Value: whatever. As soon as this is defined, then that project is known as not well formed (have a subdirectory in its tar file under which all sources are put named project-version). This should be reported upstream to the project. tar files generated by project-builder to not suffer from that. This is valid when packaging for tar files and not CMS.
     255 Conffile: project
     256 Example: pbwf afio = 1
    258257
    259258=item B<pkgtag>
    260259
    261 Nature: Optional
    262 Key: package (as provided in defpkgdir or extpkgdir)
    263 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).
    264 Conffile: project
    265 Example: pkgtag mindi-busybox = 2
     260 Nature: Optional
     261 Key: package (as provided in defpkgdir or extpkgdir)
     262 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).
     263 Conffile: project
     264 Example: pkgtag mindi-busybox = 2
    266265
    267266=item B<pkgver>
    268267
    269 Nature: Optional
    270 Key: package (as provided in defpkgdir or extpkgdir)
    271 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>.
    272 Conffile: project
    273 Example: pkgver mindi-busybox = 1.7.3
     268 Nature: Optional
     269 Key: package (as provided in defpkgdir or extpkgdir)
     270 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>.
     271 Conffile: project
     272 Example: pkgver mindi-busybox = 1.7.3
    274273
    275274=item B<projtag>
    276275
    277 Nature: Mandatory
    278 Key: project (as defined in the -p option or PBPROJ environment variable)
    279 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>.
    280 Conffile: project
    281 Example: projtag mondorescue = 1
     276 Nature: Mandatory
     277 Key: project (as defined in the -p option or PBPROJ environment variable)
     278 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>.
     279 Conffile: project
     280 Example: projtag mondorescue = 1
    282281
    283282=item B<projver>
    284283
    285 Nature: Mandatory
    286 Key: project (as defined in the -p option or PBPROJ environment variable)
    287 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>.
    288 Conffile: project
    289 Example: projver mondorescue = 2.2.9
     284 Nature: Mandatory
     285 Key: project (as defined in the -p option or PBPROJ environment variable)
     286 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>.
     287 Conffile: project
     288 Example: projver mondorescue = 2.2.9
    290289
    291290=item B<rbsconf>
    292291
    293 Nature: Optional
    294 Key: project (as defined in the -p option or PBPROJ environment variable)
    295 Value: for mock it's the configuration directory. For rinse it's its configuration file. For rpmbootstrap it's not used yet.
    296 Conffile: ve
    297 Example: rbsconf default = /etc/mock, rbsconf default = /etc/pb/pb-rinse.conf
     292 Nature: Optional
     293 Key: project (as defined in the -p option or PBPROJ environment variable)
     294 Value: for mock it's the configuration directory. For rinse it's its configuration file. For rpmbootstrap it's not used yet.
     295 Conffile: ve
     296 Example: rbsconf default = /etc/mock, rbsconf default = /etc/pb/pb-rinse.conf
    298297
    299298=item B<rbsb4pi>
    300299
    301 Nature: Optional
    302 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.
    303 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.
    304 Conffile: ve
    305 Example: rbsb4pi centos = /home/rinse/bin/before-post-install.sh
     300 Nature: Optional
     301 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.
     302 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.
     303 Conffile: ve
     304 Example: rbsb4pi centos = /home/rinse/bin/before-post-install.sh
    306305
    307306=item B<rbspi>
    308307
    309 Nature: Optional
    310 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.
    311 Value: for mock it's not used. For rinse it's the script to call after doing installation for customization. For rpmbootstrap it's the script to call after doing installation for customization.
    312 Conffile: ve
    313 Example: pbrpi centos = /home/rinse/bin/post-install.sh
     308 Nature: Optional
     309 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.
     310 Value: for mock it's not used. For rinse it's the script to call after doing installation for customization. For rpmbootstrap it's the script to call after doing installation for customization.
     311 Conffile: ve
     312 Example: pbrpi centos = /home/rinse/bin/post-install.sh
    314313
    315314=item B<supfiles>
    … …  
    319318=item B<testver>
    320319
    321 Nature: Optional
    322 Key: project (as defined in the -p option or PBPROJ environment variable)
    323 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.
    324 Conffile: project
    325 Example: testver mondorescue = true
     320 Nature: Optional
     321 Key: project (as defined in the -p option or PBPROJ environment variable)
     322 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.
     323 Conffile: project
     324 Example: testver mondorescue = true
    326325
    327326=item B<vedebtype>
    328327
    329 Nature: Mandatory
    330 Key: project (as defined in the -p option or PBPROJ environment variable)
    331 Value: debootstrap (no other tool to create deb distro based chroot)
    332 Conffile: ve
    333 Example: vedebtype default = debootstrap
     328 Nature: Mandatory
     329 Key: project (as defined in the -p option or PBPROJ environment variable)
     330 Value: debootstrap (no other tool to create deb distro based chroot)
     331 Conffile: ve
     332 Example: vedebtype default = debootstrap
    334333
    335334=item B<velist>
    336335
    337 Nature: Mandatory
    338 Key: project (as defined in the -p option or PBPROJ environment variable)
    339 Value: list of coma separated OS (under the form of os-ver-arch).
    340 Conffile: ve
    341 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
     336 Nature: Mandatory
     337 Key: project (as defined in the -p option or PBPROJ environment variable)
     338 Value: list of coma separated OS (under the form of os-ver-arch).
     339 Conffile: ve
     340 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
    342341
    343342=item B<velogin>
    344343
    345 Nature: Mandatory
    346 Key: project (as defined in the -p option or PBPROJ environment variable)
    347 Value: account name to use in the VE to build packages.
    348 Conffile: ve
    349 Example: velogin default = pb
     344 Nature: Mandatory
     345 Key: project (as defined in the -p option or PBPROJ environment variable)
     346 Value: account name to use in the VE to build packages.
     347 Conffile: ve
     348 Example: velogin default = pb
    350349
    351350=item B<vemindep>
    352351
    353 Nature: Optional
    354 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value per OS family is interesting here.
    355 Value: coma separated list of packages needed before pb can be run in the VE. Installed automatically in setupve phase.
    356 Conffile: ve
    357 Example: vemindep rpm = rpm-build,diffutils,ntpdate, vemindep deb = diff
     352 Nature: Optional
     353 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value per OS family is interesting here.
     354 Value: coma separated list of packages needed before pb can be run in the VE. Installed automatically in setupve phase.
     355 Conffile: ve
     356 Example: vemindep rpm = rpm-build,diffutils,ntpdate, vemindep deb = diff
    358357
    359358=item B<ventp>
    360359
    361 Nature: Optional
    362 Key: project (as defined in the -p option or PBPROJ environment variable)
    363 Value: NTP server to contact for time accuracy with B<ventpcmd> before building.
    364 Conffile: ve
    365 Example: ventp default = 1.pool.ntp.org
     360 Nature: Optional
     361 Key: project (as defined in the -p option or PBPROJ environment variable)
     362 Value: NTP server to contact for time accuracy with B<ventpcmd> before building.
     363 Conffile: ve
     364 Example: ventp default = 1.pool.ntp.org
    366365
    367366=item B<ventpcmd>
    368367
    369 Nature: Optional
    370 Key: project (as defined in the -p option or PBPROJ environment variable)
    371 Value: NTP command to use to perform time synchronization with the B<ventp> server.
    372 Conffile: ve
    373 Example: ventpcmd default = /usr/sbin/ntpdate
     368 Nature: Optional
     369 Key: project (as defined in the -p option or PBPROJ environment variable)
     370 Value: NTP command to use to perform time synchronization with the B<ventp> server.
     371 Conffile: ve
     372 Example: ventpcmd default = /usr/sbin/ntpdate
    374373
    375374=item B<vepath>
    376375
    377 Nature: Mandatory
    378 Key: project (as defined in the -p option or PBPROJ environment variable)
    379 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.
    380 Conffile: ve
    381 Example: vepath default = /home/rpmbootstrap
     376 Nature: Mandatory
     377 Key: project (as defined in the -p option or PBPROJ environment variable)
     378 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.
     379 Conffile: ve
     380 Example: vepath default = /home/rpmbootstrap
    382381
    383382=item B<verebuild>
    384383
    385 Nature: Optional
    386 Key: project (as defined in the -p option or PBPROJ environment variable)
    387 Value: true|false. True means that the VE should be rebuild before usage.
    388 Conffile: ve
    389 Example: ventpcmd default = /usr/sbin/ntpdate
     384 Nature: Optional
     385 Key: project (as defined in the -p option or PBPROJ environment variable)
     386 Value: true|false. True means that the VE should be rebuild before usage.
     387 Conffile: ve
     388 Example: ventpcmd default = /usr/sbin/ntpdate
    390389
    391390=item B<verpmtype>
    392391
    393 Nature: Mandatory
    394 Key: project (as defined in the -p option or PBPROJ environment variable)
    395 Value: rpmbootstrap|rinse|mock (different tools to create a chroot environment for RPM based distributions. rpmbootstrap comes with pb. the 2 others are separate projects).
    396 Conffile: ve
    397 Example: verpmtype default = rpmbootstrap
     392 Nature: Mandatory
     393 Key: project (as defined in the -p option or PBPROJ environment variable)
     394 Value: rpmbootstrap|rinse|mock (different tools to create a chroot environment for RPM based distributions. rpmbootstrap comes with pb. the 2 others are separate projects).
     395 Conffile: ve
     396 Example: verpmtype default = rpmbootstrap
    398397
    399398=item B<vesnap>
    400399
    401 Nature: Optional
    402 Key: project (as defined in the -p option or PBPROJ environment variable)
    403 Value: true|false. True means that the snapshot of the VE should be used before call to the VE. This snapshot consists of a compressed tar pf the VE. Which means that you will always start from a known state, resulting of a former snapshot operation on the VE. Also speeds up a lot the VM launch operation.
    404 Conffile: ve
    405 Example: vesnap default = true
     400 Nature: Optional
     401 Key: project (as defined in the -p option or PBPROJ environment variable)
     402 Value: true|false. True means that the snapshot of the VE should be used before call to the VE. This snapshot consists of a compressed tar pf the VE. Which means that you will always start from a known state, resulting of a former snapshot operation on the VE. Also speeds up a lot the VM launch operation.
     403 Conffile: ve
     404 Example: vesnap default = true
    406405
    407406=item B<vetype>
    408407
    409 Nature: Mandatory
    410 Key: project (as defined in the -p option or PBPROJ environment variable)
    411 Value: chroot|schroot. There are two different ways of launching a chroot activity in pb. For the moment only chroot has been tested.
    412 Conffile: ve
    413 Example: vertype default = chroot
     408 Nature: Mandatory
     409 Key: project (as defined in the -p option or PBPROJ environment variable)
     410 Value: chroot|schroot. There are two different ways of launching a chroot activity in pb. For the moment only chroot has been tested.
     411 Conffile: ve
     412 Example: vertype default = chroot
    414413
    415414=item B<vmhost>
    416415
    417 Nature: Mandatory
    418 Key: project (as defined in the -p option or PBPROJ environment variable)
    419 Value: hostname to connect to in order to reach the VM through ssh. Generally redirected from a port on localhost.
    420 Conffile: vm
    421 Example: vmhost default = localhost
     416 Nature: Mandatory
     417 Key: project (as defined in the -p option or PBPROJ environment variable)
     418 Value: hostname to connect to in order to reach the VM through ssh. Generally redirected from a port on localhost.
     419 Conffile: vm
     420 Example: vmhost default = localhost
    422421
    423422=item B<vmlist>
    424423
    425 Nature: Mandatory
    426 Key: project (as defined in the -p option or PBPROJ environment variable)
    427 Value: list of coma separated OS (under the form of os-ver-arch).
    428 Conffile: vm
    429 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
     424 Nature: Mandatory
     425 Key: project (as defined in the -p option or PBPROJ environment variable)
     426 Value: list of coma separated OS (under the form of os-ver-arch).
     427 Conffile: vm
     428 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
    430429
    431430=item B<vmlogin>
    432431
    433 Nature: Mandatory
    434 Key: project (as defined in the -p option or PBPROJ environment variable)
    435 Value: account name to use in the VM to build packages. Communication is done with ssh.
    436 Conffile: vm
    437 Example: vmlogin default = pb
     432 Nature: Mandatory
     433 Key: project (as defined in the -p option or PBPROJ environment variable)
     434 Value: account name to use in the VM to build packages. Communication is done with ssh.
     435 Conffile: vm
     436 Example: vmlogin default = pb
    438437
    439438=item B<vmmonport>
    440439
    441 Nature: Optional
    442 Key: project (as defined in the -p option or PBPROJ environment variable)
    443 Value: TCP port that is used to dialog with the monitor of the VM, to pass orders such as snapshot. Not really operational yet.
    444 Conffile: vm
    445 Example: vmmonport default = 4444
     440 Nature: Optional
     441 Key: project (as defined in the -p option or PBPROJ environment variable)
     442 Value: TCP port that is used to dialog with the monitor of the VM, to pass orders such as snapshot. Not really operational yet.
     443 Conffile: vm
     444 Example: vmmonport default = 4444
    446445
    447446=item B<vmntp>
    448447
    449 Nature: Optional
    450 Key: project (as defined in the -p option or PBPROJ environment variable)
    451 Value: NTP server to contact for time accuracy with B<vmntpcmd> before building.
    452 Conffile: vm
    453 Example: vmntp default = 1.pool.ntp.org
     448 Nature: Optional
     449 Key: project (as defined in the -p option or PBPROJ environment variable)
     450 Value: NTP server to contact for time accuracy with B<vmntpcmd> before building.
     451 Conffile: vm
     452 Example: vmntp default = 1.pool.ntp.org
    454453
    455454=item B<vmntpcmd>
    456455
    457 Nature: Optional
    458 Key: project (as defined in the -p option or PBPROJ environment variable)
    459 Value: NTP command to use to perform time synchronization with the B<vmntp> server.
    460 Conffile: vm
    461 Example: vmntpcmd default = /usr/sbin/ntpdate,vmntpcmd opensuse-11.0-i386 = sntp -P no -r
     456 Nature: Optional
     457 Key: project (as defined in the -p option or PBPROJ environment variable)
     458 Value: NTP command to use to perform time synchronization with the B<vmntp> server.
     459 Conffile: vm
     460 Example: vmntpcmd default = /usr/sbin/ntpdate,vmntpcmd opensuse-11.0-i386 = sntp -P no -r
    462461
    463462=item B<vmopt>
    464463
    465 Nature: Optional
    466 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
    467 Value: list of options to pass to the VM manager command launcher for that distribution. Another way to pass options to the VM manager command launcher is by using the PBVMOPT environment variable, which comes in addition to his option.
    468 Conffile: vm
    469 Example: vmopt default = -m 384 -daemonize,vmopt mandriva-2009.0-i386 = -m 256 -daemonize -no-kvm
     464 Nature: Optional
     465 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
     466 Value: list of options to pass to the VM manager command launcher for that distribution. Another way to pass options to the VM manager command launcher is by using the PBVMOPT environment variable, which comes in addition to his option.
     467 Conffile: vm
     468 Example: vmopt default = -m 384 -daemonize,vmopt mandriva-2009.0-i386 = -m 256 -daemonize -no-kvm
    470469
    471470=item B<vmpath>
    472471
    473 Nature: Mandatory
    474 Key: project (as defined in the -p option or PBPROJ environment variable)
    475 Value: path where to find VMs. They will be created and used under that path. For each VM os-ver-arch, it will create a os-ver-arch.qemu file below that point.
    476 Conffile: vm
    477 Example: vmpath default = /home/qemu
     472 Nature: Mandatory
     473 Key: project (as defined in the -p option or PBPROJ environment variable)
     474 Value: path where to find VMs. They will be created and used under that path. For each VM os-ver-arch, it will create a os-ver-arch.qemu file below that point.
     475 Conffile: vm
     476 Example: vmpath default = /home/qemu
    478477
    479478=item B<vmport>
    480479
    481 Nature: Mandatory
    482 Key: project (as defined in the -p option or PBPROJ environment variable)
    483 Value: port number to use to communicate with the VM using the SSH protocol. This localport is redirected to the port 22 of the VM.
    484 Conffile: vm
    485 Example: vmport pb = 2222,vmport mondorescue = 2223
     480 Nature: Mandatory
     481 Key: project (as defined in the -p option or PBPROJ environment variable)
     482 Value: port number to use to communicate with the VM using the SSH protocol. This localport is redirected to the port 22 of the VM.
     483 Conffile: vm
     484 Example: vmport pb = 2222,vmport mondorescue = 2223
    486485
    487486=item B<vmsize>
    488487
    489 Nature: Mandatory
    490 Key: project (as defined in the -p option or PBPROJ environment variable)
    491 Value: Size of the VM to create when using the newvm command of pb.
    492 Conffile: vm
    493 Example: vmsize default = 7G
     488 Nature: Mandatory
     489 Key: project (as defined in the -p option or PBPROJ environment variable)
     490 Value: Size of the VM to create when using the newvm command of pb.
     491 Conffile: vm
     492 Example: vmsize default = 7G
    494493
    495494=item B<vmsnap>
    496495
    497 Nature: Optional
    498 Key: project (as defined in the -p option or PBPROJ environment variable)
    499 Value: true|false. True means that the snapshot of the VM called pb should be used. Which means that you will always start from a known state, resulting of a former snapshot operation on the VM. Also speeds up a lot the VM launch operation.
    500 Conffile: vm
    501 Example: vmsnap default = true
     496 Nature: Optional
     497 Key: project (as defined in the -p option or PBPROJ environment variable)
     498 Value: true|false. True means that the snapshot of the VM called pb should be used. Which means that you will always start from a known state, resulting of a former snapshot operation on the VM. Also speeds up a lot the VM launch operation.
     499 Conffile: vm
     500 Example: vmsnap default = true
    502501
    503502=item B<vmtmout>
    504503
    505 Nature: Optional
    506 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
    507 Value: Time in seconds to way beofre interacting with the VM. This should corresponds to the time the VM takes to boot.
    508 Conffile: vm
    509 Example: vmtmout default = 180,vmtmout mandriva-2009.0-x86_64 = 500
     504 Nature: Optional
     505 Key: OS (could be from the most generic up to the most specific from ostype, osfamily, os, os-ver, os-ver-arch). NB: a default value is highly interesting here.
     506 Value: Time in seconds to way beofre interacting with the VM. This should corresponds to the time the VM takes to boot.
     507 Conffile: vm
     508 Example: vmtmout default = 180,vmtmout mandriva-2009.0-x86_64 = 500
    510509
    511510=item B<vmtype>
    512511
    513 Nature: Mandatory
    514 Key: project (as defined in the -p option or PBPROJ environment variable)
    515 Value: qemu|kvm. For the moment, only QEMU or KVM are supported as virtualization technologies.
    516 Conffile: vm
    517 Example: vmrtype default = kvm
     512 Nature: Mandatory
     513 Key: project (as defined in the -p option or PBPROJ environment variable)
     514 Value: qemu|kvm. For the moment, only QEMU or KVM are supported as virtualization technologies.
     515 Conffile: vm
     516 Example: vmrtype default = kvm
    518517
    519518=item B<webdir>
    520519
    521 Nature: Optional
    522 Key: project (as defined in the -p option or PBPROJ environment variable)
    523 Value: Target directory containing the web content in the project that should be delivered when using the web2ssh command of pb.
    524 Conffile: project
    525 Example: webdir mondorescue = website
     520 Nature: Optional
     521 Key: project (as defined in the -p option or PBPROJ environment variable)
     522 Value: Target directory containing the web content in the project that should be delivered when using the web2ssh command of pb.
     523 Conffile: project
     524 Example: webdir mondorescue = website
    526525
    527526=item B<pb URL>
    528527=item B<pb directory desc>
    529528=item B<pb environment variables>
     529
     530=back

  • devel/pb/bin/pb

    r988 r989  
    29282928sub pb_get_postinstall {
    29292929
    2930 my $ddir = shift
    2931 my $dver = shift
    2932 my $darch = shift
    2933 my $rbspi = shift
    2934 my $vestyle = shift
     2930my $ddir = shift;
     2931my $dver = shift;
     2932my $darch = shift;
     2933my $rbspi = shift;
     2934my $vestyle = shift;
    29352935my $post = "";
    29362936
    … …  
    29422942}
    29432943
    2944 $postparam = pb_distro_get_param($ddir,$dver,$darch,$rbspi);
     2944my $postparam = pb_distro_get_param($ddir,$dver,$darch,$rbspi);
    29452945if ($postparam eq "") {
    29462946    $post = "";
Note: See TracChangeset for help on using the changeset viewer.