man-pages/man2/brk.2

90 lines
2.8 KiB
Groff
Raw Normal View History

2004-11-03 13:51:07 +00:00
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1993 Michael Haardt
.\" (michael@moria.de),
.\" Fri Apr 2 11:32:09 MET DST 1993
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu>
.\"
.TH BRK 2 2003-11-01 "Linux 2.4" "Linux Programmer's Manual"
.SH NAME
brk, sbrk \- change data segment size
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int brk(void *" end_data_segment );
.sp
.BI "void *sbrk(intptr_t " increment );
.SH DESCRIPTION
.BR brk ()
2004-11-03 13:51:07 +00:00
sets the end of the data segment to the value specified by
.IR 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
.BR setrlimit (2)).
.BR sbrk ()
2004-11-03 13:51:07 +00:00
increments the program's data space by
.I increment
bytes.
.BR sbrk ()
2004-11-03 13:51:07 +00:00
isn't a system call, it is just a C library wrapper.
Calling
.BR sbrk ()
2004-11-03 13:51:07 +00:00
with an increment of 0 can be used to find the current
location of the program break.
.SH "RETURN VALUE"
On success,
.BR brk ()
2004-11-03 13:51:07 +00:00
returns zero, and
.BR sbrk ()
2004-11-03 13:51:07 +00:00
returns a pointer to the start of the new area. On error, \-1 is returned,
and
.I errno
is set to
.BR ENOMEM .
.SH "CONFORMING TO"
4.3BSD
2004-11-03 13:51:07 +00:00
2005-10-28 13:40:41 +00:00
.BR brk ()
and
.BR sbrk ()
2004-11-03 13:51:07 +00:00
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).
.SH NOTES
Various systems use various types for the parameter of
.BR sbrk ().
2006-02-09 20:24:53 +00:00
Common are \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP, \fIintptr_t\fP.
2004-11-03 13:51:07 +00:00
.\" One sees
2006-02-09 20:24:53 +00:00
.\" \fIint\fP (e.g. XPGv4, DU 4.0, HP-UX 11, FreeBSD 4.0, OpenBSD 3.2),
.\" \fIssize_t\fP (OSF1 2.0, Irix 5.3, 6.5),
.\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc2.0, 2.1),
.\" \fIintptr_t\fP (e.g. XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
2004-11-03 13:51:07 +00:00
.\" Tru64 5.1, glibc2.2).
XPGv6 obsoletes this function.
.SH "SEE ALSO"
.BR execve (2),
.BR getrlimit (2),
.BR malloc (3)