pkgsrc/mk/buildlink3
jlam 28856457ab If we can't find the package with pkg_info when computing BUILDLINK_PREFIX,
make the resulting error message more useful for debugging purposes
by including the name of the variable in a null statement that is part
of the command executed.
2006-04-14 16:59:04 +00:00
..
bsd.buildlink3.mk If we can't find the package with pkg_info when computing BUILDLINK_PREFIX, 2006-04-14 16:59:04 +00:00
bsd.builtin.mk Correct typo in example Makefile snippet. 2006-04-10 12:25:43 +00:00
buildcmd-libtool Initial commit of a new wrapper script framework that encapsulates 2004-09-21 15:01:38 +00:00
BUILDLINK3_DG USE_BUILDLINK3 is no longer optional (and cannot be turned off). Per mail 2005-03-24 17:46:00 +00:00
cleanup-libtool Initial commit of a new wrapper script framework that encapsulates 2004-09-21 15:01:38 +00:00
cmd-sink-libtool Hardcode a workaround for perl's DynaLoader.a which is definitely a 2005-08-05 19:46:41 +00:00
find-files.mk Drop distinction between PKGSRC_USE_TOOLS and USE_TOOLS by making 2005-07-15 18:27:48 +00:00
find-libs.mk Drop distinction between PKGSRC_USE_TOOLS and USE_TOOLS by making 2005-07-15 18:27:48 +00:00
imake-check Avoid generating a blank line as the first command of a target as that 2005-06-15 17:54:59 +00:00
imake-check.mk If we need imake, then also pull in any other tools that imake needs to 2005-08-10 16:28:59 +00:00
libtool-fix-la Fix build of the packages which pass .la files to libtool by relative 2005-12-09 16:16:41 +00:00
PKGVIEWS_UG "the the" -> "the" 2004-12-01 09:52:59 +00:00
README USE_BUILDLINK3 is no longer optional (and cannot be turned off). Per mail 2005-03-24 17:46:00 +00:00
scan-libtool Teach the libtool wrapper about the "clean" and "uninstall" modes, where 2004-09-24 20:44:28 +00:00
TODO +less obfuscated errors 2004-02-17 08:59:44 +00:00
transform-libtool Don't cache transformations of "-lfoo" into "rel/path/to/libfoo.la" because 2004-10-03 21:39:07 +00:00

$NetBSD: README,v 1.6 2005/03/24 17:46:01 tv Exp $

 0 Package Views
 ===============

Package views is a pkgsrc technology that supports building and
installing multiple versions of the same software such that they
co-exist on a single system.  Individual packages are installed into
their own directory tree and their files are symlinked into "views".
Users can choose amongst different software collections provided by
different views by appropriately setting shell environment variables,
e.g., PATH, MANPATH, etc.

Package views is similar in spirit to the Encap Package Management
System, the GNU Stow Project, and the Carnegie Mellon University Depot
Configuration Management system:

	http://www.encap.org/
	http://www.gnu.org/software/stow/stow.html
	http://asg.web.cmu.edu/andrew2/depot/

However, these projects have a philosophy of "install anywhere, use in
one place", whereas package views departs from that model with a
philosophy that can roughly be summarized as "install in one place,
use anywhere".


 0.1 A short history of package views
 ====================================

Package views was proposed as a solution to the problem of not being
able to install multiple versions of the same software simultaneously
via pkgsrc.  Alistair Crooks presented a paper on package views at
EuroBSDCon in November 2002 that described the work he did on the
"pkgviews" branch of pkgsrc where he implemented his ideas.  The paper
is highly-recommended reading for a more complete understanding of
package views principles and is available at:

	http://www.NetBSD.org/Documentation/software/pkgviews.pdf

Unfortunately, Alistair ran out of time to devote to integrating his
work into the main pkgsrc branch.  The code he developed languished on
the "pkgviews" branch for over a year, and in the meantime much code
was added to pkgsrc that increased the complexity and the capabilities
of pkgsrc, including buildlink2, which conflicted with Alistair's
implementation of package views.  In September 2003, Johnny Lam
integrated the functionality on the pkgviews branch into modern
pkgsrc.  As part of the integration, a new buildlink3 framework was
created so that the ability to isolate builds from differences in
the environment wouldn't be lost.


 0.2 Package views terminology
 =============================

The terminology for packages in the package views world is as
follows:  a "pkgviews" package is a package that has been converted to
build and install using package views.  An "overwrite" package is one
that hasn't.  A "depoted" package describes a pkgviews package
installed into /usr/pkg/packages in its "depot" directory.  A package
"instance" in a view describes a depoted package symlinked into a
view.


 0.3 What's been done
 ====================

The pkg_install tools have been enhanced to handle both binary depoted
packages and binary "overwrite" packages.  The pkgsrc internals have
been modified to allow building and installing depoted packages and to
automatically add a depoted package in the default view.
"Overwrite" packages shouldn't be affected by the changes, and can be
freely mixed with pkgviews packages.

Packages that have been converted to use "pkgviews" should add the
following line to their Makefiles:

	PKG_INSTALLATION_TYPES=	overwrite pkgviews

PKG_INSTALLATION_TYPES can also just be one value or the other to
explicitly note that the package only supports that one type of
installation style.  Users may add the following line to /etc/mk.conf:

	PKG_INSTALLATION_PREFS=	pkgviews overwrite

to note that they prefer building using pkgviews if the package
supports it, otherwise to build using the "overwrite" installation
style.  However, users should not change PKG_INSTALLATION_PREFS from
the default value unless they're sure that they want to start
migrating their package system over to using pkgviews.  The default,
"overwrite pkgviews", will cause all packages to build using the
"overwrite" installation style.

Some highlight of pkgviews packages include:

	* fully dynamic PLISTs
	* multiple versions of the same package can co-exist


 0.4 buildlink3 pkgsrc build framework
 =====================================

A new buildlink3 framework that takes advantage of depoted packages
has been added to pkgsrc as part of the package views changes.
Buildlink3 uses wrapper scripts much like buildlink2.  However, when
building pkgviews packages, it doesn't symlink files into
${BUILDLINK_DIR} since it can safely refer to only a specific
package's files by passing the appropriate -I<dir> and -L<dir> flags
to the compiler, where <dir> points to a location in the package's
depot directory.  When building "overwrite" packages, buildlink3 will
act and feel very much like buildlink2 but with more advanced wrapper
scripts, and there are provisions for allowing an "overwrite" package
to build against the viewed instance of a depoted package.  The
implementation currently allows "overwrite" to depend on either
"overwrite" or pkgviews packages, but pkgviews packages are restricted
to only being able to depend on other pkgviews packages.


 0.5 Future Work
 ===============

There may be some way around the problem of pkgviews packages not
being able to depend on "overwrite" packages.  That's the only thing
standing in the way between allowing an arbitrary package to be built
using either installation style and working seamlessly with any other
package.  The problem has to do with proper handling of metadata in
the +REQUIRED_BY and +CONTENTS files that are split in two separate
places.  One possible route to a solution is that for each overwrite
package, we can symlink /usr/pkg/packages/<pkg> -> /var/db/pkg/<pkg>.
This allows depoted packages to record themselves directly in the
+REQUIRED_BY files of "overwrite" packages.  If a user happens to run

	pkg_delete -K /usr/pkg/packages <overwrite_pkg>

then it still uses the correct +CONTENTS, +INSTALL, and +DEINSTALL
scripts, so the package will still remove itself properly from
/usr/pkg.  However, there are some remaining issues with properly
removing both the /var/db/pkg/<pkg> directory and the
/usr/pkg/packages/<pkg> symlink, so the deletion won't be completely
clean until this issue can be resolved.