From 43a800c55ff672e859fffcc17841ebed1c28693e Mon Sep 17 00:00:00 2001 From: Uwe Hermann Date: Mon, 18 Aug 2008 18:55:33 +0000 Subject: Add more information to the libpayload README (trivial). Signed-off-by: Uwe Hermann Acked-by: Uwe Hermann git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3515 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1 --- payloads/libpayload/README | 71 ++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 65 insertions(+), 6 deletions(-) (limited to 'payloads') 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 + + 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. -- cgit v1.2.3