summaryrefslogtreecommitdiff
path: root/doc/guide/files/platforms.xml
blob: e87d032c42cfa30942f71e3ddb92439377e3615a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<!-- $NetBSD: platforms.xml,v 1.100 2016/07/10 01:49:39 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>/var/db/pkg</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/var/db/pkg</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>

  <sect1 id="platform-specific-notes">
    <title>Platform-specific notes</title>

    <para>For platform-specific notes consult the <filename>README</filename>
    files found in the notes column of <xref linkend="supported-platforms"/></para>

  </sect1>
</chapter>