pkgsrc/doc/guide/files/platforms.xml
sevan cea224c694 Since 2016Q4 the package database lives inside the prefix, out of varbase.
Update the paths.
Remove the platform specific notes place holder which directed readers to
the intro page.
Platform specific notes were moved to the readme files in the bootstrap
directory during the 2016 pkgsrcCon.
2017-01-07 01:46:07 +00:00

66 lines
2.5 KiB
XML

<!-- $NetBSD: platforms.xml,v 1.101 2017/01/07 01:46:07 sevan Exp $ -->
<chapter id="platforms">
<title>Using pkgsrc on systems other than &os;</title>
<sect1 id="binarydist">
<title>Binary distribution</title>
<para>See <xref linkend="using-pkg"/>.</para>
</sect1>
<sect1 id="bootstrapping-pkgsrc">
<title>Bootstrapping pkgsrc</title>
<para>pkgsrc can be bootstrapped for use in two different modes:
privileged and unprivileged one. In unprivileged mode in contrast
to privileged one all programs are installed under one particular user
and cannot utilise privileged operations (packages don't create
special users and all special file permissions like setuid are ignored).
</para>
<para>Installing the bootstrap kit from source should be as simple as:</para>
<screen>
&rprompt; <userinput>env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
&rprompt; <userinput>cd pkgsrc/bootstrap</userinput>
&rprompt; <userinput>./bootstrap</userinput>
</screen>
<para>To bootstrap in unprivileged mode pass <quote>--unprivileged</quote> flag to <command>bootstrap</command></para>
<para>By default, in privileged mode pkgsrc uses
<filename>/usr/pkg</filename> for <emphasis>prefix</emphasis>
where programs will be installed in,
and <filename>/usr/pkg/pkgdb</filename> for the package database
directory where pkgsrc will do its internal bookkeeping,
<filename>/var</filename> is used as <emphasis>varbase</emphasis>,
where packages install their persistent data.
In unprivileged mode pkgsrc uses
<filename>~/pkg</filename> for <emphasis>prefix</emphasis>,
<filename>~/pkg/pkgdb</filename> for the package database,
and <filename>~/pkg/var</filename> for <emphasis>varbase</emphasis>.
</para>
<para>You can change default layout using command-line arguments.
Run <quote>./bootstrap --help</quote> to get details.
</para>
<note>
<para>The bootstrap installs a <command>bmake</command> tool.
Use this <command>bmake</command> when building via pkgsrc.
For examples in this guide, use <command>bmake</command>
instead of <quote>make</quote>.</para>
</note>
<note>
<para>It is possible to bootstrap multiple instances of pkgsrc
using non-intersecting directories. Use <command>bmake</command>
corresponding to the installation you're working with to build
and install packages.
</para>
</note>
</sect1>
</chapter>