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.

81
newlib/libc/sys.tex
View File

@ -68,8 +68,8 @@ it (@code{exit}, @code{system}).
Close a file. Minimal implementation: Close a file. Minimal implementation:
@example @example
int close(int file)@{ int close(int file) @{
return -1; return -1;
@} @}
@end example @end example
@ -90,8 +90,8 @@ without processes):
#include <errno.h> #include <errno.h>
#undef errno #undef errno
extern int errno; extern int errno;
int execve(char *name, char **argv, char **env)@{ int execve(char *name, char **argv, char **env) @{
errno=ENOMEM; errno = ENOMEM;
return -1; return -1;
@} @}
@end example @end example
@ -103,8 +103,8 @@ 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;
@} @}
@end example @end example
@ -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
@ -140,8 +140,8 @@ other minimal implementations, which only support output to
@code{stdout}, this minimal implementation is suggested: @code{stdout}, this minimal implementation is suggested:
@example @example
int isatty(int file)@{ int isatty(int file) @{
return 1; return 1;
@} @}
@end example @end example
@ -152,9 +152,9 @@ Send a signal. Minimal implementation:
#include <errno.h> #include <errno.h>
#undef errno #undef errno
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
@ -165,8 +165,8 @@ Establish a new name for an existing file. Minimal implementation:
#include <errno.h> #include <errno.h>
#undef errno #undef errno
extern int errno; extern int errno;
int link(char *old, char *new)@{ int link(char *old, char *new) @{
errno=EMLINK; errno = EMLINK;
return -1; return -1;
@} @}
@end example @end example
@ -175,8 +175,8 @@ int link(char *old, char *new)@{
Set position in a file. Minimal implementation: Set position in a file. Minimal implementation:
@example @example
int lseek(int file, int ptr, int dir)@{ int lseek(int file, int ptr, int dir) @{
return 0; return 0;
@} @}
@end example @end example
@ -184,8 +184,8 @@ int lseek(int file, int ptr, int dir)@{
Open a file. Minimal implementation: Open a file. Minimal implementation:
@example @example
int open(const char *name, int flags, int mode)@{ int open(const char *name, int flags, int mode) @{
return -1; return -1;
@} @}
@end example @end example
@ -193,8 +193,8 @@ int open(const char *name, int flags, int mode)@{
Read from a file. Minimal implementation: Read from a file. Minimal implementation:
@example @example
int read(int file, char *ptr, int len)@{ int read(int file, char *ptr, int len) @{
return 0; return 0;
@} @}
@end example @end example
@ -202,24 +202,23 @@ 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 (); @}
@}
heap_end += incr; heap_end += incr;
return (caddr_t) prev_heap_end; return (caddr_t) prev_heap_end;
@ -241,7 +240,7 @@ int stat(char *file, struct stat *st) @{
Timing information for current process. Minimal implementation: Timing information for current process. Minimal implementation:
@example @example
int times(struct tms *buf)@{ int times(struct tms *buf) @{
return -1; return -1;
@} @}
@end example @end example
@ -253,8 +252,8 @@ Remove a file's directory entry. Minimal implementation:
#include <errno.h> #include <errno.h>
#undef errno #undef errno
extern int errno; extern int errno;
int unlink(char *name)@{ int unlink(char *name) @{
errno=ENOENT; errno = ENOENT;
return -1; return -1;
@} @}
@end example @end example
@ -266,30 +265,30 @@ Wait for a child process. Minimal implementation:
#undef errno #undef errno
extern int errno; extern int errno;
int wait(int *status) @{ int wait(int *status) @{
errno=ECHILD; errno = ECHILD;
return -1; return -1;
@} @}
@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.
@example @example
@group @group
int write(int file, char *ptr, int len)@{ 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;
@} @}
@end group @end group
@end example @end example