| .ds lang COBOL | |
| .ds gcobol GCC\ \*[lang]\ Front-end | |
| .Dd \& March 2026 | |
| .Dt CBL_ALLOC_MEM 3\& "\&GNU Compatibility Library" | |
| .Os Linux | |
| .Sh NAME | |
| .Nm CBL_ALLOC_MEM | |
| .Nd allocate memory | |
| .Sh LIBRARY | |
| libgcobol_compat_gnu | |
| . | |
| .Sh SYNOPSIS | |
| .Ic call Dq "CBL_ALLOC_MEM" | |
| using | |
| .Ar pointer | |
| by value | |
| .Ar size | |
| by value | |
| .Ar flags | |
| returning | |
| .Ar status | |
| . | |
| .Sh DESCRIPTION | |
| Dynamically allocate memory of | |
| .Ar size | |
| bytes to | |
| .Ar pointer . | |
| This function dates from before \*[lang] had an | |
| .Sy ALLOCATE | |
| statement. Parameters: | |
| .Pp | |
| .Bl -tag -compact -width pointer | |
| .It Ar pointer | |
| .Sy "USAGE POINTER" . | |
| Must be level 01. | |
| .It Ar size | |
| .Sy "PIC X(8) COMP-5" . | |
| .It Ar flags | |
| .Sy "PIC X(8) COMP-5" . | |
| This parameter is ignored. | |
| .El | |
| . | |
| .Sh RETURN STATUS | |
| .Nm | |
| returns | |
| .Sy "PIC X(2) COMP-5" . | |
| The return status is 0 on success, else nonzero. | |
| . | |
| .Sh SEE ALSO | |
| .Xr CBL_FREE_MEM | |
| . | |
| .Sh NOTES | |
| .Nm | |
| is implemented in terms of the | |
| .Sy ALLOCATE | |
| statement. | |
| .Sh COPYRIGHT | |
| .Bd -unfilled -indent | |
| Copyright (c) 2021-2026 Symas Corporation | |
| Redistribution and use in source and binary forms, with or without | |
| modification, are permitted provided that the following conditions are | |
| met: | |
| * Redistributions of source code must retain the above copyright | |
| notice, this list of conditions and the following disclaimer. | |
| * Redistributions in binary form must reproduce the above | |
| copyright notice, this list of conditions and the following disclaimer | |
| in the documentation and/or other materials provided with the | |
| distribution. | |
| * Neither the name of the Symas Corporation nor the names of its | |
| contributors may be used to endorse or promote products derived from | |
| this software without specific prior written permission. | |
| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
| "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
| LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
| A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
| OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
| SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
| LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
| DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
| THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
| OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| .Ed |