This document was written in 2011 and is now just for reference. It will not be updated. The TODO is outdated, but do not change it, this would not help. See the UsersGuide to use pkgsrc, and the DevelopersGuide if you want to play with the various facets of pkgsrc and its content.
This page describes how to build packages with pkgsrc. It is intended for people who would like to help port packages and develop pkgsrc further. If you just want to install binary packages, you should read Installing Binary Packages. While this page also describes basic usage, more information can be found at pkgsrc guide.
You need a minix system installed with a post-pkgsrc .iso (a 3.1.8 development version), see the download page. This comes with pkgsrc support in the base system, and pkgin (the binary package manager) pre-installed. This is necessary to bootstrap pkgsrc functionality (e.g. building packages).
pkgsrc is self-hosting, i.e. you should need no packages from packman in order to compile or install pkgsrc packages. Instructions for checking out and building Minix trunk can be found on the Tracking Current wiki page.
If you have source-upgraded, i.e. have pkg_add, etc., installed, you can bootstrap your system to install binary packages by installing pkgin as a binary like so:
# pkg_add ftp://ftp.minix3.org/pub/minix/packages/3.1.9/i386/All/pkgin-0.3.3.1nb1.tgz
This section is about the /usr/pkgsrc source tree, needed if you want to compile or contribute packages, or patches. If you just want binary packages, see later sections.
Required for this step: git. Install it with
# pkgin in scmgit-base
To set up the pkgsrc tree:
# cd /usr # make pkgsrc-create
Note: this takes more than 400Mb of hard disk space (as of January 7th, 2011)
To update the pkgsrc tree in the future:
# cd /usr # make pkgsrc-update
All pkgsrc operations should be done with bmake.
To build a package (misc/figlet in this example) you need to cd to that directory and do a make install
# cd /usr/pkgsrc/misc/figlet # bmake install
This installs figlet in /usr/pkg
This is the recommended binary package UI. See Installing Binary Packages for more info.
Newer 3.1.8 cdrom images include pkgin pre-installed. Do a 'pkgin up' (for update) to get started.
There is a small number of binary packages that have been uploaded and can be installed with the rudimentary pkgsrc interface. From a package dir, type 'make bin-install,' like so:
# cd /usr/pkgsrc/misc/figlet # bmake bin-install ===> Binary install for figlet-2.2.2nb1 => Installing figlet-2.2.2nb1 from /usr/pkgsrc/packages/All;ftp://ftp.minix3.org/pub/minix/packages/3.1.8/i386/All figlet-2.2.2nb1: rebuilding run-time library search paths database figlet-2.2.2nb1 successfully installed.
To see which binary packages are available, see the Minix binary package repository for 3.1.8/i386.
Over 150 packages currently compile on Minix. The most complete and up to date list can be found in /usr/pkgsrc/minix/limited_list.pbulk.
Quite a few packages that compile on Minix do not build within pkgsrc as Minix specific patches are missing. We will use devel/ncurses as an example to illustrate the process of creating patches in pkgsrc format
We need to first install pkgdiff which contains the tools required to make patches in pkgsrc format.
Note 1: devel/ncurses has already been worked on.
Note 2: Compiling pkgdiff, will compile perl and gzip as dependencies, If you want to avoid this, install perl and gzip from packman
# cd pkgtools/pkgdiff # bmake install
Now extract and apply existing patches to the source
# cd /usr/pkgsrc/devel/ncurses # bmake patch
Packages are extracted and built by default in /usr/tmp/work.
# cd /usr/pkgsrc/work/devel/ncurses/work # ls ... ncurses-5.7 ...
Here you will find the extracted and patched version of ncurses. Now apply any minix specfic changes to the source code. Minix specific changes for several packages can be found in the bigports repository.
<!> Before changing a file, backup the original version with an added .orig suffix. If you use pkgvi (part of pkgdiff) to edit the file, this gets done automatically. If you don't backup with the right suffix, mkpatches below doesn't work. <!>
You can build the source in the work directory by typing 'make minix'. Repeat until it builds and works.
Now build the package
# cd /usr/pkgsrc/devel/ncurses # bmake
Since packages found in pkgsrc are generally newer than the ones in bigports, you might need to make a few more changes.
Once the package builds successfully, it's time to make patches:
# cd /usr/pkgsrc/devel/ncurses # mkpatches -d patches # rm patches/*.orig # bmake mdi
the new patches are now installed in /usr/pkgsrc/devel/ncurses/patches. See man mkpatches for details. It is a good idea to manually inspect them.
bmake mdi updates the distinfo file. If you don't run make mdi the command “make” doesn't recognize the new patches.
Note: pkgsrc modifies gnu configure scripts and makefiles. So when you do mkpatches, it is likely that the created patches have these changes, these need to be removed.
Make sure everything works fine with the new set of patches:
# bmake clean # bmake
Currently you just mail them to me [gautam (at) minix3 (dot) org].
A secondary pkgsrc repository has been created to allow volunteers to contribute to pkgsrc directly. It is currently experimental as its relationship to the primary pkgsrc repository has yet to be determined.
To read more, please see Volunteer Pkgsrc.