docs/package-reference.txt

   1 [[package-reference]]
   2
   3 +package+ Reference
   4 ~~~~~~~~~~~~~~~~~~~
   5
   6 The list of variables that can be set in a +Makefile+ to give metadata
   7 information is:
   8
   9 * +PKG_NAME+, mandatory, must contain the name of the package.
  10
  11 * +PKG_VERSION+, mandatory, must contain the version of the package.
  12
  13 * +PKG_RELEASE+, mandatory, must contain the OpenADK specific release of the package.
  14
  15 * +PKG_HASH+, mandatory, must contain the SHA256 hash of the package, will be used
  16   to check if a download of a package is complete.
  17
  18 * +PKG_SECTION+, mandatory, must contain the OpenADK specific section, see package/section.lst.
  19
  20 * +PKG_RELEASE+, mandatory, must contain an one line summary of the package description.
  21
  22 * +PKG_URL+, optional, may contain the url to the homepage of the package
  23
  24 * +PKG_SITES+, mandatory, must contain the download url for the package, multiple entries
  25   with space separated, are allowed. Only HTTP/HTTPS or FTP URLS are allowed.
  26   A backup site (http://www.openadk.org/distfiles) is always used, if the package site is
  27   not available. There is no direct support for cvs/svn/git/hg/bzr repositories, because
  28   building OpenADK behind a HTTP proxy should be working without any configuration hassle.
  29   There are also some predefined mirror sites in +mk/mirrors.mk+,
  30   which can be used.
  31   Example: PKG_SITES:=          +${MASTER_SITE_GNU:=foo/}+
  32
  33 * +DISTFILES+ optional, may contain the name of the tarball of
  34   the package. If +DISTFILES+ is not specified, it defaults to +PKG_NAME-PKG_VERSION.tar.xz+.
  35   Example: DISTFILES=           +${PKG_NAME}${PKG_VERSION}.tar.gz+
  36
  37 * +NO_DISTFILES+ optional, may be set to 1, to disable fetching of any archives.
  38   Provide the source code for the package in +package/<pkgname>/src+, which will be
  39   automatically copied to the WRKBUILD/WRKSRC directory.
  40
  41 * +PKG_BUILDDEP+ optional, lists the build time dependencies (in terms of package
  42   directory name, see +package/+) that are required for the current target package to
  43   compile. These dependencies are guaranteed to be compiled and
  44   installed before the configuration of the current package starts.
  45
  46 * +PKG_DEPENDS+ optional, lists the runtime dependencies that are required to
  47   run the software package on the target. It conatins a list of package names,
  48   which might be different to the package directory name. See what is used
  49   in PKG_template, to find out the package name used here.
  50
  51 * +PKG_NOPARALLEL+ optional, may be set to 1, to disable parallel building of the
  52   package via make -jn, n=4 is default, but can be changed in +Global Settings+ in the
  53   menu based configuration.
  54
  55 * +PKG_OPTS+ optional, may be set to following values:
  56      +dev+ create a development package automatically, containing header files and +.pc+ files.
  57                 Only useful for library packages, when you want to compile on the target.
  58      +devonly+ only creates a development package with header files, normally not needed on
  59                 the target.
  60      +noscripts+ do not automatically install *-config and other build related scripts into
  61                 +STAGING_TARGET_DIR/scripts+, required for automake/autoconf package
  62      +noremove+ do not automatically remove package files from +STAGING_TARGET_DIR+
  63
  64 * +PKG_NEED_CXX+ optional, package need C++ compiler
  65
  66 * +PKG_CXX+ optional, package can use either `uClibc++` or `libstdc++`
  67
  68 The recommended way to define these variables is to use the following
  69 syntax:
  70
  71 ----------------------
  72 PKG_VERSION:=           2.11
  73 ----------------------
  74
  75 Or for lines longer than 80 characters use:
  76 ----------------------
  77 PKG_DEPENDS:=           foo bar baz
  78 PKG_DEPENDS+=           muh maeh
  79 ----------------------
  80
  81
  82 The variables that define what should be performed at the
  83 different steps of the configure, build and install process.
  84
  85 * +CONFIG_STYLE+ manual, auto, minimal, basic, perl or cmake
  86
  87 * +CONFIGURE_ARGS+ add --enable-foo/--disable-foo to configure
  88
  89 * +CONFIGURE_ENV+ add additional environment variables to configure step
  90
  91 * +HOST_STYLE+ either manual or auto
  92
  93 * +HOST_CONFIGURE_ARGS+ add --enable-foo/--disable-foo to host configure
  94
  95 * +HOST_CONFIGURE_ENV+ add additional environment variables to the host configure step
  96
  97 * +AUTOTOOL_STYLE+ either autoreconf, autoconf or bootstrap
  98
  99 * +BUILD_STYLE+ either manual or auto
 100
 101 * +MAKE_ENV+ add additional variables to build step
 102
 103 * +MAKE_FLAGS+ add additinal make flags to build step
 104
 105 * +FAKE_FLAGS+ add additional make flags to fake install step
 106
 107 * +XAKE_FLAGS+ add additional make flags to build and fake install step
 108
 109 * +INSTALL_STYLE+ either manual or auto
 110
 111 * +CONFIGURE_PROG+ overwrite default configure programm
 112
 113 * +MAKE_FILE+ overwrite default Makefile
 114
 115 * +ALL_TARGET+ overwrite default build target
 116
 117 * +INSTALL_TARGET+ overwrite default install target
 118
 119 The variables to add or overwrite preprocessor, compiler and linker flags:
 120
 121 * +TARGET_CPPFLAGS+ flags for the preprocessor
 122
 123 * +TARGET_CFLAGS+ flags for the compiler
 124
 125 * +TARGET_LDFLAGS+ flags for the linker
 126
 127 * +TARGET_CXXFLAGS+ flags for the C++ compiler
 128
 129 * +HOST_CPPFLAGS+ flags used for host preprocessing
 130
 131 * +HOST_CFLAGS+ flags used for host compiling
 132
 133 * +HOST_LDFLAGS+ flags used for host linking
 134
 135 * +HOST_CXXFLAGS+ flags for the C++ host compiler
 136