coreboot-kgpe-d16/payloads/libpayload
Patrick Georgi 3b77b723ca libpayload: Add PDCurses and ncurses' libform/libmenu
PDCurses provides an alternative implementation of the curses library
standard in addition to tinycurses.
Where tinycurses is really tiny, PDCurses is more complete and provides
virtually unlimited windows and the full API.
The PDCurses code is brought in "vanilla", with all local changes
residing in curses/pdcurses-backend/

In addition to a curses library, this change also provides libpanel (as
part of the PDCurses code), and libform and libmenu which were derived
from ncurses-5.9.
As they rely on ncurses internals (and PDCurses is not ncurses), more
changes were required for these libraries to work.

The build system is extended to install the right set of header files
depending on the selected curses implementation.

Change-Id: I9e5b920f94b6510da01da2f656196a993170d1c5
Signed-off-by: Patrick Georgi <patrick.georgi@secunet.com>
Reviewed-on: http://review.coreboot.org/106
Tested-by: build bot (Jenkins)
Reviewed-by: Marc Jones <marcj303@gmail.com>
2011-08-04 08:10:41 +02:00
..
arch Fixes to the libpayload build system 2011-07-03 14:47:48 +02:00
bin Add lib/ to the default library path of lpgcc, so -l works 2011-03-01 07:12:08 +00:00
configs libpayload: Add PDCurses and ncurses' libform/libmenu 2011-08-04 08:10:41 +02:00
crypto Use coreboot build system for libpayload, too. 2011-06-30 20:40:10 +02:00
curses libpayload: Add PDCurses and ncurses' libform/libmenu 2011-08-04 08:10:41 +02:00
drivers port_enable and port_reset must change atomically. 2011-07-17 10:22:23 +02:00
include libpayload: Add PDCurses and ncurses' libform/libmenu 2011-08-04 08:10:41 +02:00
lib This patch fixes payloads on certain Fedora versions 2009-07-18 15:18:22 +00:00
libc libpayload: Provide dummy getenv() 2011-07-20 10:02:19 +02:00
libpci Reduce warnings/errors in libpayload when using picky compiler options 2011-06-30 20:41:23 +02:00
sample fix compilation of hello.elf example payload. 2010-08-28 23:23:47 +00:00
util Fix libpayload xconfig script to find coreboot utils xgcc. 2010-06-22 19:12:58 +00:00
Config.in libpayload: Add PDCurses and ncurses' libform/libmenu 2011-08-04 08:10:41 +02:00
Doxyfile Run doxygen -u on doxygen configuration files 2010-06-28 10:40:38 +00:00
LICENSES Since some people disapprove of white space cleanups mixed in regular commits 2010-04-27 06:56:47 +00:00
Makefile Fixes to the libpayload build system 2011-07-03 14:47:48 +02:00
Makefile.inc libpayload: Add PDCurses and ncurses' libform/libmenu 2011-08-04 08:10:41 +02:00
README Update repo path in libpayload readme. 2011-03-29 19:29:01 +00:00

README

-------------------------------------------------------------------------------
libpayload README
-------------------------------------------------------------------------------

libpayload is a minimal library to support standalone payloads
that can be booted with firmware like coreboot. It handles the setup
code, and provides common C library symbols such as malloc() and printf().

Note: This is _not_ a standard library for use with an operating system,
rather it's only useful for coreboot payload development!
See http://coreboot.org for details on coreboot.


Installation
------------

 $ svn co svn://coreboot.org/coreboot/trunk/payloads/libpayload

 $ cd libpayload

 $ make menuconfig

 $ make

 $ sudo make install (optional, will install into /opt per default)

As libpayload is for 32bit x86 systems only, you might have to install the
32bit libgcc version, otherwise your payloads will fail to compile.
On Debian systems you'd do 'apt-get install gcc-multilib' for example.


Usage
-----

Here's an example of a very simple payload (hello.c) and how to build it:

 #include <libpayload.h>

 int main(void)
 {
     printf("Hello, world!\n");
     return 0;
 }

Building the payload using the 'lpgcc' compiler wrapper:

 $ lpgcc -o hello.elf hello.c

Please see the sample/ directory for details.


Website and Mailing List
------------------------

The main website is http://www.coreboot.org/Libpayload.

For additional information, patches, and discussions, please join the
coreboot mailing list at http://coreboot.org/Mailinglist, where most
libpayload developers are subscribed.


Copyright and License
---------------------

See LICENSES.