pkgsrc/README.md

77 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2020-01-13 22:05:50 +01:00
pkgsrc
======
[pkgsrc](https://pkgsrc.org/) is a framework for building software for a
2020-01-13 22:05:50 +01:00
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
build options framework, and a compiler transformation framework, among
2020-11-04 11:59:39 +01:00
other advanced features. Unprivileged use and installation is also supported.
pkgsrc is the default package manager for [NetBSD](https://www.NetBSD.org/)
2022-08-01 16:49:09 +02:00
and [SmartOS](https://www.tritondatacenter.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.
2021-05-27 11:02:41 +02:00
Community / Troubleshooting
---------------------------
2020-01-13 22:05:50 +01:00
2021-05-29 15:14:10 +02:00
- Join the community IRC channel [#pkgsrc @ libera.chat](https://web.libera.chat/#pkgsrc).
2022-11-19 22:01:44 +01:00
- Join the community Matrix room [#pkgsrc:netbsd.org](https://matrix.to/#/#pkgsrc:netbsd.org)
- Subscribe to the [pkgsrc-users](https://www.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).
2020-01-13 22:05:50 +01:00
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
----------------
- [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
2024-01-31 03:50:22 +01:00
- [BulkTracker](https://releng.netbsd.org/bulktracker/) - a web application that tracks pkgsrc bulk builds