pkgsrc

History

gdt b177a0f098 Omit pkg_tarup during replace in destdir mode In destdir mode (the default), make replace creates the replacement binary package without modifying the installed system, and then installs it via pkg_add -u. Thus, the new package is known to have built and packaged ok before the system is changed, and the risk of trouble is low; thus the benefit of tarring up the installed package is very low, especially since the newly-tarred-up package is removed by "make clean". Using pkg_tarup costs cycles to run and more importantly causes users to have to install it since it is not an automatic dependency. In addition, binary packages are now kept by default when building, so the old version should be accessible in case of trouble. This commit does not change the non-destdir case. Almost no one uses that method, and the relative benefit of tarup is much higher.		2016-09-19 12:26:08 +00:00
..
pkg	Omit pkg_tarup during replace in destdir mode	2016-09-19 12:26:08 +00:00
bsd.pkgformat-vars.mk
bsd.pkgformat.mk
README	Remove support for USE_DESTDIR=no.	2016-04-10 15:58:02 +00:00

README

$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