about summary refs log blame commit diff stats
path: root/core/ports.html
blob: 1d06877a40858618734231ce904c62a3fd5f8814 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11
12











                                              




                                                              


                                                                            
















































                                                                                          
                                                                                                                





























                                                                               


                                                                           

             
























                                                                       


                                               









                                     



                                                     
                                      

             











                                                                      

                                                                           
 






                                                                         
                        



                                                     

                                                                            
 


                                                                         

                                                             
 

                                                  
 


                                       

                                                                        



                                            
 
                                
                                                        


                                    

              

                                              
                                          
                          
                



                                                                                            
<!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>This instructions are done
        <a href="configure.html#chroot">inside chroot</a>.</p>

        <h2 id="fakeroot">1.3.1. Build as user</h2>

        <p>For more information read
	<a href="https://crux.nu/Wiki/FakerootPorts">Fakeroot Ports</a>.
	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="https://crux.nu/Handbook3-2#ntoc22">4.5. Adjust/Configure the Package Build Process</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>Example of complete pkgmk.conf for x86_64 with 4 cores, separate
        distribution files, packages and work directories, uses crux mirror
        to get the sources.</p>

        <pre>
        #
        # /etc/pkgmk.conf: pkgmk(8) configuration
        #

        export CFLAGS="-O2 -march=x86-64"
        export CXXFLAGS="${CFLAGS}"

        export MAKEFLAGS="-j4"

        case ${PKGMK_ARCH} in
                "64"|"")
                        ;;
                "32")
                        export CFLAGS="${CFLAGS} -m32"
                        export CXXFLAGS="${CXXFLAGS} -m32"
                        export LDFLAGS="${LDFLAGS} -m32"
                        export PKG_CONFIG_LIBDIR="/usr/lib32/pkgconfig"
                        ;;
                *)
                        echo "Unknown architecture selected! Exiting."
                        exit 1
                        ;;
        esac

        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"
        # PKGMK_DOWNLOAD="no"
        # PKGMK_IGNORE_FOOTPRINT="no"
        # PKGMK_IGNORE_NEW="no"
        # PKGMK_NO_STRIP="no"
        # PKGMK_DOWNLOAD_PROG="wget"
        # PKGMK_WGET_OPTS=""
        # PKGMK_CURL_OPTS=""
        # PKGMK_COMPRESSION_MODE="gz"

        # End of file
        </pre>

        <h2 id="prtget">1.3.4. Configure prt-get</h2>

        <p>Edit /etc/prt-get.conf;</p>

        <pre>
        ###
        ### prt-get conf
        ###

        # note: the order matters: the package found first is used
        prtdir /usr/ports/core
        prtdir /usr/ports/opt
        prtdir /usr/ports/xorg

        # the following line enables the multilib compat-32 collection
        #prtdir /usr/ports/compat-32

        # the following line enables the user maintained contrib collection
        prtdir /usr/ports/contrib

        # 6c37 team provides a collection with freetype-iu, fontconfig-iu
        # and cairo-iu ports.
        #prtdir /usr/ports/6c37

        ### use mypackage form local directory
        # prtdir /home/packages/build:mypackage

        ### log options:
        writelog enabled         # (enabled|disabled)
        logmode  overwrite       # (append|overwrite)
        rmlog_on_success yes     # (no|yes)
        logfile  /usr/ports/pkgbuild/%n-%v-%r.log
                                   # path, %p=path to port dir, %n=port name
                                   #       %v=version, %r=release

        ### use alternate cache file (default: /var/lib/pkg/prt-get.cache
        # cachefile /mnt/nfs/cache

        ### print README information:
        readme verbose           # (verbose|compact|disabled)

        ### prefer higher versions in sysup / diff
        preferhigher yes      # (yes|no)

        ### use regexp search
        # useregex no        # (yes|no)

        ### run pre- and post-installs scripts; yes is equivalent to the
        ### --install-scripts option
        runscripts yes            # (no|yes)


        ### EXPERT SECTION ###

        ### alternative commands
        makecommand      sudo -H -u pkgmk fakeroot pkgmk
        addcommand       sudo pkgadd
        removecommand    sudo pkgrm
        runscriptcommand sudo sh
        </pre>

        <a href="index.html">Core OS Index</a>
        <p>
        This is part of the c9-doc Manual.
        Copyright (C) 2016
        c9 team.
        See the file <a href="../fdl-1.3-standalone.html">Gnu Free Documentation License</a>
        for copying conditions.</p>
    </body>
</html>