diff options
author | Uwe Hermann <uwe@hermann-uwe.de> | 2008-08-18 18:55:33 +0000 |
---|---|---|
committer | Uwe Hermann <uwe@hermann-uwe.de> | 2008-08-18 18:55:33 +0000 |
commit | 43a800c55ff672e859fffcc17841ebed1c28693e (patch) | |
tree | 82d44a8287eb30bd04c0af664fb1350177827a60 /payloads | |
parent | 26ba091d5127315a651d7d165d76eb6f197f3198 (diff) |
Add more information to the libpayload README (trivial).
Signed-off-by: Uwe Hermann <uwe@hermann-uwe.de>
Acked-by: Uwe Hermann <uwe@hermann-uwe.de>
git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3515 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
Diffstat (limited to 'payloads')
-rw-r--r-- | payloads/libpayload/README | 71 |
1 files changed, 65 insertions, 6 deletions
diff --git a/payloads/libpayload/README b/payloads/libpayload/README index 7f35fc4e07..b3f7ffc12b 100644 --- a/payloads/libpayload/README +++ b/payloads/libpayload/README @@ -1,7 +1,66 @@ -This is libpayload, 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(). +------------------------------------------------------------------------------- +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. -Please see the sample/ directory for an example of the payload in -action. |