Return to brk.2 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man2

Annotation of researchv10dc/man/adm/man2/brk.2, revision 1.1.1.1

1.1       root        1: .TH BRK 2
                      2: .CT 2 mem_man
                      3: .SH NAME
                      4: brk, sbrk \(mi change core allocation
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B int brk(addr)
                      8: .B char *addr;
                      9: .PP
                     10: .B char *sbrk(incr)
                     11: .fi
                     12: .SH DESCRIPTION
                     13: .I Brk
                     14: sets the system's idea of the lowest location not used by the program
                     15: (called the break)
                     16: to
                     17: .I addr
                     18: rounded up to the next multiple of 1024 bytes.
                     19: Locations not less than
                     20: .I addr
                     21: and below the stack pointer
                     22: may cause a memory violation if accessed.
                     23: .PP
                     24: In the alternate function
                     25: .I sbrk,
                     26: .I incr
                     27: more bytes are added to the
                     28: program's data space and a pointer to the
                     29: start of the new area is returned.
                     30: Rounding occurs as with
                     31: .I brk,
                     32: but a nominal break is remembered, so rounding does not accumulate.
                     33: .PP
                     34: When a program begins execution via
                     35: .I exec
                     36: the break is set at the
                     37: highest location defined by the program
                     38: and data storage areas.
                     39: Ordinarily, therefore, only programs with growing
                     40: data areas need to use
                     41: .IR brk .
                     42: .PP
                     43: The error return from
                     44: .I sbrk
                     45: is
                     46: .BR "(char *)-1" .
                     47: .SH "SEE ALSO"
                     48: .IR exec (2),
                     49: .IR end (3),
                     50: .IR malloc (3)
                     51: .SH DIAGNOSTICS
                     52: .B ENOMEM

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.