mirror of
https://github.com/void-linux/void-packages.git
synced 2025-06-07 23:53:51 +02:00
Explain some more about binpkgs and repositories.
--HG-- extra : convert_revision : 76193e4a513a216400bebbdfb69787e9405f5b20
This commit is contained in:
parent
8a35ef0945
commit
756757d034
2 changed files with 71 additions and 5 deletions
|
@ -1,5 +1,5 @@
|
||||||
A binary package built with xbps is a normal tar(1) archive, compressed
|
A binary package built with xbps is a normal tar(1) archive, compressed
|
||||||
with gzip, bzip2 or lzma and has the following structure:
|
with bzip2 and has the following structure:
|
||||||
|
|
||||||
/
|
/
|
||||||
/usr ------|
|
/usr ------|
|
||||||
|
@ -19,10 +19,29 @@ install. The props.plist file is a proplib(3) property list and
|
||||||
has the following structure:
|
has the following structure:
|
||||||
|
|
||||||
<dict>
|
<dict>
|
||||||
|
<key>pkgname</key>
|
||||||
|
<string>foo</string>
|
||||||
|
|
||||||
|
<key>version</key>
|
||||||
|
<string>3.40</string>
|
||||||
|
|
||||||
|
<key>maintainer</key>
|
||||||
|
<string>The Master BOFH <bofh@baobab.org> </string>
|
||||||
|
|
||||||
|
<key>short_desc</key>
|
||||||
|
<string>Foo is a virtual package</string>
|
||||||
|
|
||||||
|
<key>long_desc</key>
|
||||||
|
<string>
|
||||||
|
Foo is a virtual package to show how the metadata props.plist file works
|
||||||
|
with xbps handling binary packages.</string>
|
||||||
|
|
||||||
<key>architecture</key>
|
<key>architecture</key>
|
||||||
<string>x86_64</string>
|
<string>x86_64</string>
|
||||||
|
|
||||||
<key>installed_size</key>
|
<key>installed_size</key>
|
||||||
<integer>500000</integer>
|
<integer>500000</integer>
|
||||||
|
|
||||||
<key>configuration_files</key>
|
<key>configuration_files</key>
|
||||||
<array>
|
<array>
|
||||||
<string>/etc/foo.conf</string>
|
<string>/etc/foo.conf</string>
|
||||||
|
@ -31,12 +50,16 @@ has the following structure:
|
||||||
<key>run_depends</key>
|
<key>run_depends</key>
|
||||||
<array>
|
<array>
|
||||||
<string>bofh-2.0</string>
|
<string>bofh-2.0</string>
|
||||||
<string>foof-1.1</string>
|
<string>blab-1.1</string>
|
||||||
...
|
...
|
||||||
</array>
|
</array>
|
||||||
|
...
|
||||||
</dict>
|
</dict>
|
||||||
|
|
||||||
This plist might be extended in the future if it's required or useful.
|
This plist might be extended in the future; additional scripts might be
|
||||||
|
added to trigger actions at pre/post installation/removal of the
|
||||||
|
binary package.
|
||||||
|
|
||||||
Additional scripts might be added to trigger some actions at pre/post
|
The package's dictionary will also be written into the repository's package
|
||||||
installation stages.
|
index file, that describes information about a binary package on it.
|
||||||
|
See the BINPKG_REPOSITORY file for more info about repositories.
|
43
doc/BINPKG_REPOSITORY
Normal file
43
doc/BINPKG_REPOSITORY
Normal file
|
@ -0,0 +1,43 @@
|
||||||
|
A repository for binary packages contains the packages itself, and
|
||||||
|
an index file describing the information about available packages.
|
||||||
|
|
||||||
|
The structure for this file is just the same than the plist file used
|
||||||
|
to register installed packages, aka "an array of dictionaries" and
|
||||||
|
a "dictionary per package".
|
||||||
|
|
||||||
|
The package dictionary will be the same than the one available in
|
||||||
|
package's metadata directory "/var/cache/xbps/$pkgname/props.plist",
|
||||||
|
but some additional objects are added to provide enough info for
|
||||||
|
the repository itself.
|
||||||
|
|
||||||
|
Here's how the package index plist file shall look like in a repository:
|
||||||
|
|
||||||
|
<dict>
|
||||||
|
<key>xbps_available_packages</key>
|
||||||
|
<array>
|
||||||
|
<dict>
|
||||||
|
<key>pkgname</key>
|
||||||
|
<string>klibc</string>
|
||||||
|
<key>version</key>
|
||||||
|
<string>1.5.17</string>
|
||||||
|
<key>filename</key>
|
||||||
|
<string>klibc-1.5.17.x86_64.xbps</string>
|
||||||
|
<key>architecture</key>
|
||||||
|
<string>x86_64</string>
|
||||||
|
<key>installed_size</key>
|
||||||
|
<integer>9471141</integer>
|
||||||
|
<key>maintainer</key>
|
||||||
|
<string>Juan RP xtraeme@gmail.com</string>
|
||||||
|
<key>short_desc</key>
|
||||||
|
<string>Minimal libc subset for use with initramfs</key>
|
||||||
|
<key>long_desc</key>
|
||||||
|
<string>
|
||||||
|
klibc is intended to be a minimalistic libc subset for use with initramfs.
|
||||||
|
It is deliberately written for small size, minimal entanglement, and
|
||||||
|
portability, not speed. It is definitely a work in progress and a lot of
|
||||||
|
things are still missing.</string>
|
||||||
|
...
|
||||||
|
</dict>
|
||||||
|
...
|
||||||
|
</array>
|
||||||
|
</dict>
|
Loading…
Add table
Reference in a new issue