docs/faq-troubleshooting.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 Frequently Asked Questions & Troubleshooting
   5 ============================================
   6
   7 [[faq-no-doc-on-target]]
   8 Why is there no documentation on the target?
   9 --------------------------------------------
  10
  11 Because OpenADK mostly targets _small_ or _very small_ target
  12 hardware with limited resource onboard (CPU, ram, mass-storage), it
  13 does not make sense to waste space with the documentation data.
  14
  15 If you need documentation data on your target anyway, then OpenADK
  16 is not suitable for your purpose, and you should look for a _real
  17 distribution_.
  18
  19 [[faq-no-locale-on-target]]
  20 Why is there no locale support on the target?
  21 ---------------------------------------------
  22
  23 OpenADK tries to create a simple and small Linux system, which
  24 has no fancy features enabled. Locale support on a headless system,
  25 like a router is not useful anyway. To avoid bloat, it is a design
  26 decision to not have any locale support. Developers and users
  27 still could add any kind of user interface with internationalization
  28 features.
  29
  30 [[faq-why-not-visible-package]]
  31 Why are some packages not visible in the OpenADK config menu?
  32 -------------------------------------------------------------
  33
  34 If a package exists in the OpenADK tree and does not appear in the
  35 config menu, this most likely means that some of the package's
  36 dependencies are not met.
  37
  38 To know more about the dependencies of a package, search for the
  39 package symbol in the config menu (see xref:make-tips[]).
  40
  41 Then, you may have to recursively enable several options (which
  42 correspond to the unmet dependencies) to finally be able to select
  43 the package.
  44
  45 If the package is not visible due to some unmet dependency to another
  46 C library, either consider to switch to another C library or fix the
  47 package so that it works with your configured library. For this you
  48 need to add your C library to PKG_LIBC_DEPENDS in +package/<pkgname>/Makefile+.
  49
  50 [[faq-no-web-interface]]
  51 Why is there no web based configuration interface available?
  52 ------------------------------------------------------------
  53
  54 OpenADK provides a basic root filesystem for your embedded device.
  55 If you need a web based configuration interface for your own appliance,
  56 just write one. There are plenty of possibilities.