|
466
|
1 <refentry id="sbrk">
|
|
|
2 <refnamediv>
|
|
468
|
3 <refname>Sbrk</refname>
|
|
574
|
4 <refname>Ibrk</refname>
|
|
468
|
5 <refpurpose>request additional working memory</refpurpose>
|
|
466
|
6 </refnamediv>
|
|
|
7
|
|
|
8 <refsynopsisdiv>
|
|
|
9 <funcsynopsis>
|
|
|
10 <funcprototype>
|
|
574
|
11 <funcdef>char *<function>sbrk</function></funcdef>
|
|
|
12 <paramdef>int <parameter>increase</parameter></paramdef>
|
|
|
13 </funcprototype>
|
|
|
14 <funcprototype>
|
|
|
15 <funcdef>char *<function>ibrk</function></funcdef>
|
|
|
16 <paramdef>int <parameter>increase</parameter></paramdef>
|
|
466
|
17 </funcprototype>
|
|
|
18 </funcsynopsis>
|
|
|
19
|
|
|
20 </refsynopsisdiv>
|
|
|
21
|
|
|
22 <refsect1><title>Description</title>
|
|
|
23 <para>
|
|
604
|
24 Sbrk requests an allocation from free memory and returns a
|
|
|
25 pointer to its base.
|
|
|
26 </para>
|
|
|
27 <para>
|
|
|
28 "Sbrk()" requests the system to allocate "new" memory from
|
|
|
29 outside the initial allocation.
|
|
|
30 </para>
|
|
|
31 <para>
|
|
|
32 Users should read the Memory Management section of this manual
|
|
|
33 for a fuller explanation of the arrangement.
|
|
|
34 </para>
|
|
|
35 <para>
|
|
|
36 Ibrk requests memory from inside the initial memory allocation.
|
|
466
|
37 </para>
|
|
|
38 </refsect1>
|
|
552
|
39
|
|
|
40 <refsect1><title>Diagnostics</title>
|
|
|
41 <para>
|
|
|
42 Sbrk and ibrk return -1 if the requested amount of contiguous
|
|
|
43 memory is unavailable.
|
|
|
44 </para>
|
|
|
45 </refsect1>
|
|
|
46
|
|
466
|
47 </refentry>
|
