view docs/ccguide/sbrk.refentry @ 2772:0a3f4d8ea6d5

Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected. Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
author drencor-xeen
date Wed, 23 Jan 2013 12:36:55 -0600
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>