Creating packages for LRP is as simple as creating a tar file and gzipping it. The only necessities for LRP are some special files, located in /var/lib/lrpkg/:
pkgname.list
— List of files contained in the package, relative to
/ — these paths must be relative
to / (root).
pkgname.version
— Version of the software package (in the format
version-release).
pkgname.help
— Help file for the software package.
pkgname.exclude
— List of files to never include in the package or any
other package — these files might include spool files, temporary files, and
files that get created every time the software starts.
pkgname.conf
— A list of configuration files used by the package. Each entry can contain
a comment after the filename but on the same line. This file is used by the
configuration utilities found in LRP and LEAF systems.
Oxygen adds several files that enhance the LRP package format:
pkgname.md5
— List of md5 checksums for all files in the package.
pkgname.sh
— Possible future expansion for startup and shutdown scripts.
pkgname.desc
— Description file which contains lots of data about the package.
In most cases, the only file required for a standard package is
pkgname.list — but the original LRP backup
utility had problems if a file did not include
pkgname.help or
pkgname.version. Oxygen comes with an
alternative backup utility (apkg) which has no such problems.
A basic Korn shell script might explain further:
#!/bin/ksh PKGDIR=/var/lib/lrpkg BASE=/pub/devel PKGFILE=$BASE/$PKGDIR/$1.list LRPFILE=$BASE/$1.lrp if [ ! -f $PKGFILE ]; then echo "Package file $PKGFILE missing!" exit 1 fi tar cvf - $(cat $PKGFILE) | gzip -9 -c - > $LRPFILE && \ echo "Package created: $(basename $LRPFILE)"
A variant of this shell script would work under LRP; however, it is easier to place the actual files into the LRP system and use the standard utilities to back up the package when using LRP.
This assumes that the correct files (as listed above) have been created in /var/lib/lrpkg for the package.
To create an add-on package — that is, a package which contains programs to become part of the base LRP system — create a package which contains no files in /var/lib/lrpkg. The stock LRP package load system (lrpkg) may or may not handle an add-on package file correctly, but apkg (included with Oxygen) will handle this correctly and will give a warning, saying that this package will be absorbed into other packages.
Oxygen will also give a warning if any add-on packages are added
during the boot process, with a message similar to this one:
Installing packages - local etc usr log libx(abs!) - done
In this case, libx will be absorbed into other packages (presumably root.lrp, as part of /lib) if nothing is done.
Description files are an Oxygen extension to the package format; these
are in pkg.desc files and have a specific
format. An example:
# This is a description file <pkg>.desc # # These comments should be ignored; in fact, any line # that does not match a known keyword should be ignored; # but don't tell anyone I said that.... :-) Name: upx Version: 1.20 Release: 1 Packager: David Douthitt <[email protected]> Packaged: Wed Jul 18 09:40:25 CDT 2001 Keywords: compressor compress Description: Use UPX to compress executables and kernels! URL: http://upx.sourceforge.net/ License: GPL2 Group: Utilities/Compression