michael@428: .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
michael@428: .\"
michael@428: .\" Standard preamble:
michael@428: .\" ========================================================================
michael@428: .de Sp \" Vertical space (when we can't use .PP)
michael@428: .if t .sp .5v
michael@428: .if n .sp
michael@428: ..
michael@428: .de Vb \" Begin verbatim text
michael@428: .ft CW
michael@428: .nf
michael@428: .ne \\$1
michael@428: ..
michael@428: .de Ve \" End verbatim text
michael@428: .ft R
michael@428: .fi
michael@428: ..
michael@428: .\" Set up some character translations and predefined strings.  \*(-- will
michael@428: .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
michael@428: .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
michael@428: .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
michael@428: .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
michael@428: .\" nothing in troff, for use with C<>.
michael@428: .tr \(*W-
michael@428: .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
michael@428: .ie n \{\
michael@428: .    ds -- \(*W-
michael@428: .    ds PI pi
michael@428: .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
michael@428: .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
michael@428: .    ds L" ""
michael@428: .    ds R" ""
michael@428: .    ds C` 
michael@428: .    ds C' 
michael@428: 'br\}
michael@428: .el\{\
michael@428: .    ds -- \|\(em\|
michael@428: .    ds PI \(*p
michael@428: .    ds L" ``
michael@428: .    ds R" ''
michael@428: 'br\}
michael@428: .\"
michael@428: .\" Escape single quotes in literal strings from groff's Unicode transform.
michael@428: .ie \n(.g .ds Aq \(aq
michael@428: .el       .ds Aq '
michael@428: .\"
michael@428: .\" If the F register is turned on, we'll generate index entries on stderr for
michael@428: .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
michael@428: .\" entries marked with X<> in POD.  Of course, you'll have to process the
michael@428: .\" output yourself in some meaningful fashion.
michael@428: .ie \nF \{\
michael@428: .    de IX
michael@428: .    tm Index:\\$1\t\\n%\t"\\$2"
michael@428: ..
michael@428: .    nr % 0
michael@428: .    rr F
michael@428: .\}
michael@428: .el \{\
michael@428: .    de IX
michael@428: ..
michael@428: .\}
michael@428: .\"
michael@428: .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
michael@428: .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
michael@428: .    \" fudge factors for nroff and troff
michael@428: .if n \{\
michael@428: .    ds #H 0
michael@428: .    ds #V .8m
michael@428: .    ds #F .3m
michael@428: .    ds #[ \f1
michael@428: .    ds #] \fP
michael@428: .\}
michael@428: .if t \{\
michael@428: .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
michael@428: .    ds #V .6m
michael@428: .    ds #F 0
michael@428: .    ds #[ \&
michael@428: .    ds #] \&
michael@428: .\}
michael@428: .    \" simple accents for nroff and troff
michael@428: .if n \{\
michael@428: .    ds ' \&
michael@428: .    ds ` \&
michael@428: .    ds ^ \&
michael@428: .    ds , \&
michael@428: .    ds ~ ~
michael@428: .    ds /
michael@428: .\}
michael@428: .if t \{\
michael@428: .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
michael@428: .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
michael@428: .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
michael@428: .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
michael@428: .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
michael@428: .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
michael@428: .\}
michael@428: .    \" troff and (daisy-wheel) nroff accents
michael@428: .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
michael@428: .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
michael@428: .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
michael@428: .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
michael@428: .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
michael@428: .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
michael@428: .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
michael@428: .ds ae a\h'-(\w'a'u*4/10)'e
michael@428: .ds Ae A\h'-(\w'A'u*4/10)'E
michael@428: .    \" corrections for vroff
michael@428: .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
michael@428: .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
michael@428: .    \" for low resolution devices (crt and lpr)
michael@428: .if \n(.H>23 .if \n(.V>19 \
michael@428: \{\
michael@428: .    ds : e
michael@428: .    ds 8 ss
michael@428: .    ds o a
michael@428: .    ds d- d\h'-1'\(ga
michael@428: .    ds D- D\h'-1'\(hy
michael@428: .    ds th \o'bp'
michael@428: .    ds Th \o'LP'
michael@428: .    ds ae ae
michael@428: .    ds Ae AE
michael@428: .\}
michael@428: .rm #[ #] #H #V #F C
michael@428: .\" ========================================================================
michael@428: .\"
michael@428: .IX Title "MAKEPROXY 8"
michael@428: .TH MAKEPROXY 8 "OpenPKG" "MAKEPROXY(8)" "OpenPKG"
michael@428: .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
michael@428: .\" way too many mistakes in technical documents.
michael@428: .if n .ad l
michael@428: .nh
michael@428: .SH "NAME"
michael@428: openpkg makeproxy \-\- Make Proxy OpenPKG RPM Package
michael@428: .SH "SYNOPSIS"
michael@428: .IX Header "SYNOPSIS"
michael@428: \&\fBopenpkg makeproxy\fR
michael@428: [\fB\-h\fR|\fB\-\-help\fR]
michael@428: [\fB\-V\fR|\fB\-\-version\fR]
michael@428: [\fB\-d\fR|\fB\-\-debug\fR]
michael@428: [\fB\-v\fR|\fB\-\-verbose\fR]
michael@428: [\fB\-m\fR|\fB\-\-master\fR \fImaster-prefix\fR]
michael@428: [\fB\-s\fR|\fB\-\-slave\fR \fIslave-prefix\fR]
michael@428: [\fB\-t\fR|\fB\-\-tmpdir\fR \fIdirectory\fR]
michael@428: [\fB\-o\fR|\fB\-\-output\fR \fIdirectory\fR|\fIslave-package-file\fR|\f(CW\*(C`\-\*(C'\fR]
michael@428: [\fImaster-package-name\fR|\fImaster-package-file\fR|\f(CW\*(C`\-\*(C'\fR]
michael@428: .SH "DESCRIPTION"
michael@428: .IX Header "DESCRIPTION"
michael@428: \&\fBopenpkg makeproxy\fR creates a \fIproxy\fR binary \fBOpenPKG\fR \s-1RPM\s0 package
michael@428: for a \fIslave\fR \fBOpenPKG\fR instance by emulating a regular binary
michael@428: \&\fBOpenPKG\fR \s-1RPM\s0 package from a \fImaster\fR \fBOpenPKG\fR instance.
michael@428: .PP
michael@428: A proxy package contains (virtually) the same contents as the regular
michael@428: package, but in the form of a shadow tree. Such a shadow tree consists
michael@428: of the same physical directory structure but with all files replaced by
michael@428: symbolic links pointing to the regular files in the master \fBOpenPKG\fR
michael@428: instance.
michael@428: .PP
michael@428: A proxy package is useful if multiple closely related \fBOpenPKG\fR
michael@428: instances are installed on the same system. In this case lots of
michael@428: dependent (and this way required, although not explicitly wanted)
michael@428: packages have to be installed in \fIevery\fR \fBOpenPKG\fR instance. Think
michael@428: about packages like \fBopenssl\fR, \fBperl\fR, \fBgcc\fR, etc. This can be both
michael@428: very time-consuming and become a maintenance nightmare on upgrades.
michael@428: Instead, you can select a master \fBOpenPKG\fR instance, install those
michael@428: regular packages physically there only and install simple proxy packages
michael@428: for them in all other slave \fBOpenPKG\fR instances.
michael@428: .PP
michael@428: Keep in mind that this obviously works correctly for packages which
michael@428: do \fInot\fR have hard-coded dependencies to their \fBOpenPKG\fR instance
michael@428: (configuration files, etc). For other packages it might also work,
michael@428: but be at least be warned about side-effects! Additionally, make sure
michael@428: you always keep proxy packages in sync with the regular package by
michael@428: recreating the proxy packages after the regular packages have changed.
michael@428: .SH "SHADOW TREE"
michael@428: .IX Header "SHADOW TREE"
michael@428: The shadow tree of a proxy package \fBname\fR contain the following three
michael@428: types of paths:
michael@428: .IP "\fIslave-prefix\fR[/\fIdir\fR]" 4
michael@428: .IX Item "slave-prefix[/dir]"
michael@428: This is a physical directory for the slave \fBOpenPKG\fR instance, exactly
michael@428: as it exists in the regular package of the master \fBOpenPKG\fR instance.
michael@428: .ie n .IP "\fIslave-prefix\fR[/\fIdir\fR]/\fIfile\fR \-> \fIrevdir\fR\*(C`/.prefix\-\*(C'\fBfoo\fR[/\fIdir\fR]/\fIfile\fR" 4
michael@428: .el .IP "\fIslave-prefix\fR[/\fIdir\fR]/\fIfile\fR \-> \fIrevdir\fR\f(CW\*(C`/.prefix\-\*(C'\fR\fBfoo\fR[/\fIdir\fR]/\fIfile\fR" 4
michael@428: .IX Item "slave-prefix[/dir]/file -> revdir/.prefix-foo[/dir]/file"
michael@428: This is a virtual file (symbolic link) for the slave \fBOpenPKG\fR
michael@428: instance, indirectly pointing to the corresponding file of the regular
michael@428: package in the master \fBOpenPKG\fR instance. The \fIrevdir\fR is a reverse
michael@428: path corresponding to \fIdir\fR, i.e., for each sub-directory step in
michael@428: \&\fIdir\fR it contains a "\f(CW\*(C`../\*(C'\fR" parent directory step.
michael@428: .ie n .IP "\fIslave-prefix\fR\*(C`/.prefix\-\*(C'\fBfoo\fR \-> \fImaster-prefix\fR" 4
michael@428: .el .IP "\fIslave-prefix\fR\f(CW\*(C`/.prefix\-\*(C'\fR\fBfoo\fR \-> \fImaster-prefix\fR" 4
michael@428: .IX Item "slave-prefix/.prefix-foo -> master-prefix"
michael@428: This is a virtual file (symbolic link) for the slave \fBOpenPKG\fR
michael@428: instance, directly pointing to the prefix of the master \fBOpenPKG\fR
michael@428: instance. This allows one to redirect a whole package to
michael@428: a different \fBOpenPKG\fR instance by manually changing the
michael@428: \&\fIslave-prefix\fR\f(CW\*(C`/.prefix\-\*(C'\fR\fBfoo\fR symbolic link. The idea is that this
michael@428: link even could be automatically controlled by a higher-level facility.
michael@428: .SH "OPTIONS"
michael@428: .IX Header "OPTIONS"
michael@428: The following command line options and arguments are supported:
michael@428: .IP "\fB\-h\fR, \fB\-\-help\fR" 4
michael@428: .IX Item "-h, --help"
michael@428: Print the usage message and immediately exit.
michael@428: .IP "\fB\-V\fR, \fB\-\-version\fR" 4
michael@428: .IX Item "-V, --version"
michael@428: Print program version.
michael@428: .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
michael@428: .IX Item "-v, --verbose"
michael@428: Enable printing of verbose messages on \fIstderr\fR summarizing the internal processing.
michael@428: .IP "\fB\-d\fR, \fB\-\-debug\fR" 4
michael@428: .IX Item "-d, --debug"
michael@428: Enable printing of debug messages on \fIstderr\fR showing the executed shell commands.
michael@428: .IP "\fB\-m\fR, \fB\-\-master\fR \fImaster-prefix\fR" 4
michael@428: .IX Item "-m, --master master-prefix"
michael@428: Set the filesystem path prefix of the \fImaster\fR \fBOpenPKG\fR instance.
michael@428: If not specified, the prefix is determined from the master package.
michael@428: .IP "\fB\-s\fR, \fB\-\-slave\fR \fIslave-prefix\fR" 4
michael@428: .IX Item "-s, --slave slave-prefix"
michael@428: Set the filesystem path prefix of the \fIslave\fR \fBOpenPKG\fR instance.
michael@428: If not specified, the prefix defaults to the prefix of
michael@428: the \fBOpenPKG\fR instance the \f(CW\*(C`openpkg makeproxy\*(C'\fR command is run from.
michael@428: .IP "\fB\-t\fR, \fB\-\-tmpdir\fR \fIdirectory\fR" 4
michael@428: .IX Item "-t, --tmpdir directory"
michael@428: Set a particular temporary directory. The default is \f(CW$TMPDIR\fR or
michael@428: \&\f(CW\*(C`/tmp\*(C'\fR (in that order).
michael@428: .ie n .IP "\fB\-o\fR, \fB\-\-output\fR \fIdirectory\fR|\fIslave-package-file\fR|\*(C`\-\*(C'" 4
michael@428: .el .IP "\fB\-o\fR, \fB\-\-output\fR \fIdirectory\fR|\fIslave-package-file\fR|\f(CW\*(C`\-\*(C'\fR" 4
michael@428: .IX Item "-o, --output directory|slave-package-file|-"
michael@428: Set the location where to write the output proxy \s-1RPM\s0 package for the
michael@428: slave \fBOpenPKG\fR instance. The argument "\f(CW\*(C`\-\*(C'\fR" indicates that the output
michael@428: proxy \s-1RPM\s0 package is written to \fIstdout\fR. The default is "\f(CW\*(C`.\*(C'\fR" (the
michael@428: current working directory). If the output location is a directory and
michael@428: the regular \s-1RPM\s0 package of the master \fBOpenPKG\fR instance is named
michael@428: "\fIname\fR\f(CW\*(C`\-\*(C'\fR\fIversion\fR\f(CW\*(C`\-\*(C'\fR\fIrelease\fR\f(CW\*(C`.\*(C'\fR\fIarch\fR\f(CW\*(C`\-\*(C'\fR\fIos\fR\f(CW\*(C`\-\*(C'\fR\fItag1\fR\f(CW\*(C`.rp
michael@428: m\*(C'\fR\*(L", then the output proxy \s-1RPM\s0 package is named
michael@428: \&\*(R"\fIname\fR\f(CW\*(C`\-\*(C'\fR\fIversion\fR\f(CW\*(C`\-\*(C'\fR\fIrelease\fR\f(CW\*(C`+PROXY\*(C'\fR\f(CW\*(C`.\*(C'\fR\fIarch\fR\f(CW\*(C`\-\*(C'\fR\fIos\fR\f(CW\*(C`\-\*(C'\fR\fIt
michael@428: ag2\fR\f(CW\*(C`.rpm\*(C'\fR" in the output directory (\fItag1\fR and \fItag2\fR are the tags
michael@428: of the master and slave \fBOpenPKG\fR instances).
michael@428: .ie n .IP "\fImaster-package-file\fR|\*(C`\-\*(C'" 4
michael@428: .el .IP "\fImaster-package-file\fR|\f(CW\*(C`\-\*(C'\fR" 4
michael@428: .IX Item "master-package-file|-"
michael@428: Set the location where to read the input regular \s-1RPM\s0 package. The
michael@428: special argument "\f(CW\*(C`\-\*(C'\fR" indicates that the input regular \s-1RPM\s0 package is
michael@428: read from \fIstdin\fR (the default).
michael@428: .SH "EXAMPLE"
michael@428: .IX Header "EXAMPLE"
michael@428: Assume you have three \fBOpenPKG\fR instances on a system: \f(CW\*(C`/usr/opkg\*(C'\fR
michael@428: (the master instance), \f(CW\*(C`/v/foo/sw\*(C'\fR (a project instance) and \f(CW\*(C`/v/bar/sw\*(C'\fR
michael@428: (another project instance). Now let us install the \fBOpenPKG\fR \fBbash\fR package in
michael@428: all three locations, but only once physically.
michael@428: .PP
michael@428: .Vb 5
michael@428: \& # build and install regular binary RPM package for /usr/opkg
michael@428: \& $ /usr/opkg/bin/openpkg rpm \-\-rebuild \e
michael@428: \&    bash\-3.1.17\-20060622.src.rpm
michael@428: \& $ /usr/opkg/bin/openpkg rpm \-Uvh \e
michael@428: \&   /usr/opkg/RPM/PKG/bash\-3.1.17\-20060622.*.rpm
michael@428: \&
michael@428: \& # build and install proxy RPM package for /v/foo/sw
michael@428: \& # (using the regular binary RPM package of /usr/opkg)
michael@428: \& $ /v/foo/sw/bin/openpkg makeproxy \-\-output=/v/foo/RPM/PKG/ \e
michael@428: \&   /usr/opkg/RPM/PKG/bash\-3.1.17\-20060622.*.rpm
michael@428: \& $ /v/foo/sw/bin/openpkg rpm \-Uvh \e
michael@428: \&   /v/foo/RPM/PKG/bash\-3.1.17\-20060622+PROXY.*.rpm
michael@428: \&
michael@428: \& # build and install proxy RPM package for /v/bar/sw
michael@428: \& # (using the installed package of /usr/opkg)
michael@428: \& $ /v/bar/sw/bin/openpkg makeproxy \-\-output=/v/bar/RPM/PKG/ \e
michael@428: \&   \-\-master=/usr/opkg bash
michael@428: \& $ /v/bar/sw/bin/openpkg rpm \-Uvh \e
michael@428: \&   /v/bar/RPM/PKG/bash\-3.1.17\-20060622+PROXY.*.rpm
michael@428: .Ve
michael@428: .SH "SEE ALSO"
michael@428: .IX Header "SEE ALSO"
michael@428: \&\fBOpenPKG\fR http://www.openpkg.org/,
michael@428: \&\fBopenpkg rpm\fR, \fIln\fR\|(1).
michael@428: .SH "HISTORY"
michael@428: .IX Header "HISTORY"
michael@428: \&\fBopenpkg makeproxy\fR was developed in February 2002 by Ralf S.
michael@428: Engelschall <rse@engelschall.com> for the \fBOpenPKG\fR
michael@428: project after an idea for virtual packages by Thomas Lotterer
michael@428: <thomas@lotterer.net>. The implementation was completely
michael@428: worked off in August 2006.
michael@428: .SH "AUTHOR"
michael@428: .IX Header "AUTHOR"
michael@428: .Vb 3
michael@428: \& Ralf S. Engelschall
michael@428: \& rse@engelschall.com
michael@428: \& www.engelschall.com
michael@428: .Ve