coreboot-kgpe-d16/payloads/libpayload
Stefan Reinauer abc0c85516 Printing coreboot debug messages on VGA console is pretty much useless, since
initializing VGA happens pretty much as the last thing before starting the
payload. Hence, drop VGA console support, as we did in coreboot v3.

- Drop VGA and BTEXT console support. 
  Console is meant to be debugging only, and by the time graphics comes up
  99% of the risky stuff has already happened. Note: This patch does not remove
  hardware init but only the actual output functionality. 

  The ragexl driver needs some extra love, but that's for another day
- factor out die() and post()
- drop some leftover RAMBASE < 0x100000 checks.

Signed-off-by: Stefan Reinauer <stepan@coreboot.org>
Acked-by: QingPei Wang<wangqingpei@gmail.com>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@6111 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2010-11-22 08:09:50 +00:00
..
arch Attached patch moves functions out of the huge libpayload.h into headers 2010-06-24 11:16:10 +00:00
bin __i386__ and __powerpc__ are set by the compiler already. 2010-06-24 14:43:17 +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.