.. _spkg__prereq:

_prereq: Represents system packages required for installing SageMath from source
================================================================================

Description
-----------

This dummy package represents the minimal requirements (system packages)
for installing SageMath from source.

In addition to standard :wikipedia:`POSIX <POSIX>` utilities
and the :wikipedia:`bash <Bash_(Unix_shell)>` shell,
the following standard command-line development tools must be installed on your
computer:

- **make**: GNU make, version 3.80 or later. Version 3.82 or later is recommended.
- **m4**: GNU m4 1.4.2 or later (non-GNU or older versions might also work).
- **perl**: version 5.8.0 or later.
- **ar** and **ranlib**: can be obtained as part of GNU binutils.
- **tar**: GNU tar version 1.17 or later, or BSD tar (as provided on macOS).
- **python**: Python 3.4 or later, or Python 2.7.
  (This range of versions is a minimal requirement for internal purposes of the SageMath
  build system, which is referred to as ``sage-bootstrap-python``.)
- **patch**.
- **bzip2**: the executable ``bzip2`` and the library ``libbz2`` with its headers.
  (some Linux distros package these separately, e.g. Debian/Ubuntu needs
  packages ``bzip2`` and ``libbz2-dev``; Fedora needs ``bzip2`` and ``bzip2-devel``.)
- **pkgconf**, also known as ``pkg-config``.

Other versions of these may work, but they are untested.

On macOS, suitable versions of most of these tools are provided
by the Xcode Command Line Tools.  To install them, open a terminal
window and run ``xcode-select --install``; then click "Install" in the
pop-up window.  If the Xcode Command Line Tools are already installed,
you may want to check if they need to be updated by typing
``softwareupdate -l``. The remaining are provided by either one of macOS's
"missing package managers", such as Homebrew, or as standalone
tools. In particular ``pkgconf`` is available as `pkg-config_pkg
<https://github.com/donmccaughey/pkg-config_pkg>`_.

On Linux, ``ar`` and ``ranlib`` are in the `binutils
<https://www.gnu.org/software/binutils/>`_ package.  The other
programs are usually located in packages with their respective names.

On Redhat-derived systems not all perl components are installed by
default and you might have to install the ``perl-ExtUtils-MakeMaker``
package.

To check if you have the above prerequisites installed, for example ``perl``,
type::

    $ command -v perl

or::

    $ which perl

on the command line. If it gives an error (or returns nothing), then
either ``perl`` is not installed, or it is installed but not in your
:wikipedia:`PATH <PATH_%28variable%29>`.

Type
----

standard


Dependencies
------------


Version Information
-------------------


Equivalent System Packages
--------------------------

.. tab:: Alpine

   .. CODE-BLOCK:: bash

       $ apk add binutils make m4 perl python3 tar bc gcc g++ ca-certificates \
             coreutils patch bzip2 patch pkgconf


.. tab:: Arch Linux

   .. CODE-BLOCK:: bash

       $ sudo pacman -S binutils make m4 perl python tar bc gcc bzip2 which \
             patch pkgconf


.. tab:: conda-forge

   .. CODE-BLOCK:: bash

       $ conda install compilers make m4 perl python tar bc patch bzip2 \
             pkg-config


.. tab:: Debian/Ubuntu

   .. CODE-BLOCK:: bash

       $ sudo apt-get install binutils make m4 perl flex python3 tar bc gcc \
             libbz2-dev bzip2 g++ ca-certificates patch pkg-config


.. tab:: Fedora/Redhat/CentOS

   .. CODE-BLOCK:: bash

       $ sudo dnf install binutils make m4 python3 perl \
             perl-ExtUtils-MakeMaker tar gcc bzip2 bzip2-devel gcc-c++ \
             findutils which diffutils perl-IPC-Cmd flex patch pkg-config


.. tab:: FreeBSD

   .. CODE-BLOCK:: bash

       $ sudo pkg install gmake automake bash dash python patch bzip2 patch \
             devel/pkgconf


.. tab:: Gentoo Linux

   .. CODE-BLOCK:: bash

       $ sudo emerge sys-devel/binutils sys-libs/binutils-libs dev-build/make \
             dev-scheme/guile dev-libs/libffi app-arch/tar sys-devel/gcc \
             dev-libs/mpc sys-libs/glibc sys-kernel/linux-headers \
             dev-lang/perl sys-devel/m4 sys-devel/bc dev-lang/python \
             sys-devel/flex app-misc/ca-certificates dev-libs/libxml2 \
             sys-apps/findutils sys-apps/which sys-apps/diffutils \
             sys-devel/patch app-arch/bzip2 sys-devel/patch dev-util/pkgconf


.. tab:: Homebrew

   .. CODE-BLOCK:: bash

       $ brew install pkgconf 


.. tab:: MacPorts

   .. CODE-BLOCK:: bash

       $ sudo port install pkgconfig 


.. tab:: Nixpkgs

   .. CODE-BLOCK:: bash

       $ nix-env --install binutils gnumake gnum4 perl python3 gnutar bc gcc \
             bash gnupatch bzip2 gnupatch pkg-config


.. tab:: openSUSE

   .. CODE-BLOCK:: bash

       $ sudo zypper install binutils make m4 gawk perl python3 tar bc which \
             glibc-locale-base gcc gcc-c++ ca-certificates gzip findutils \
             diffutils patch bzip2 pkgconfig\(bzip2\) patch pkgconf


.. tab:: Slackware

   .. CODE-BLOCK:: bash

       $ sudo slackpkg install binutils make guile gc libffi gcc-13 gcc-g++-13 \
             libmpc glibc kernel-headers perl m4 bc python3 flex \
             ca-certificates libxml2 cyrus-sasl patch bzip2 patch pkg-config


.. tab:: Void Linux

   .. CODE-BLOCK:: bash

       $ sudo xbps-install bc binutils gcc libgomp-devel m4 make perl python3 \
             tar bash which diffutils gzip python3-devel bzip2-devel xz \
             liblzma-devel libffi-devel zlib-devel libxcrypt-devel patch \
             bzip2-devel patch pkgconf



If the system package is installed, ``./configure`` will check if it can be used.

