Mercurial > hg > Members > kono > nitros9-code
view docs/ccguide/sbrk.refentry @ 3140:03b580a02945
Allow CoCo3FPGA-specific build of superdesc.asm
Added new conditional CC3FPGA and code to "level1/modules/superdesc.asm"
to reflect changes needed to build the new SD card descriptors for the
Coco3FPGA.
author | Bill Pierce <merlinious999@gmail.com> |
---|---|
date | Sat, 04 Feb 2017 11:06:26 +0100 |
parents | 1d37d3a84a7c |
children |
line wrap: on
line source
<refentry id="sbrk"> <refnamediv> <refname>Sbrk</refname> <refname>Ibrk</refname> <refpurpose>request additional working memory</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcprototype> <funcdef>char *<function>sbrk</function></funcdef> <paramdef>int <parameter>increase</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>char *<function>ibrk</function></funcdef> <paramdef>int <parameter>increase</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1><title>Description</title> <para> Sbrk requests an allocation from free memory and returns a pointer to its base. </para> <para> "Sbrk()" requests the system to allocate "new" memory from outside the initial allocation. </para> <para> Users should read the Memory Management section of this manual for a fuller explanation of the arrangement. </para> <para> Ibrk requests memory from inside the initial memory allocation. </para> </refsect1> <refsect1><title>Diagnostics</title> <para> Sbrk and ibrk return -1 if the requested amount of contiguous memory is unavailable. </para> </refsect1> </refentry>