|
|
@@ -1,384 +0,0 @@
|
|
|
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
|
|
|
-.\"
|
|
|
-.\" Standard preamble:
|
|
|
-.\" ========================================================================
|
|
|
-.de Sh \" Subsection heading
|
|
|
-.br
|
|
|
-.if t .Sp
|
|
|
-.ne 5
|
|
|
-.PP
|
|
|
-\fB\\$1\fR
|
|
|
-.PP
|
|
|
-..
|
|
|
-.de Sp \" Vertical space (when we can't use .PP)
|
|
|
-.if t .sp .5v
|
|
|
-.if n .sp
|
|
|
-..
|
|
|
-.de Vb \" Begin verbatim text
|
|
|
-.ft CW
|
|
|
-.nf
|
|
|
-.ne \\$1
|
|
|
-..
|
|
|
-.de Ve \" End verbatim text
|
|
|
-.ft R
|
|
|
-.fi
|
|
|
-..
|
|
|
-.\" Set up some character translations and predefined strings. \*(-- will
|
|
|
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
|
-.\" double quote, and \*(R" will give a right double quote. | will give a
|
|
|
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
|
|
|
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
|
|
|
-.\" expand to `' in nroff, nothing in troff, for use with C<>.
|
|
|
-.tr \(*W-|\(bv\*(Tr
|
|
|
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
|
-.ie n \{\
|
|
|
-. ds -- \(*W-
|
|
|
-. ds PI pi
|
|
|
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
|
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
|
-. ds L" ""
|
|
|
-. ds R" ""
|
|
|
-. ds C`
|
|
|
-. ds C'
|
|
|
-'br\}
|
|
|
-.el\{\
|
|
|
-. ds -- \|\(em\|
|
|
|
-. ds PI \(*p
|
|
|
-. ds L" ``
|
|
|
-. ds R" ''
|
|
|
-'br\}
|
|
|
-.\"
|
|
|
-.\" If the F register is turned on, we'll generate index entries on stderr for
|
|
|
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
|
|
|
-.\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
|
-.\" output yourself in some meaningful fashion.
|
|
|
-.if \nF \{\
|
|
|
-. de IX
|
|
|
-. tm Index:\\$1\t\\n%\t"\\$2"
|
|
|
-..
|
|
|
-. nr % 0
|
|
|
-. rr F
|
|
|
-.\}
|
|
|
-.\"
|
|
|
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
|
-.\" way too many mistakes in technical documents.
|
|
|
-.hy 0
|
|
|
-.if n .na
|
|
|
-.\"
|
|
|
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
|
-.\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
|
-. \" fudge factors for nroff and troff
|
|
|
-.if n \{\
|
|
|
-. ds #H 0
|
|
|
-. ds #V .8m
|
|
|
-. ds #F .3m
|
|
|
-. ds #[ \f1
|
|
|
-. ds #] \fP
|
|
|
-.\}
|
|
|
-.if t \{\
|
|
|
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
|
|
-. ds #V .6m
|
|
|
-. ds #F 0
|
|
|
-. ds #[ \&
|
|
|
-. ds #] \&
|
|
|
-.\}
|
|
|
-. \" simple accents for nroff and troff
|
|
|
-.if n \{\
|
|
|
-. ds ' \&
|
|
|
-. ds ` \&
|
|
|
-. ds ^ \&
|
|
|
-. ds , \&
|
|
|
-. ds ~ ~
|
|
|
-. ds /
|
|
|
-.\}
|
|
|
-.if t \{\
|
|
|
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
|
|
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
|
|
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
|
|
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
|
|
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
|
|
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
|
|
-.\}
|
|
|
-. \" troff and (daisy-wheel) nroff accents
|
|
|
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
|
|
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
|
|
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
|
|
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
|
|
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
|
|
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
|
|
|
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
|
|
-.ds ae a\h'-(\w'a'u*4/10)'e
|
|
|
-.ds Ae A\h'-(\w'A'u*4/10)'E
|
|
|
-. \" corrections for vroff
|
|
|
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
|
|
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
|
|
-. \" for low resolution devices (crt and lpr)
|
|
|
-.if \n(.H>23 .if \n(.V>19 \
|
|
|
-\{\
|
|
|
-. ds : e
|
|
|
-. ds 8 ss
|
|
|
-. ds o a
|
|
|
-. ds d- d\h'-1'\(ga
|
|
|
-. ds D- D\h'-1'\(hy
|
|
|
-. ds th \o'bp'
|
|
|
-. ds Th \o'LP'
|
|
|
-. ds ae ae
|
|
|
-. ds Ae AE
|
|
|
-.\}
|
|
|
-.rm #[ #] #H #V #F C
|
|
|
-.\" ========================================================================
|
|
|
-.\"
|
|
|
-.IX Title "OPENPKG-BUILD 1"
|
|
|
-.TH OPENPKG-BUILD 1 "2004-02-17" "openpkg-build" "OpenPKG Maintenance"
|
|
|
-.SH "NAME"
|
|
|
-\&\fBopenpkg build\fR \- \fBOpenPKG\fR Maintenance Tool (Building)
|
|
|
-.SH "VERSION"
|
|
|
-.IX Header "VERSION"
|
|
|
-openpkg build XX-VERSION-XX
|
|
|
-.SH "SYNOPSIS"
|
|
|
-.IX Header "SYNOPSIS"
|
|
|
-\&\fBopenpkg\fR
|
|
|
-\&\fBbuild\fR
|
|
|
-[\fB\-R\fR \fIrpm\fR]
|
|
|
-[\fB\-r\fR \fIrepository\fR]
|
|
|
-[\fB\-f\fR \fIindex.rdf\fR]
|
|
|
-[\fB\-u\fR]
|
|
|
-[\fB\-U\fR]
|
|
|
-[\fB\-z\fR]
|
|
|
-[\fB\-Z\fR]
|
|
|
-[\fB\-i\fR]
|
|
|
-[\fB\-q\fR]
|
|
|
-[\fB\-s\fR]
|
|
|
-[\fB\-S\fR]
|
|
|
-[\fB\-M\fR]
|
|
|
-[\fB\-L\fR]
|
|
|
-[\fB\-W\fR]
|
|
|
-[\fB\-X\fR]
|
|
|
-[\fB\-K\fR]
|
|
|
-[\fB\-e\fR]
|
|
|
-[\fB\-b\fR]
|
|
|
-[\fB\-B\fR]
|
|
|
-[\fB\-G\fR]
|
|
|
-[\fB\-P\fR \fIpriv-cmd\fR]
|
|
|
-[\fB\-N\fR \fInon-priv-cmd\fR]
|
|
|
-[\fB\-p\fR \fIplatform\fR]
|
|
|
-[\fB\-D\fR\fIvar\fR=\fIval\fR ...]
|
|
|
-[\fB\-E\fR \fIname\fR ...]
|
|
|
-[\fB\-H\fR \fIname\fR ...]
|
|
|
-([\fB\-a\fR] [\fB\-A\fR] | \fIpatternlist\fR)
|
|
|
-.SH "DESCRIPTION"
|
|
|
-.IX Header "DESCRIPTION"
|
|
|
-The \fBopenpkg build\fR tool provides automated recursive from-scratch
|
|
|
-installation and updating of existing \s-1RPM\s0 packages (\fBopenpkg build\fR).
|
|
|
-It writes a shell script to standard output that installs or upgrades
|
|
|
-software packages including all dependencies. Packages that are upgraded
|
|
|
-automatically trigger rebuilds of all packages that depend on the
|
|
|
-upgraded package (\*(L"reverse dependencies\*(R"). The dependency information is
|
|
|
-read from an index generated by \fBopenpkg index\fR.
|
|
|
-.PP
|
|
|
-Packages are selected by providing a list of name patterns. Each
|
|
|
-pattern is either a package name or a prefix followed by a '*'
|
|
|
-character. Additionally you can append a discrimination prefix separated
|
|
|
-by a comma that matches against the full name-version-revision
|
|
|
-string.
|
|
|
-.SH "OPTIONS"
|
|
|
-.IX Header "OPTIONS"
|
|
|
-The following command line options exist:
|
|
|
-.IP "\fB\-R\fR \fIrpm\fR" 4
|
|
|
-.IX Item "-R rpm"
|
|
|
-Specify a path to the installed \fBOpenPKG\fR \f(CW\*(C`rpm\*(C'\fR command. Several
|
|
|
-other internal paths are deduced from the \fIrpm\fR path, so this should be
|
|
|
-something like "\fI%{l_prefix}\fR\f(CW\*(C`/bin/openpkg rpm\*(C'\fR".
|
|
|
-.IP "\fB\-r\fR \fIrepository\fR" 4
|
|
|
-.IX Item "-r repository"
|
|
|
-Specify a path to an \s-1RPM\s0 repository, this can be a \s-1URL\s0 or a directory
|
|
|
-path. The name of the package file is appended to this path.
|
|
|
-The default is to use a \s-1URL\s0 pointing to the \fBOpenPKG\fR \s-1FTP\s0 server.
|
|
|
-.IP "\fB\-f\fR \fIindex.rdf\fR" 4
|
|
|
-.IX Item "-f index.rdf"
|
|
|
-Specify a path to the primary \s-1XML/RDF\s0 index, this can be a \s-1URL\s0 or a
|
|
|
-file path. If the index contains references to other indexes these are
|
|
|
-included automatically. The default is to use a \s-1URL\s0 pointing to the
|
|
|
-\&\fBOpenPKG\fR \s-1FTP\s0 server for the \fBOpenPKG\fR release you are using.
|
|
|
-.IP "\fB\-u\fR" 4
|
|
|
-.IX Item "-u"
|
|
|
-The generated script will ignore binary RPMs that are stored on
|
|
|
-your system. Instead it will either fetch binary RPMs or rebuild
|
|
|
-from source RPMs fetched from the repository.
|
|
|
-.IP "\fB\-U\fR" 4
|
|
|
-.IX Item "-U"
|
|
|
-The generated script will try to upgrade all selected packages
|
|
|
-including their dependencies to the most recent version.
|
|
|
-.IP "\fB\-z\fR" 4
|
|
|
-.IX Item "-z"
|
|
|
-The generated script will rebuild all selected packages
|
|
|
-including their dependencies even when the most recent version
|
|
|
-is already installed.
|
|
|
-.IP "\fB\-Z\fR" 4
|
|
|
-.IX Item "-Z"
|
|
|
-\&\fBopenpkg build\fR ignores all installed packages, the
|
|
|
-script will rebuild all selected packages from scratch.
|
|
|
-Note that this doesn't work together with the \fB\-a\fR option.
|
|
|
-.IP "\fB\-i\fR" 4
|
|
|
-.IX Item "-i"
|
|
|
-The generated script will ignore errors. However, if a build
|
|
|
-phase fails the install phase is still skipped.
|
|
|
-.IP "\fB\-q\fR" 4
|
|
|
-.IX Item "-q"
|
|
|
-Ignore all reverse dependencies.
|
|
|
-\&\fI\s-1ATTENTION:\s0 this might break already installed packages!\fR
|
|
|
-.IP "\fB\-s\fR" 4
|
|
|
-.IX Item "-s"
|
|
|
-Print a status map instead of the install script. The map consists
|
|
|
-of 3 columns: \*(L"old\*(R", \*(L"tag\*(R" and \*(L"new\*(R". \*(L"old\*(R" shows the installed
|
|
|
-version of a package or just the package name if no package of
|
|
|
-that name is installed and \*(L"new\*(R" shows the repository version
|
|
|
-of a package if it is considered for installation. \*(L"tag\*(R" has the
|
|
|
-following possible values:
|
|
|
-.RS 4
|
|
|
-.IP "\s-1OK\s0" 4
|
|
|
-.IX Item "OK"
|
|
|
-The installed package is suitable and will not be touched.
|
|
|
-.IP "\s-1ADD\s0" 4
|
|
|
-.IX Item "ADD"
|
|
|
-There is no installed package yet.
|
|
|
-.IP "\s-1UPGRADE\s0" 4
|
|
|
-.IX Item "UPGRADE"
|
|
|
-The installed package is outdated and requires an update.
|
|
|
-.IP "\s-1DEPEND\s0" 4
|
|
|
-.IX Item "DEPEND"
|
|
|
-The installed package needs rebuilding because one of its
|
|
|
-dependencies is rebuilt.
|
|
|
-.IP "\s-1MISMATCH\s0" 4
|
|
|
-.IX Item "MISMATCH"
|
|
|
-The installed package needs rebuilding because it was build
|
|
|
-with different parameters.
|
|
|
-.IP "\s-1CONFLICT\s0" 4
|
|
|
-.IX Item "CONFLICT"
|
|
|
-The required new package cannot be installed because it
|
|
|
-conflicts with some already installed package.
|
|
|
-.IP "\s-1UNDEF\s0" 4
|
|
|
-.IX Item "UNDEF"
|
|
|
-The package has an invalid or ambiguous dependency.
|
|
|
-.RE
|
|
|
-.RS 4
|
|
|
-.RE
|
|
|
-.IP "\fB\-S\fR" 4
|
|
|
-.IX Item "-S"
|
|
|
-Similar to \fB\-s\fR but also lists the newest versions in the
|
|
|
-repository. The following tag might appear in the map.
|
|
|
-.RS 4
|
|
|
-.IP "\s-1NEW\s0" 4
|
|
|
-.IX Item "NEW"
|
|
|
-The package exists in the repository but isn't required yet.
|
|
|
-.RE
|
|
|
-.RS 4
|
|
|
-.RE
|
|
|
-.IP "\fB\-M\fR" 4
|
|
|
-.IX Item "-M"
|
|
|
-Similar to \fB\-s\fR but print a short dependency map.
|
|
|
-.IP "\fB\-L\fR" 4
|
|
|
-.IX Item "-L"
|
|
|
-Print a list of packages in the repository that depend on the target.
|
|
|
-.IP "\fB\-W\fR" 4
|
|
|
-.IX Item "-W"
|
|
|
-Include all conditional dependencies as if all possible configuration
|
|
|
-options had been switched on. This has little use except for generating
|
|
|
-an all-inclusive list with the \fB\-L\fR option.
|
|
|
-\&\fI\s-1ATTENTION:\s0 Even mutually exclusive options are evaluated to be 'on',
|
|
|
-building packages with \f(BI\-W\fI therefore might fail or cause unusable
|
|
|
-results!\fR
|
|
|
-.IP "\fB\-X\fR" 4
|
|
|
-.IX Item "-X"
|
|
|
-Ignore an installed \s-1XML\s0 parser module but use the internal
|
|
|
-simple text parser instead.
|
|
|
-.IP "\fB\-K\fR" 4
|
|
|
-.IX Item "-K"
|
|
|
-Keep packages that were installed temporarily during the build process.
|
|
|
-.IP "\fB\-e\fR" 4
|
|
|
-.IX Item "-e"
|
|
|
-Rebuild exact version from repository even when you have installed
|
|
|
-a newer version from another repository.
|
|
|
-.IP "\fB\-b\fR" 4
|
|
|
-.IX Item "-b"
|
|
|
-Wrap rebuild commands with build-time check for existing binary packages
|
|
|
-if the package is rebuilt as a dependency. This is best to use with
|
|
|
-\&\fB\-u\fR to defer all such checks until build\-time.
|
|
|
-.IP "\fB\-B\fR" 4
|
|
|
-.IX Item "-B"
|
|
|
-Same as \-b but also check all packages for existing binary packages
|
|
|
-at run\-time.
|
|
|
-.IP "\fB\-g\fR" 4
|
|
|
-.IX Item "-g"
|
|
|
-The generated script will rebuild all packages selected even when the
|
|
|
-most recent version is already installed. Dependencies are not affected.
|
|
|
-.IP "\fB\-P\fR \fIpriv-cmd\fR" 4
|
|
|
-.IX Item "-P priv-cmd"
|
|
|
-Command prefix to use for install commands that require elevated
|
|
|
-privileges. The most common tool for this is \fIsudo\fR\|(8). If \fIpriv-cmd\fR
|
|
|
-starts with a dash it will be run without the dash and the command
|
|
|
-line it should execute is passed as a single quoted string.
|
|
|
-.IP "\fB\-N\fR \fInon-priv-cmd\fR" 4
|
|
|
-.IX Item "-N non-priv-cmd"
|
|
|
-Command prefix to use for install commands that do not require elevated
|
|
|
-privileges. The most common tool for this is \fIsudo\fR\|(8). If \fIpriv-cmd\fR
|
|
|
-starts with a dash it will be run without the dash and the command
|
|
|
-line it should execute is passed as a single quoted string.
|
|
|
-.IP "\fB\-p\fR \fIplatform\fR" 4
|
|
|
-.IX Item "-p platform"
|
|
|
-The platform string that is matched against the index for binary
|
|
|
-packages. Default is an empty string so that no binary packages
|
|
|
-are matched.
|
|
|
-.IP "\fB\-D\fR\fIvar\fR=\fIval\fR" 4
|
|
|
-.IX Item "-Dvar=val"
|
|
|
-Specify configuration options for selected packages. This can be
|
|
|
-either \fB\-D\fR\fIwith_xxx\fR=\fIyyy\fR or just \fB\-D\fR\fIwith_xxx\fR, the
|
|
|
-latter is equivalent to a \fB\-D\fR\fIwith_xxx\fR=\fIyes\fR. The parameters
|
|
|
-are matched against selected packages that are already installed. If
|
|
|
-they do indicate a change, the package is rebuild. There can be multiple
|
|
|
-\&\fB\-D\fR options.
|
|
|
-.Sp
|
|
|
-If the option name is prefixed with a package name followed by two colons
|
|
|
-then it applies only to the specified package. E.g. \fB\-D\fR\fIgcc::with_binutils\fR.
|
|
|
-.IP "\fB\-E\fR \fIname\fR" 4
|
|
|
-.IX Item "-E name"
|
|
|
-Ignore a package with the specified \fIname\fR. This can be used to avoid
|
|
|
-upgrading to a broken package in the repository. There can be multiple
|
|
|
-\&\fB\-E\fR options.
|
|
|
-.IP "\fB\-H\fR \fIname\fR" 4
|
|
|
-.IX Item "-H name"
|
|
|
-Hint about packages that should be preferred when more than one fits
|
|
|
-a requirement. There can be multiple \fB\-E\fR options.
|
|
|
-.IP "\fB\-a\fR" 4
|
|
|
-.IX Item "-a"
|
|
|
-Select all installed packages. Do not specify a pattern list together
|
|
|
-with the \fB\-a\fR option.
|
|
|
-.IP "\fB\-A\fR" 4
|
|
|
-.IX Item "-A"
|
|
|
-Select all packages in the repository. Do not specify a pattern list together
|
|
|
-with the \fB\-A\fR option.
|
|
|
-.SH "CONFIGURATION"
|
|
|
-.IX Header "CONFIGURATION"
|
|
|
-\&\fBopenpkg build\fR reads the configuration file \fI$HOME/.openpkg/build\fR.
|
|
|
-The file lists default options, one option per line and section tags
|
|
|
-of the form \f(CW\*(C`[\*(C'\fR\fIprefix\fR\f(CW\*(C`]\*(C'\fR. Options following such a tag are only
|
|
|
-evaluated if the selected \s-1RPM\s0 path matches the prefix so that you can
|
|
|
-define default options for multiple \fBOpenPKG\fR hierarchies.
|
|
|
-.SH "CAVEATS"
|
|
|
-.IX Header "CAVEATS"
|
|
|
-Parallel execution of \fBopenpkg build\fR causes undefined effects.
|
|
|
-.SH "SEE ALSO"
|
|
|
-.IX Header "SEE ALSO"
|
|
|
-\&\fIrpm\fR\|(8), \fIsudo\fR\|(8)
|
|
|
-.SH "HISTORY"
|
|
|
-.IX Header "HISTORY"
|
|
|
-The \fBopenpkg build\fR command was invented in November 2002 by \fIMichael
|
|
|
-van Elst\fR <mlelstv@dev.de.cw.net> under contract with \fICable
|
|
|
-& Wireless\fR <http://www.cw.com/> for use inside the \fBOpenPKG\fR
|
|
|
-project <http://www.openpkg.org/>.
|
|
|
-.SH "AUTHORS"
|
|
|
-.IX Header "AUTHORS"
|
|
|
-.Vb 2
|
|
|
-\& Michael van Elst
|
|
|
-\& mlelstv@dev.de.cw.net
|
|
|
-.Ve
|
