lang/perl/files/README.config

   1 -- Perl configuration --
   2
   3 Perl uses a huge configuration file, normally generated via the Configure script
   4 at build-time. This fails when cross-compiling though, so we need to supply our
   5 own.
   6
   7 We're using perlconfig.pl to piece together the final configuration from a bunch
   8 of configuration files(all ending in .config). Please refer to perlconfig.pl's
   9 POD for information on usage and syntax.
  10
  11 Throughout the files, you will see a bunch of references to private symbols with
  12 the prefix "owrt". These are used to control output in an effort to both
  13 simplify writing configuration files, as well as to provide switchable options
  14 to select the feature set of the resulting perl installation.
  15
  16 The following will be a summary/quick reference of all private symbols we're
  17 currently using:
  18
  19 Passed via architecture configuration file(mipsel.config, i486.config, ...)
  20 ---------------------------------------------------------------------------
  21 Symbol              Values              Description
  22 owrt:bits           32/64               Target's native word length.
  23 owrt:endian         little/big          Target's endianness.
  24 owrt:arch           mipsel, i486, ...   Target's architecture name.
  25 owrt:sig_count      64/128              Number of signals the target
  26                                         provides(NSIG - 1).
  27 owrt:sigs           *                   Symbolic names of the first 32 signals
  28                                         this architecture provides, in numeric
  29                                         order. Seperated by whitespaces.
  30 owrt:sig_name_extra *                   Symbolic names of any additional signals
  31                                         this architecture provides after
  32                                         owrt:sig_count. Seperated by
  33                                         whitespaces.
  34 owrt:sig_num_extra  *                   Numeric values associated with the
  35                                         signal names provided in
  36                                         owrt:sig_name_extra. Seperated by
  37                                         whitespaces.
  38
  39 Passed via command line
  40 -----------------------
  41 Symbol                Values              Description
  42 owrt:libc             glibc/uclibc/musl   Which C library implementation is in
  43                                           use.
  44 owrt:threads          yes/no              Whether to enable threading support.
  45 owrt:ipv6             define/undef        Whether to enable IPv6 support.
  46 owrt:target_cross     *                   Target architecture's host triplet.
  47 owrt:target_cc        *                   C compiler to use.
  48 owrt:gccversion       *                   target_cc's version number.
  49 owrt:cflags           *                   Additional C compiler flags.
  50 owrt:ldflags          *                   Additional linker flags.
  51 owrt:staging_dir      *                   Same as OpenWRT buildroot's
  52                                           $(STAGING_DIR).
  53 owrt:host_perl_prefix *                   host-perl installation prefix.
  54
  55 Passed via version.config
  56 -------------------------
  57 Symbol           Values              Description
  58 owrt:perllibpath *                   Path to perl library files, from the
  59                                      target's point of view.