coreboot-kgpe-d16/payloads/libpayload
Marc Jones 3693266d0d Update coreboot crossgcc toolchain, GCC 4.5.1, MPFR 3.0.0, GDB 7.2.
Add libelf_cv_elf_h_works=no to produce a libelf.h for Cygwin.
Add GDB patch to handle #pragma pack in the i386-elf gcc target.

Signed-off-by: Marc Jones <marcj303@gmail.com>
Acked-by: Stefan Reinauer <stepan@coreboot.org>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@6137 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2010-12-03 00:45:56 +00:00
..
arch Attached patch moves functions out of the huge libpayload.h into headers 2010-06-24 11:16:10 +00:00
bin Update coreboot crossgcc toolchain, GCC 4.5.1, MPFR 3.0.0, GDB 7.2. 2010-12-03 00:45:56 +00:00
configs Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00:00
crypto [PATCH] libpayload: rename config.h to libpayload-config.h 2008-11-24 17:54:46 +00:00
curses Only try to beep when speaker support is compiled in. 2010-09-09 14:44:51 +00:00
drivers Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00:00
include Printing coreboot debug messages on VGA console is pretty much useless, since 2010-11-22 08:09:50 +00:00
lib This patch fixes payloads on certain Fedora versions 2009-07-18 15:18:22 +00:00
libc Changes to str*cmp functions. Fixes a couple more corner cases. 2010-09-08 10:27:13 +00:00
libpci Incomplete implementation of libpci's (of pciutils) interface. 2010-06-24 14:15:49 +00: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 Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00: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 Resolved the bug of filo+libpayload building. The bug is if libpayload is installed before filo load "make -C ../libpayload/Makefile DEST=**", it would not 2010-07-29 00:08:21 +00:00
README Add more information to the libpayload README (trivial). 2008-08-18 18:55:33 +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/repos/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.