Differences between current version and previous revision of sbrk(2).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Friday, April 11, 2003 1:19:46 am | by PerryLorier | |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:45 am | by perry | Revert |
@@ -1,62 +1,21 @@
-BRK
-!!!BRK
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-CONFORMING TO
-SEE ALSO
-----
-!!NAME
-
-
-brk,
sbrk - change data segment size
+sbrk - change data segment size
!!SYNOPSIS
+ __#include <unistd.h>__
-__#include __
-
-
-__int brk(void
-*__''end_data_segment''__);__
-
-
-
-
+
__void *sbrk(ptrdiff_t__ ''increment''__);__
!!DESCRIPTION
+brk(2) 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(2) increments the program's data space by ''increment'' bytes. sbrk(2) isn't a system call, it is just a C library wrapper. Calling sbrk(2) with an increment of 0 can be used to find the current location of the program break.
-__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
-
-
-__brk__ returns zero, and __
sbrk__
returns
-
-
-__
ENOMEM__
.
+On success, sbrk(2)
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
+sbrk(2) is not defined in the C Standard and is deliberately excluded from the POSIX.1 standard (see paragraphs B.1.1.1.3 and B.8.3.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), brk(2)
