b79fb3c224
rsync is used in the infrastructure, mostly for the per-package infra, and for the override-srcdir mechanism, but also to build the manual. As such, it is not optional but mandatory, and already listed so. Drop the reference to rsync from the list of optional packages. Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
99 lines
2.6 KiB
Plaintext
99 lines
2.6 KiB
Plaintext
// -*- mode:doc; -*-
|
|
// vim: set syntax=asciidoc:
|
|
|
|
[[requirement]]
|
|
== System requirements
|
|
|
|
Buildroot is designed to run on Linux systems.
|
|
|
|
While Buildroot itself will build most host packages it needs for the
|
|
compilation, certain standard Linux utilities are expected to be
|
|
already installed on the host system. Below you will find an overview of
|
|
the mandatory and optional packages (note that package names may vary
|
|
between distributions).
|
|
|
|
[[requirement-mandatory]]
|
|
|
|
=== Mandatory packages
|
|
|
|
* Build tools:
|
|
|
|
** +which+
|
|
** +sed+
|
|
** +make+ (version 3.81 or any later)
|
|
** +binutils+
|
|
** +build-essential+ (only for Debian based systems)
|
|
** +diffutils+
|
|
** +gcc+ (version 4.8 or any later)
|
|
** `g++` (version 4.8 or any later)
|
|
** +bash+
|
|
** +patch+
|
|
** +gzip+
|
|
** +bzip2+
|
|
** +perl+ (version 5.8.7 or any later)
|
|
** +tar+
|
|
** +cpio+
|
|
** +unzip+
|
|
** +rsync+
|
|
** +file+ (must be in +/usr/bin/file+)
|
|
** +bc+
|
|
** +findutils+
|
|
|
|
* Source fetching tools:
|
|
** +wget+
|
|
|
|
[[requirement-optional]]
|
|
|
|
=== Optional packages
|
|
|
|
* Recommended dependencies:
|
|
+
|
|
Some features or utilities in Buildroot, like the legal-info, or the
|
|
graph generation tools, have additional dependencies. Although they
|
|
are not mandatory for a simple build, they are still highly recommended:
|
|
+
|
|
** +python+ (version 2.7 or any later)
|
|
|
|
* Configuration interface dependencies:
|
|
+
|
|
For these libraries, you need to install both runtime and development
|
|
data, which in many distributions are packaged separately. The
|
|
development packages typically have a _-dev_ or _-devel_ suffix.
|
|
+
|
|
** +ncurses5+ to use the 'menuconfig' interface
|
|
** +qt5+ to use the 'xconfig' interface
|
|
** +glib2+, +gtk2+ and +glade2+ to use the 'gconfig' interface
|
|
|
|
* Source fetching tools:
|
|
+
|
|
In the official tree, most of the package sources are retrieved using
|
|
+wget+ from _ftp_, _http_ or _https_ locations. A few packages are only
|
|
available through a version control system. Moreover, Buildroot is
|
|
capable of downloading sources via other tools, like +git+ or +scp+
|
|
(refer to xref:download-infra[] for more details). If you enable
|
|
packages using any of these methods, you will need to install the
|
|
corresponding tool on the host system:
|
|
+
|
|
** +bazaar+
|
|
** +cvs+
|
|
** +git+
|
|
** +mercurial+
|
|
** +scp+
|
|
** +sftp+
|
|
** +subversion+
|
|
|
|
* Java-related packages, if the Java Classpath needs to be built for
|
|
the target system:
|
|
** The +javac+ compiler
|
|
** The +jar+ tool
|
|
|
|
* Documentation generation tools:
|
|
** +asciidoc+, version 8.6.3 or higher
|
|
** +w3m+
|
|
** +python+ with the +argparse+ module (automatically present in 2.7+ and 3.2+)
|
|
** +dblatex+ (required for the pdf manual only)
|
|
|
|
* Graph generation tools:
|
|
** +graphviz+ to use 'graph-depends' and '<pkg>-graph-depends'
|
|
** +python-matplotlib+ to use 'graph-build'
|