about summary refs log tree commit diff stats
path: root/core/ports.html
diff options
context:
space:
mode:
authorSilvino Silva <silvino@bk.ru>2016-08-20 05:35:06 +0100
committerSilvino Silva <silvino@bk.ru>2016-08-20 05:35:06 +0100
commitc178db81d64eed21177b4c5d78ab3db7a785b7fe (patch)
tree986f5a2a25b3e7ab65de1fcba71648b1c405064f /core/ports.html
parentaa990cd7e4f7be6e760e9cbdd402041dfecca8c7 (diff)
downloaddoc-c178db81d64eed21177b4c5d78ab3db7a785b7fe.tar.gz
initial ports, scripts revision
Diffstat (limited to 'core/ports.html')
-rw-r--r--core/ports.html233


1 files changed, 233 insertions, 0 deletions
diff --git a/core/ports.html b/core/ports.html
new file mode 100644
index 0000000..9150430
--- /dev/null
+++ b/core/ports.html
@@ -0,0 +1,233 @@
+<!DOCTYPE html>
+<html dir="ltr" lang="en">
+    <head>
+        <meta charset='utf-8'>
+        <title>1.3. Ports</title>
+    </head>
+    <body>
+
+        <a href="index.html">Core OS Index</a>
+
+        <h1>1.3. Ports</h1>
+
+        <p>For more information read crux handbook:
+        <a href="https://crux.nu/Main/Handbook3-2#ntoc14">Introduction to pkgutils</a>.</p>
+
+        <dl>
+            <dt>pkgmk(8)</dt>
+
+            <dd>Makes a software package. A package is an archive of
+            files (.pkg.tar.gz, .pkg.tar.bz2 or  .pkg.tar.xz)
+            that can be installed using pkgadd(8).</dd>
+
+            <dt>pkgadd(8)</dt>
+
+            <dd>install a software package. A package is an
+            archive of files (.pkg.tar.gz).</dd>
+
+            <dt>pkginfo(8)</dt>
+
+            <dd>Displays information about software packages that
+            are installed on the system or  that  reside  in  a
+            particular directory.</dd>
+
+            <dt>pkgrm(8)</dt>
+
+            <dd>Removes/uninstalls a previously installed software
+            packages.</dd>
+
+            <dt>prt-get(8)</dt>
+
+            <dd>prt-get is a package management tool which
+            provides additional functionality to crux' package
+            management system. It works with the local ports tree
+            and is therefore fully compatible with ports(8) and
+            pkgmk(8)/pkgadd(8)</dd>
+        </dl>
+
+        <p>This instructions are done
+        <a href="configure.html#chroot">inside chroot</a>.</p>
+
+        <h2 id="fakeroot">1.3.1. Build as user</h2>
+
+        <p>Install fakeroot and create user account, read
+        <a href="https://crux.nu/Wiki/FakerootPorts">Fakeroot Ports</a>;</p>
+
+        <pre>
+        # pkgadd /media/crux/opt/fakeroot#1.20.2-1.pkg.tar.xz
+        </pre>
+
+        <p>Add a user that will be used by ports tools, this example pkgmk;</p>
+
+        <pre>
+        # useradd -U -m -d /usr/ports -s /bin/false pkgmk
+        </pre>
+
+        <p>You can add your self to group pkgmk,</p>
+
+        <pre>
+        # usermod -a -G pkgmk c9admin
+        </pre>
+
+        <pre>
+        # chmod -R 774 /usr/ports
+        # chmod 775    /usr/ports
+        </pre>
+
+        <h2 id="filesystem">1.3.2. Ports Layout</h2>
+
+        <p>This configuration will build and save files
+        inside home directory of the user pkgmk. Work directory
+        will be mounted on ram to speed up the build process and
+        added to fstab. Let's start by creating layout directories</p>
+
+        <pre>
+        # sudo -u pkgmk mkdir /usr/ports/distfiles
+        # sudo -u pkgmk mkdir /usr/ports/packages
+        # sudo -u pkgmk mkdir /usr/ports/work
+        # sudo -u pkgmk mkdir /usr/ports/pkgbuild
+        </pre>
+
+        <p>Configure to
+        <a href="https://crux.nu/Wiki/HowToSpeedUpBuildingPackages#ram">compile in ram</a>
+        average of 3GB is recommended for core while firefox need at least 30G.
+	Discover id of pkgmk user;</p>
+
+        <pre>
+        # id pkgmk
+        uid=102(pkgmk) gid=102(pkgmk) groups=102(pkgmk)
+        </pre>
+
+        <p>Edit fstab, change uid to id of pkgmk, this example 102;</p>
+
+        <pre>
+        pkgmk /usr/ports/work tmpfs size=30G,uid=102,defaults 0 0
+        </pre>
+
+
+        <h2 id="pkgmk">1.3.3. Configure pkgmk</h2>
+
+        <p>Read <a href="systemdoc/Handbook3-1.html#ntoc22">4.5. Adjust/Configure the Package Build Process</a>
+        and <a href="https://crux.nu/Wiki/HowToSpeedUpBuildingPackage">How to speed up building package</a>
+        to take advantage of your specific hardware. Packages build with
+        native flag will not run on different hardware. This is the best choice
+        if you want gcc to find the best settings based on your hardware.</p>
+
+        <p>Edit /etc/pkgmk.conf and remove pipe from compiler
+        flags;</p>
+
+        <pre>
+        export CFLAGS="-O2 -march=x86-64"
+        </pre>
+
+        <p>If you want native build change the above example to;</p>
+
+        <pre>
+        export CFLAGS="-O2 -march=native -mtune=native"
+        </pre>
+
+        <p>Discover number of cores/cpus to hard code -j option.</p>
+
+        <pre>
+        $ nproc
+        2
+        </pre>
+
+        <p>Set number of cores to use;</p>
+
+        <pre>
+        export MAKEFLAGS="-j2"
+        </pre>
+
+        <p>Set separate distribution files, packages and work directories;</p>
+
+        <pre>
+        # PKGMK_SOURCE_MIRRORS=()
+        # PKGMK_SOURCE_MIRRORS=(http://crux.nu/distfiles/)
+        PKGMK_SOURCE_DIR="/usr/ports/distfiles"
+        PKGMK_PACKAGE_DIR="/usr/ports/packages"
+        PKGMK_WORK_DIR="/usr/ports/work/$name"
+        </pre>
+
+        <h2 id="prtget">1.3.4. Configure prt-get</h2>
+
+        <p>Edit /etc/prt-get.conf and change to activate contrib port collection;</p>
+
+        <pre>
+        # the following line enables the user maintained contrib collection
+        prtdir /usr/ports/contrib
+        </pre>
+
+        <pre>
+        ### log options:
+        writelog enabled           # (enabled|disabled)
+        logmode  overwrite         # (append|overwrite)
+        rmlog_on_success yes       # (no|yes)
+        logfile  /usr/ports/pkgbuild/%n.log
+                                   # path, %p=path to port dir, %n=port name
+                                   #       %v=version, %r=release
+        </pre>
+
+        <pre>
+        ### print README information:
+        readme verbose           # (verbose|compact|disabled)
+        </pre>
+
+        <pre>
+        ### prefer higher versions in sysup / diff
+        preferhigher yes      # (yes|no)
+        </pre>
+
+        <pre>
+        ### run pre- and post-installs scripts; yes is equivalent to the
+        ### --install-scripts option
+        runscripts yes             # (no|yes)
+        </pre>
+
+        <pre>
+        ### alternative commands
+        makecommand	     sudo -H -u pkgmk fakeroot pkgmk
+        addcommand       pkgadd
+        removecommand    pkgrm
+        runscriptcommand sh
+        </pre>
+
+        <h2 id="pkginst">1.3.5. Install extra ports</h2>
+
+        <p>Install additional ports like wireless-tools and grub2</p>
+
+        <pre>
+        cp $CHROOT/media/crux/opt/* $CHROOT/usr/ports/packages
+        cp $CHROOT/media/crux/xorg/* $CHROOT/usr/ports/packages
+        </pre>
+
+        <pre>
+        pkgadd /usr/ports/packages/dbus#1.10.2-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/expat#2.1.0-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/libnl#3.2.27-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/libpng#1.6.19-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/freetype#2.6.1-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/libffi#3.2.1-2.pkg.tar.xz
+        pkgadd /usr/ports/packages/sqlite3#3.9.2-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/python#2.7.10-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/glib#2.46.2-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/grub2#2.00-7.pkg.tar.xz
+        pkgadd /usr/ports/packages/grub2-efi#2.00-4.pkg.tar.xz
+        pkgadd /usr/ports/packages/wireless-tools#29-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/wpa_supplicant#2.5-2.pkg.tar.xz
+        pkgadd /usr/ports/packages/lvm2#2.02.133-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/mdadm#3.3.4-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/efivar#0.21-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/efibootmgr#0.12-1.pkg.tar.xz
+        pkgadd /usr/ports/packages/dosfstools#3.0.26-1.pkg.tar.xz
+        </pre>
+
+        <a href="index.html">Core OS Index</a>
+        <p>
+        This is part of the SysDoc Manual.
+        Copyright (C) 2016
+        Silvino Silva.
+        See the file <a href="../fdl-1.3-standalone.html">Gnu Free Documentation License</a>
+        for copying conditions.</p>
+    </body>
+</html>

 

generated by cgit-pink 1.4.1-2-gfad0 (git 2.36.2.497.gbbea4dcf42) at 2025-04-06 23:36:32 +0000