Annotation of pkgsrc/bootstrap/README.Linux, revision 1.14

1.14    ! schmonz     1: $NetBSD: README.Linux,v 1.13 2022/06/01 12:15:39 gdt Exp $
1.1       grant       2: 
1.10      gdt         3: # General
1.1       grant       4: 
1.10      gdt         5: Generally, bootstrapping on GNU/Linux is expected to Just Work with
                      6: gcc.
                      7: 
                      8: # Compilers
                      9: 
                     10: ## gcc
                     11: 
                     12: gcc is the standard approach.
                     13: 
                     14: As of 2022 it has been reported that systems with gcc 4.8 (e.g. RHEL7)
                     15: do not bootstrap, but that gcc7 (AWS-flavored RHEL7) and gcc8 (RHEL8) succeed.
                     16: 
                     17: ## clang
                     18: 
                     19: There are no reports of success or failure with clang.
                     20: 
                     21: ## icc
                     22: 
1.12      gdt        23: It was reported in 2008 that icc (Intel C++ Compiler) 8.0 and 8.1
1.10      gdt        24: have been tested on i386.  See the old section at the end.
                     25: 
1.14    ! schmonz    26: # Alpine and derivatives
        !            27: 
        !            28: After bootstrap, if you want to be using pkgsrc build/install locking,
        !            29: install a more featureful ps(1) than BusyBox's:
        !            30: 
        !            31:        apk add procps
        !            32: 
        !            33: You may also find that pkgsrc needs a more featureful date(1),
        !            34: such as GNU's:
        !            35: 
        !            36:        apk add coreutils
        !            37: 
1.10      gdt        38: # Debian and derivatives
1.4       dmcmahil   39: 
1.6       sevan      40: For Debian and derivatives such as Ubuntu the following packages should be
1.10      gdt        41: installed prior to attempting bootstrap:
1.6       sevan      42: 
1.9       cjep       43: apt-get install cvs libncurses5 libncurses5-dev gcc g++ zlib1g-dev \
                     44:                        zlib1g libssl-dev libudev-dev
1.6       sevan      45: 
1.13      gdt        46: # RedHat and derivatives
                     47: 
                     48: In 2022, pkgsrc bootstrapped ok on RHEL 8.5, and packages generally worked.
                     49: 
1.11      nia        50: # NixOS
                     51: 
                     52: stdenv.cc should be installed prior to attempting bootstrap.
                     53: 
                     54: Please note that if you run the Nix garbage collector and it collects
                     55: libc, every pkgsrc binary (including binaries generated during bootstrap)
                     56: will need to be rebuilt.
                     57: 
1.12      gdt        58: # musl
                     59: 
                     60: Linux with musl was reported to work in 2022.
                     61: 
                     62: # Termux (Android)
                     63: 
                     64: In 2022, unprivileged bootstrap failed.
                     65: 
                     66: # Very old information
1.4       dmcmahil   67: 
1.12      gdt        68: ## Details of using icc (last update 2005
1.2       grant      69: 
                     70: To bootstrap using icc, assuming the default icc installation
                     71: directory:
                     72: 
                     73:        env CC=/opt/intel_cc_80/bin/icc LDFLAGS=-static-libcxa \
                     74:                ac_cv___attribute__=yes ./bootstrap
                     75: 
1.3       grant      76: note: icc 8.1 needs the `-i-static' argument instead of
                     77: -static-libcxa.
                     78: 
1.2       grant      79: icc supports __attribute__, but the GNU configure test uses a nested
                     80: function, which icc does not support. #undef'ing __attribute__ has the
                     81: unfortunate side-effect of breaking many of the Linux header files, which
                     82: cannot be compiled properly without __attribute__. The test must be
                     83: overridden so that __attribute__ is assumed supported by the compiler.
                     84: 
                     85: After bootstrapping, you should set PKGSRC_COMPILER in mk.conf:
                     86: 
                     87:        PKGSRC_COMPILER=icc
                     88: 
                     89: The default installation directory for icc is /opt/intel_cc_80, which
                     90: is also the pkgsrc default. If you have installed it into a different
                     91: directory, set ICCBASE in mk.conf:
                     92: 
                     93:        ICCBASE=/opt/icc
                     94: 
                     95: pkgsrc uses the static linking method of the runtime libraries
                     96: provided by icc, so binaries can be run on other systems which do not
                     97: have the shared libraries installed.
                     98: 
                     99: Libtool, however, extracts a list of libraries from the ld(1) command
                    100: run when linking a C++ shared library and records it, throwing away
                    101: the -Bstatic and -Bdynamic options interspersed between the libraries.
                    102: This means that libtool-linked C++ shared libraries will have a
                    103: runtime dependency on the icc libraries until this is fixed in
                    104: libtool.

CVSweb <webmaster@jp.NetBSD.org>