Differences between version 2 and revision by previous author of brk(2).
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Tuesday, October 29, 2002 11:33:11 pm | by PerryLorier | Revert |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:39 am | by perry | Revert |
@@ -1,62 +1,27 @@
BRK
!!!BRK
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-CONFORMING TO
-SEE ALSO
----
!!NAME
-
brk, sbrk - change data segment size
!!SYNOPSIS
+ __#include <unistd.h>__
+ __int brk(void *__''end_data_segment''__);__
+ __void *sbrk(ptrdiff_t__ ''increment''__);__
-
-__#include __
-
-
-__int brk(void
-*__''end_data_segment''__);__
-
-
-__void *sbrk(ptrdiff_t__
-''increment''__);__
!!DESCRIPTION
-
-
-
-
-
-
+__brk__ sets the end of the data segment to the value specified by ''end_data_segment'', when that value is reasonable, the system does have enough memory and the process does not exceed its max data size (see
setrlimit(2)).
-
-
-
-
-
+__sbrk__ increments the program's data space by ''increment'' bytes. __sbrk__ isn't a system call, it is just a C library wrapper. Calling __sbrk__ with an increment of 0 can be used to find the current location of
the program break.
!!RETURN VALUE
+On success, __brk__ returns zero, and __sbrk__ returns a pointer to the start of the new area. On error, -1 is returned, and ''errno'' is set to [ENOMEM].
-
-On success, __brk__ returns zero, and __sbrk__ returns
-a pointer to the start of the new area. On error, -1 is
-returned, and ''errno'' is set to
-__ENOMEM__.
!!CONFORMING TO
-
BSD 4.3
-
-
-
-
+__brk__ and __sbrk__ are not defined in the C Standard and are deliberately excluded from the POSIX.1 standard (see paragraphs B.1.1.1.3 and B.8.3.3).
!!SEE ALSO
-
-
-
-
-----
+execve(2), getrlimit(2), malloc(3)
