openpkg/README

changeset 791
a5b2210360f9
parent 428
f880f219c566
equal deleted inserted replaced
1:02c1eb245824 2:ccfa9b65b98a
17 patch-*.tar.gz .......... untouched distribution tarball of the GNU patch tool 17 patch-*.tar.gz .......... untouched distribution tarball of the GNU patch tool
18 bash-*.tar.gz ........... untouched distribution tarball of the GNU bash tool 18 bash-*.tar.gz ........... untouched distribution tarball of the GNU bash tool
19 make-*.tar.gz ........... untouched distribution tarball of the GNU make tool 19 make-*.tar.gz ........... untouched distribution tarball of the GNU make tool
20 tar-*.tar.gz ............ untouched distribution tarball of the GNU tar tool 20 tar-*.tar.gz ............ untouched distribution tarball of the GNU tar tool
21 config-*.tar.gz ......... untouched distribution tarball of the GNU config scripts 21 config-*.tar.gz ......... untouched distribution tarball of the GNU config scripts
22 gzip-*.tar .............. pre-unpacked distribution tarball of the GNU gzip tool 22 gzip-*.tar .............. preunpacked distribution tarball of the GNU gzip tool
23 gzip-*-openpkg-r*.tar ... pre-patched distribution files of the GNU gzip tool 23 gzip-*-openpkg-r*.tar ... prepatched distribution files of the GNU gzip tool
24 perl-*-mini.tar.gz ...... stripped down distribution tarball of the Perl tool 24 perl-*-mini.tar.gz ...... stripped down distribution tarball of the Perl tool
25 rpm-*.tar.gz ............ untouched distribution tarball of the RPM tool 25 rpm-*.tar.gz ............ untouched distribution tarball of the RPM tool
26 openssl-*.tar.gz ........ untouched distribution tarball of the OpenSSL toolkit 26 openssl-*.tar.gz ........ untouched distribution tarball of the OpenSSL toolkit
27 uuid-*.tar.gz ........... untouched distribution tarball of the OSSP uuid tool 27 uuid-*.tar.gz ........... untouched distribution tarball of the OSSP uuid tool
28 curl-*.tar.gz ........... untouched distribution tarball of the cURL tool 28 curl-*.tar.gz ........... untouched distribution tarball of the cURL tool
60 local.README ............ the source for installed <prefix>/local/README 60 local.README ............ the source for installed <prefix>/local/README
61 dot.bashrc .............. the source for installed <prefix>/.bashrc 61 dot.bashrc .............. the source for installed <prefix>/.bashrc
62 dot.bash_login .......... the source for installed <prefix>/.bash_login 62 dot.bash_login .......... the source for installed <prefix>/.bash_login
63 dot.lsyncrc ............. the source for installed <prefix>/local/.lsyncrc 63 dot.lsyncrc ............. the source for installed <prefix>/local/.lsyncrc
64 64
65 openpkg.c ............... the OpenPKG frontend (set-uid wrapper) 65 openpkg.c ............... the OpenPKG frontend (setuid wrapper)
66 openpkg.mk .............. the OpenPKG frontend (build procedure) 66 openpkg.mk .............. the OpenPKG frontend (build procedure)
67 openpkg.sh .............. the OpenPKG frontend (main script) 67 openpkg.sh .............. the OpenPKG frontend (main script)
68 openpkg.pod ............. the OpenPKG frontend manual page (source) 68 openpkg.pod ............. the OpenPKG frontend manual page (source)
69 openpkg.1 ............... the OpenPKG frontend manual page (pre-generated output) 69 openpkg.1 ............... the OpenPKG frontend manual page (pregenerated output)
70 70
71 rc ...................... the OpenPKG run-command handling script 71 rc ...................... the OpenPKG runcommand handling script
72 rc.func ................. the OpenPKG run-command function definitions 72 rc.func ................. the OpenPKG runcommand function definitions
73 rc.conf ................. the OpenPKG run-command configuration template 73 rc.conf ................. the OpenPKG runcommand configuration template
74 rc.openpkg .............. the OpenPKG run-command script for the bootstrap package 74 rc.openpkg .............. the OpenPKG runcommand script for the bootstrap package
75 rc.pod .................. the OpenPKG run-command script manual page (source) 75 rc.pod .................. the OpenPKG runcommand script manual page (source)
76 rc.8 .................... the OpenPKG run-command script manual page (pre-generated output) 76 rc.8 .................... the OpenPKG runcommand script manual page (pregenerated output)
77 77
78 release.sh .............. the OpenPKG release information utility script 78 release.sh .............. the OpenPKG release information utility script
79 release.pod ............. the OpenPKG release information utility manual page (source) 79 release.pod ............. the OpenPKG release information utility manual page (source)
80 release.8 ............... the OpenPKG release information utility manual page (pre-generated output) 80 release.8 ............... the OpenPKG release information utility manual page (pregenerated output)
81 81
82 uuid.sh ................. the OpenPKG UUID management utility script 82 uuid.sh ................. the OpenPKG UUID management utility script
83 uuid.pod ................ the OpenPKG UUID management utility manual page (source) 83 uuid.pod ................ the OpenPKG UUID management utility manual page (source)
84 uuid.8 .................. the OpenPKG UUID management utility manual page (pre-generated output) 84 uuid.8 .................. the OpenPKG UUID management utility manual page (pregenerated output)
85 85
86 rpmdb ................... the OpenPKG RPM database management utility 86 rpmdb ................... the OpenPKG RPM database management utility
87 87
88 rpmtool ................. the rpmtool tool (program source) 88 rpmtool ................. the rpmtool tool (program source)
89 rpmtool.8 ............... the rpmtool tool (manual page) 89 rpmtool.8 ............... the rpmtool tool (manual page)
90 rpmtool.pod ............. the rpmtool tool (manual page source) 90 rpmtool.pod ............. the rpmtool tool (manual page source)
91 shtool .................. the portable shell tool (GNU shtool) 91 shtool .................. the portable shell tool (GNU shtool)
92 92
93 rpm-config.sh ........... the RPM C API helper script 93 rpm-config.sh ........... the RPM C API helper script
94 rpm-config.pod .......... the RPM C API helper manual page (source) 94 rpm-config.pod .......... the RPM C API helper manual page (source)
95 rpm-config.8 ............ the RPM C API helper manual page (pre-generated output) 95 rpm-config.8 ............ the RPM C API helper manual page (pregenerated output)
96 96
97 lsync ................... the lsync tool (program source) 97 lsync ................... the lsync tool (program source)
98 lsync.8 ................. the lsync tool (manual page) 98 lsync.8 ................. the lsync tool (manual page)
99 lsync.pod ............... the lsync tool (manual page source) 99 lsync.pod ............... the lsync tool (manual page source)
100 100
108 rpm.sh .................. wrapper for RPM 108 rpm.sh .................. wrapper for RPM
109 curl.sh ................. wrapper for cURL 109 curl.sh ................. wrapper for cURL
110 110
111 dev.pl .................. the OpenPKG package development utility script 111 dev.pl .................. the OpenPKG package development utility script
112 dev.pod ................. the OpenPKG package development utility manual page (source) 112 dev.pod ................. the OpenPKG package development utility manual page (source)
113 dev.8 ................... the OpenPKG package development utility manual page (pre-generated output) 113 dev.8 ................... the OpenPKG package development utility manual page (pregenerated output)
114 114
115 index.pl ................ the OpenPKG package indexing utility script 115 index.pl ................ the OpenPKG package indexing utility script
116 index.pod ............... the OpenPKG package indexing utility manual page (source) 116 index.pod ............... the OpenPKG package indexing utility manual page (source)
117 index.8 ................. the OpenPKG package indexing utility manual page (pre-generated output) 117 index.8 ................. the OpenPKG package indexing utility manual page (pregenerated output)
118 118
119 search.pl ............... the OpenPKG package searching utility script 119 search.pl ............... the OpenPKG package searching utility script
120 search.pod .............. the OpenPKG package searching utility manual page (source) 120 search.pod .............. the OpenPKG package searching utility manual page (source)
121 search.8 ................ the OpenPKG package searching utility manual page (pre-generated output) 121 search.8 ................ the OpenPKG package searching utility manual page (pregenerated output)
122 122
123 sea.sh .................. the OpenPKG shell execution archive utility script 123 sea.sh .................. the OpenPKG shell execution archive utility script
124 sea.pod ................. the OpenPKG shell execution archive utility manual page (source) 124 sea.pod ................. the OpenPKG shell execution archive utility manual page (source)
125 sea.8 ................... the OpenPKG shell execution archive utility manual page (pre-generated output) 125 sea.8 ................... the OpenPKG shell execution archive utility manual page (pregenerated output)
126 126
127 mirror.pl ............... the OpenPKG package mirroing utility script 127 mirror.pl ............... the OpenPKG package mirroing utility script
128 mirror.pod .............. the OpenPKG package mirroing utility manual page (source) 128 mirror.pod .............. the OpenPKG package mirroing utility manual page (source)
129 mirror.8 ................ the OpenPKG package mirroing utility manual page (pre-generated output) 129 mirror.8 ................ the OpenPKG package mirroing utility manual page (pregenerated output)
130 130
131 build.pl ................ the OpenPKG package building utility script 131 build.pl ................ the OpenPKG package building utility script
132 build.pod ............... the OpenPKG package building utility manual page (source) 132 build.pod ............... the OpenPKG package building utility manual page (source)
133 build.8 ................. the OpenPKG package building utility manual page (pre-generated output) 133 build.8 ................. the OpenPKG package building utility manual page (pregenerated output)
134 134
135 makeproxy.pl ............ the OpenPKG proxy package building utility script 135 makeproxy.pl ............ the OpenPKG proxy package building utility script
136 makeproxy.pod ........... the OpenPKG proxy package building utility manual page (source) 136 makeproxy.pod ........... the OpenPKG proxy package building utility manual page (source)
137 makeproxy.8 ............. the OpenPKG proxy package building utility manual page (pre-generated output) 137 makeproxy.8 ............. the OpenPKG proxy package building utility manual page (pregenerated output)
138 138
139 openpkg.org.pgp ......... the OpenPGP public key "OpenPKG <openpkg@openpkg.org>" 139 openpkg.org.pgp ......... the OpenPGP public key "OpenPKG <openpkg@openpkg.org>"
140 openpkg.com.pgp ......... the OpenPGP public key "OpenPKG GmbH <openpkg@openpkg.com>" 140 openpkg.com.pgp ......... the OpenPGP public key "OpenPKG GmbH <openpkg@openpkg.com>"
141 openpkg.net.pgp ......... the OpenPGP public key "OpenPKG Foundation e.V. <openpkg@openpkg.net>" 141 openpkg.net.pgp ......... the OpenPGP public key "OpenPKG Foundation e.V. <openpkg@openpkg.net>"
142 142
143 license.sh .............. the OpenPKG license management utility script 143 license.sh .............. the OpenPKG license management utility script
144 license.pod ............. the OpenPKG license management utility manual page (source) 144 license.pod ............. the OpenPKG license management utility manual page (source)
145 license.8 ............... the OpenPKG license management utility manual page (pre-generated output) 145 license.8 ............... the OpenPKG license management utility manual page (pregenerated output)
146 license-BOOT.txt ........ the OpenPKG Framework Bootstrapping License 146 license-BOOT.txt ........ the OpenPKG Framework Bootstrapping License
147 license-COMMUNITY.txt ... the OpenPKG Framework Community License 147 license-COMMUNITY.txt ... the OpenPKG Framework Community License
148 license-EVAL.txt ........ the OpenPKG Framework Evaluation License 148 license-EVAL.txt ........ the OpenPKG Framework Evaluation License
149 license-EXAMPLE.txt ..... the OpenPKG Framework Example License 149 license-EXAMPLE.txt ..... the OpenPKG Framework Example License
150 license-PROMO.txt ....... the OpenPKG Framework Promotion License 150 license-PROMO.txt ....... the OpenPKG Framework Promotion License
192 rpm" command which allows the installed "openpkg rpm" command 192 rpm" command which allows the installed "openpkg rpm" command
193 inside the "build root" to work (although it is built for the 193 inside the "build root" to work (although it is built for the
194 final target filesystem path). Then the $OPENPKG_BOOT variable 194 final target filesystem path). Then the $OPENPKG_BOOT variable
195 is set and the package is _again_ build via "openpkg.spec" -- 195 is set and the package is _again_ build via "openpkg.spec" --
196 but this time with the real OpenPKG RPM. To avoid unneccessary 196 but this time with the real OpenPKG RPM. To avoid unneccessary
197 re-compilation, the "openpkg.spec" skips "%prep", "%build" and 197 recompilation, the "openpkg.spec" skips "%prep", "%build" and
198 "%install" sections if $OPENPKG_BOOT is defined. So, on this second 198 "%install" sections if $OPENPKG_BOOT is defined. So, on this second
199 build phase, only the "%files" section is effectively executed, i.e., 199 build phase, only the "%files" section is effectively executed, i.e.,
200 a binary OpenPKG RPM package "openpkg-V-R.P-T.rpm" is rolled from the 200 a binary OpenPKG RPM package "openpkg-V-R.P-T.rpm" is rolled from the
201 files in the "build root". Additionally, a source OpenPKG RPM package 201 files in the "build root". Additionally, a source OpenPKG RPM package
202 "openpkg-V-R.src.rpm" is rolled for consistency reasons, too. 202 "openpkg-V-R.src.rpm" is rolled for consistency reasons, too.
210 we could use "--prefix=$RPM_BUILD_ROOT%{l_prefix}", but this would 210 we could use "--prefix=$RPM_BUILD_ROOT%{l_prefix}", but this would
211 create an incorrect file list for the package "openpkg" in the RPM 211 create an incorrect file list for the package "openpkg" in the RPM
212 database. Instead we use the tricky "--justdb" option for "openpkg 212 database. Instead we use the tricky "--justdb" option for "openpkg
213 rpm" which means "openpkg rpm" behaves as it would install into the 213 rpm" which means "openpkg rpm" behaves as it would install into the
214 real location, but does not actually install anything. But as a 214 real location, but does not actually install anything. But as a
215 side-effect, the database inside the "build root" is now correct. 215 side effect, the database inside the "build root" is now correct.
216 216
217 After this procedure, the "build root" contains the target filesystem 217 After this procedure, the "build root" contains the target filesystem
218 hierarchy with OpenPKG RPM installed with itself. What is now just 218 hierarchy with OpenPKG RPM installed with itself. What is now just
219 remaining is to roll a bootstrap package "openpkg" with this stuff for 219 remaining is to roll a bootstrap package "openpkg" with this stuff for
220 initial installation without OpenPKG RPM. For this the "build root" 220 initial installation without OpenPKG RPM. For this the "build root"
224 "etc.wrapbin.sh" (padded to 64KB for easier unpacking of the attached 224 "etc.wrapbin.sh" (padded to 64KB for easier unpacking of the attached
225 tarball) to its front. 225 tarball) to its front.
226 226
227 The result is the binary bootstrap script "openpkg-V-R.P-T.sh" which 227 The result is the binary bootstrap script "openpkg-V-R.P-T.sh" which
228 can be used to install the target hierarchy from scratch without 228 can be used to install the target hierarchy from scratch without
229 any pre-installed OpenPKG RPM. Nevertheless, the installed target 229 any preinstalled OpenPKG RPM. Nevertheless, the installed target
230 hierarchy looks _exactly_ as it would have been installed with OpenPKG 230 hierarchy looks _exactly_ as it would have been installed with OpenPKG
231 RPM. If one later wants to upgrade this hierarchy one can just use the 231 RPM. If one later wants to upgrade this hierarchy one can just use the
232 generated (or a newer) "openpkg-V-R.P-T.rpm". 232 generated (or a newer) "openpkg-V-R.P-T.rpm".
233 233
234 To allow one to easily repeat this from-source bootstrapping procedure 234 To allow one to easily repeat this from source bootstrapping procedure
235 on other machines, one can run "./openpkg.boot -s" which rolls 235 on other machines, one can run "./openpkg.boot -s" which rolls
236 a "openpkg-V-R.src.sh" script which is a self-extracting script 236 a "openpkg-V-R.src.sh" script which is a self-extracting script
237 containing an attached tarball of the sources of this directory. This 237 containing an attached tarball of the sources of this directory. This
238 script contains the same contents like "openpkg-V-R.src.rpm", but 238 script contains the same contents like "openpkg-V-R.src.rpm", but
239 is intended for running the described bootstrapping procedure from 239 is intended for running the described bootstrapping procedure from

mercurial