faq-troubleshooting.txt 2.3 KB

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