Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   549 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

BRK(2)									BRK(2)

NAME
       brk, sbrk - change memory allocation

SYNOPSIS
       #include <u.h>
       #include <libc.h>

       int   brk(void *addr)

       void* sbrk(ulong incr)

DESCRIPTION
       Brk  sets  the system's idea of the lowest bss location not used by the
       program (called the break) to addr rounded up to the next multiple of 8
       bytes.	Locations  not	less than addr and below the stack pointer may
       cause a memory violation if accessed.

       In the alternate function sbrk, incr more bytes are added to  the  pro‐
       gram's  data  space  and	 a  pointer  to	 the  start of the new area is
       returned.  Rounding occurs as with brk.

       When a program begins execution via exec the break is set at the	 high‐
       est  location  defined by the program and data storage areas.  Ordinar‐
       ily, therefore, only programs with growing data areas need to use  brk.
       A  call	to sbrk with a zero argument returns the lowest address in the
       dynamic segment.

SOURCE
       /sys/src/libc/9sys/sbrk.c

SEE ALSO
       intro(2), malloc(2), segattach(2), segbrk(2)

DIAGNOSTICS
       These functions set errstr.

       The error return from sbrk is (void*)-1.

									BRK(2)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome