JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

2005-10-28 Bob Wilson <bob.wilson@acm.org>

Browse Source 
* libc/sys.tex (Stubs): Format examples consistently.   Change sbrk
        example to use "_end" symbol instead of "end".  Change write  example
        to use "outbyte" instead of "writechar".
This commit is contained in:
Jeff Johnston 2005-10-28 21:36:05 +00:00
parent a306ebc97e
commit a9c15f6feb
2 changed files with 47 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
newlib/ChangeLog
View File

@ -1,3 +1,9 @@
2005-10-28 Bob Wilson <bob.wilson@acm.org>
* libc/sys.tex (Stubs): Format examples consistently. Change sbrk
example to use "_end" symbol instead of "end". Change write example
to use "outbyte" instead of "writechar".
2005-10-28 Bob Wilson <bob.wilson@acm.org> 2005-10-28 Bob Wilson <bob.wilson@acm.org>
* libc/ctype/ctype.tex: Use hyphens as appropriate, but not otherwise. * libc/ctype/ctype.tex: Use hyphens as appropriate, but not otherwise.

23
newlib/libc/sys.tex
View File

@ -103,7 +103,7 @@ Create a new process. Minimal implementation (for a system without processes):
#include <errno.h> #include <errno.h>
#undef errno #undef errno
extern int errno; extern int errno;
int fork() @{ int fork(void) @{
errno = EAGAIN; errno = EAGAIN;
return -1; return -1;
@} @}
@ -129,7 +129,7 @@ conflict with other processes. Minimal implementation, for a system
without processes: without processes:
@example @example
int getpid() @{ int getpid(void) @{
return 1; return 1;
@} @}
@end example @end example
@ -154,7 +154,7 @@ Send a signal. Minimal implementation:
extern int errno; extern int errno;
int kill(int pid, int sig) @{ int kill(int pid, int sig) @{
errno = EINVAL; errno = EINVAL;
return(-1); return -1;
@} @}
@end example @end example
@ -202,22 +202,21 @@ int read(int file, char *ptr, int len)@{
Increase program data space. As @code{malloc} and related functions Increase program data space. As @code{malloc} and related functions
depend on this, it is useful to have a working implementation. The depend on this, it is useful to have a working implementation. The
following suffices for a standalone system; it exploits the symbol following suffices for a standalone system; it exploits the symbol
@code{end} automatically defined by the GNU linker. @code{_end} automatically defined by the GNU linker.
@example @example
@group @group
caddr_t sbrk(int incr) @{ caddr_t sbrk(int incr) @{
extern char end; /* @r{Defined by the linker} */ extern char _end; /* @r{Defined by the linker} */
static char *heap_end; static char *heap_end;
char *prev_heap_end; char *prev_heap_end;
if (heap_end == 0) @{ if (heap_end == 0) @{
heap_end = &end; heap_end = &_end;
@} @}
prev_heap_end = heap_end; prev_heap_end = heap_end;
if (heap_end + incr > stack_ptr) if (heap_end + incr > stack_ptr) @{
@{ write (1, "Heap and stack collision\n", 25);
_write (1, "Heap and stack collision\n", 25);
abort (); abort ();
@} @}
@ -272,12 +271,12 @@ int wait(int *status) @{
@end example @end example
@item write @item write
Write a character to a file. @file{libc} subroutines will use this Write to a file. @file{libc} subroutines will use this
system routine for output to all files, @emph{including} system routine for output to all files, @emph{including}
@code{stdout}---so if you need to generate any output, for example to a @code{stdout}---so if you need to generate any output, for example to a
serial port for debugging, you should make your minimal @code{write} serial port for debugging, you should make your minimal @code{write}
capable of doing this. The following minimal implementation is an capable of doing this. The following minimal implementation is an
incomplete example; it relies on a @code{writechar} subroutine (not incomplete example; it relies on a @code{outbyte} subroutine (not
shown; typically, you must write this in assembler from examples shown; typically, you must write this in assembler from examples
provided by your hardware manufacturer) to actually perform the output. provided by your hardware manufacturer) to actually perform the output.
@ -287,7 +286,7 @@ int write(int file, char *ptr, int len)@{
int todo; int todo;
for (todo = 0; todo < len; todo++) @{ for (todo = 0; todo < len; todo++) @{
writechar(*ptr++); outbyte (*ptr++);
@} @}
return len; return len;
@} @}