This page describes how to package open source software for OmniOS. The current system largely resembles other source-based packaging systems like FreeBSD ports, pkgsrc, or Gentoo portage. The user writes a few metadata files in plain text, and these serve as a driver for the system to create the package.
The build system consists of a collection of shell scripts and associated metadata files which the shell scripts read to produce packages.
To find out more about the Image Packaging System, please see the More Info page. In particular the Developer’s Guide explains the key concepts in IPS that you’ll need to successfully create and maintain packages for OmniOS.
The package metadata lives in a git repository, accessible at
build directory contains the package-specific metadata, with
template containing various templates for common projects and
lib housing various shell functions used by the system.
is used to create a directory
new.sh script with the name of the package you want to
create for OmniOS. For example:
$ ./new.sh example
This will create an entry
build/example with the following layout:
build/example/ build/example/build.sh build/example/patches
build.sh script is pretty basic; here are the uncommented
. ../../lib/functions.sh PROG=myapp # App name VER= # App version VERHUMAN=$VER # Human-readable version PKG= # Package name (e.g. library/foo) SUMMARY="" # One-liner, must be filled in DESC="" # Longer description, must be filled in init download_source $PROG $PROG $VER patch_source prep_build build make_isa_stub make_package clean_up
Most things here should be self-explanatory. The PKG variable should be set to the category and name of the package, but not include a publisher name. See GeneralAdministration#FMRIFormat for details on package names. VERHUMAN preserves the upstream version in case it contains something other than numbers and dots. The package author may need to code up a conversion scheme so that VER conforms to IPS format. The value of VERHUMAN will be placed in the pkg.human-version key in the package, which is displayed in parentheses following the IPS component version in the output of ‘pkg info’, e.g.:
$ pkg info openssl Name: library/security/openssl Summary: openssl - A toolkit for Secure Sockets Layer (SSL v2/v3) and Transport Layer (TLS v1) protocols and general purpose cryptographic library State: Installed Publisher: omnios Version: 188.8.131.52 (1.0.1e) Build Release: 5.11 Branch: 0.151006 Packaging Date: May 6, 2013 06:54:19 PM Size: 18.00 MB FMRI: pkg://firstname.lastname@example.org,5.11-0.151006:20130506T185419Z
Useful configuration options:
$MIRRORis defined in
lib/config.shand defines the base URL from which the package will be downloaded.
download_source $PROG $PROG $VERtries to download from
$MIRROR/$PROG/$PROG-$VER.*. There is a 4th argument to
download_sourcethat specifies where to build the package
lib/site.shconfigure where the package gets published. See CreatingRepos for info on creating a repo
Most items there are self-explanatory and in general shouldn’t be changed for the usual case.
Given all of this, it should be fairly simple to build basic packages.
Shell variables set in build.sh will be available to the build process,
so things like
$CFLAGS work as expected.
Best practice is to provide a
local.mog file along with the
for licensing. Its format is the following:
license $LICENSE_FILE license=$LICENSE_NAME
This helps inform users about the legal terms of using the packaged software.
In the event of problems,
build.sh leaves a log file,
This should make any problems immediately evident, though solving them
is left as an exercise for the reader. ;)