pkgsrc/README.md

76 lines
2.7 KiB
Markdown
Raw Normal View History

2020-01-13 22:05:50 +01:00
pkgsrc
======
[pkgsrc](https://pkgsrc.org) is a framework for building software for a
variety of UNIX-like systems.
It produces binary packages, which can be managed with tools such as
2020-11-04 11:59:39 +01:00
[pkgin](http://pkgin.net/). pkgsrc is highly configurable, supporting
building packages for an arbitrary installation prefix (the default is
`/usr/pkg`), allowing multiple branches to coexist on one machine, a
2020-11-04 11:59:39 +01:00
build options framework, and a compiler trasformation framework, among
other advanced features. Unprivileged use and installation is also supported.
2020-11-04 15:39:49 +01:00
pkgsrc is the default package manager for [NetBSD](https://www.NetBSD.org)
and [SmartOS](https://www.joyent.com/smartos).
2020-11-04 11:59:39 +01:00
It's also supported as a first-class option in [OmniOS CE](https://omniosce.org/)
and [Oasis Linux](https://github.com/oasislinux/oasis).
2020-01-13 22:05:50 +01:00
Bootstrapping
-------------
To use pkgsrc on operating systems other than NetBSD, you first need to
bootstrap:
cd pkgsrc/bootstrap
./bootstrap
Note that this is only for the most simple case, using pkgsrc's defaults.
2020-01-15 17:19:22 +01:00
2020-01-13 22:05:50 +01:00
Please consult `bootstrap/README` and `bootstrap/README.OS` for detailed
information about bootstrapping.
Building packages
-----------------
cd pkgsrc/category/package-name
$PREFIX/bin/bmake install
2020-01-14 13:30:23 +01:00
Where `$PREFIX` is where you've chosen to install packages
(typically `/usr/pkg`)
2020-01-13 22:05:50 +01:00
On NetBSD, `bmake` is simply the built-in `make` tool.
To build packages in bulk, tools such as `pkgtools/pbulk` and
`pkgtools/pkg_comp` can be used.
Troubleshooting
---------------
- Join the community IRC channel [#pkgsrc @ freenode](https://webchat.freenode.net/?channels=#pkgsrc).
- Subscribe to the [pkgsrc-users](https://netbsd.org/mailinglists/#pkgsrc-users) mailing list
- Send bugs and patches [via web form](https://www.netbsd.org/cgi-bin/sendpr.cgi?gndb=netbsd) (use the `pkg` category).
Latest sources
--------------
To fetch the main CVS repository:
cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc
To work in the Git mirror, which is updated every few hours from CVS:
git clone https://github.com/NetBSD/pkgsrc.git
Additional links
----------------
2020-10-09 13:46:29 +02:00
- [pkgsrc guide](https://www.netbsd.org/docs/pkgsrc/) - the authoritative document on pkgsrc, also available as `doc/pkgsrc.txt`
- [pkgsrc in the NetBSD Wiki](https://wiki.netbsd.org/pkgsrc/) - miscellaneous articles and tutorials
- [pkgsrc.se](https://pkgsrc.se/) - a searchable web index of pkgsrc
2020-01-13 22:05:50 +01:00
- [pkgsrc-wip](https://pkgsrc.org/wip/) - a project to get more people actively involved with creating packages for pkgsrc
2020-10-09 13:46:29 +02:00
- [pkgsrc on Twitter](https://twitter.com/pkgsrc) - announcements to the world
- [pkgsrcCon](https://pkgsrc.org/pkgsrcCon) - we get together
- [BulkTracker](https://bulktracker.appspot.com/) - a web application that tracks pkgsrc bulk builds