Return to README.txt CVS log

Up to [Qemu by Fabrice Bellard] / qemu / roms / SLOF / lib / libc

Annotation of qemu/roms/SLOF/lib/libc/README.txt, revision 1.1

1.1     ! root        1: 
        !             2:  Standard C library for the SLOF firmware project
        !             3:  ================================================
        !             4: 
        !             5: To use this library, link your target against the "libc.a" archive.
        !             6: 
        !             7: However, there are some prerequisites before you can use certain parts of the
        !             8: library:
        !             9: 
        !            10: 1) If you want to use malloc() and the like, you have to supply an implemen-
        !            11:    tation of sbrk() in your own code. malloc() uses sbrk() to get new, free
        !            12:    memory regions.
        !            13:    
        !            14:    Prototype:   void *sbrk(int incr);
        !            15:    Description: sbrk() increments the available data space by incr bytes and
        !            16:                 returns a pointer to the start of the new area.
        !            17:    
        !            18:    See the man-page of sbrk for details about this function.
        !            19: 
        !            20: 2) Before you can use the stdio output functions like printf(), puts() and the
        !            21:    like, you have to provide a standard write() function in your code.
        !            22:    printf() and the like use write() to print out the strings to the standard
        !            23:    output.
        !            24: 
        !            25:    Prototype:   ssize_t write(int fd, const void *buf, size_t cnt);
        !            26:    Description: Write cnt byte from the buffer buf to the stream associated
        !            27:                 with the file descriptor fd.
        !            28: 
        !            29:    The stdio functions will print their output to the stdout channel which is
        !            30:    assigned with the file descriptor 1 by default. Note that the stdio
        !            31:    functions will not use open() before calling write(), so if the stdout
        !            32:    cannel needs to be opened first, you should do that in your start-up code
        !            33:    before using the libc functions for the first time.
        !            34:    
        !            35: 3) Before you can use the stdio input functions like scanf() and the
        !            36:    like, you have to provide a standard read() function in your code.
        !            37:    scanf() and the like use read() to get the characters from the standard
        !            38:    input.
        !            39: 
        !            40:    Prototype:   ssize_t read(int fd, void *buf, size_t cnt);
        !            41:    Description: Read cnt byte from the stream associated with the file
        !            42:                 descriptor fd and put them into the buffer buf.
        !            43: 
        !            44:    The stdio functions will get their input from the stdin channel which is
        !            45:    assigned with the file descriptor 0 by default. Note that the stdio
        !            46:    functions will not use open() before calling read(), so if the stdin
        !            47:    cannel needs to be opened first, you should do that in your start-up code
        !            48:    before using the libc functions for the first time.
        !            49:    

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.