67 lines
1.8 KiB
Text
67 lines
1.8 KiB
Text
$NetBSD: README,v 1.3 2016/04/10 15:58:03 joerg Exp $
|
|
|
|
= Introduction =
|
|
|
|
A package format is a packaging system that is supported by pkgsrc.
|
|
Currently, there is only one (the native pkgsrc tools), but maybe we can
|
|
support RPM, dpkg or the Solaris native packages someday. It can also be
|
|
used to test new variants of the packaging tools.
|
|
|
|
NOTE: The Google Summer of Code 2011 project includes rpm and debian
|
|
http://addpackageforma.sourceforge.net/
|
|
|
|
The PKG_FORMAT variable is used to select the format. The default
|
|
format is ``pkg''.
|
|
|
|
= Interface =
|
|
|
|
== Variables usable at load-time ==
|
|
|
|
A package system format must define the following variables so that they
|
|
can be used when loading Makefiles. (That is, no references to undefined
|
|
variables.)
|
|
|
|
=== Legacy ===
|
|
|
|
* PKG_DBDIR (TODO: Make the other parts of pkgsrc independent of that
|
|
variable; this should go away.)
|
|
|
|
=== Packaging commands ===
|
|
|
|
The following variables all refer to shell commands, which must accept
|
|
some command line options that are detailed in the respective man pages.
|
|
(TODO: Find out which command line options are really used and which
|
|
ones are useful. Document them.)
|
|
|
|
* PKG_ADD
|
|
* PKG_ADMIN
|
|
* PKG_CREATE
|
|
* PKG_DELETE
|
|
* PKG_INFO
|
|
* LINKFARM
|
|
* PKG_BEST_EXISTS
|
|
|
|
The following variables must be defined so that they can be used in
|
|
shell commands. They may contain references to all other variables.
|
|
|
|
* PKG_FILELIST_CMD
|
|
|
|
XXX: Why isn't this variable in the previous list?
|
|
|
|
== Make targets ==
|
|
|
|
The following make targets must be implemented:
|
|
|
|
* _pkgformat-check-vulnerable
|
|
* _pkgformat-deinstall
|
|
* _pkgformat-show-depends
|
|
* _pkgformat-install-dependencies
|
|
* bootstrap-depends
|
|
* tarup (XXX: This doesn't sound like a target that should be defined
|
|
here.)
|
|
* tarup-pkg
|
|
* package-install
|
|
* _pkgformat-replace
|
|
* _pkgformat-destdir-replace
|
|
* _pkgformat-undo-replace
|
|
|