Return to alloc.3 CVS log

Up to [Research Unix] / researchv9 / jtools / man / man3

Annotation of researchv9/jtools/man/man3/alloc.3, revision 1.1.1.1

1.1       root        1: .TH ALLOC 3
                      2: .CT 2 mem_man
                      3: .SH NAME
                      4: alloc, balloc, bfree, gcalloc, gcfree \- allocate memory
                      5: .SH SYNOPSIS
                      6: .B #include <jerq.h>
                      7: .PP
                      8: .B char *alloc(nbytes)
                      9: .B unsigned nbytes;
                     10: .PP
                     11: .B Bitmap *balloc(r)
                     12: .B Rectangle r;
                     13: .PP
                     14: .B void bfree(b)
                     15: .B Bitmap *b;
                     16: .PP
                     17: .B char *gcalloc(nbytes, where)
                     18: .B unsigned long nbytes;
                     19: .B char **where;
                     20: .PP
                     21: .B void gcfree(s)
                     22: .B char *s;
                     23: .SH DESCRIPTION
                     24: .I Alloc
                     25: is equivalent to the standard C function
                     26: .IR calloc ;
                     27: see
                     28: .IR malloc (3).
                     29: It returns a pointer to a block of
                     30: .I nbytes
                     31: contiguous bytes of storage, or 0
                     32: if unavailable.
                     33: The storage is aligned on 4-byte boundaries
                     34: and is cleared to zeros.
                     35: .PP
                     36: .I Balloc
                     37: returns a pointer to a Bitmap
                     38: large enough to contain
                     39: the Rectangle
                     40: .IR r ,
                     41: or 0
                     42: for failure.
                     43: The coordinate system inside the Bitmap is set by
                     44: .IR r :
                     45: the
                     46: .B origin
                     47: and
                     48: .B corner
                     49: of the Bitmap are those of
                     50: .IR r .
                     51: .I Bfree
                     52: frees the storage associated with a Bitmap allocated by
                     53: .IR balloc .
                     54: .PP
                     55: .I Gcalloc
                     56: is also equivalent to the standard C function
                     57: .IR calloc.
                     58: It returns a pointer to a block of
                     59: .I nbytes
                     60: contiguous bytes of storage, or
                     61: 0
                     62: if unavailable.
                     63: The storage is initialized to zeros.
                     64: .I Where
                     65: is a pointer to the user's data where the location of the
                     66: block is to be saved.
                     67: The return value of
                     68: .I gcalloc
                     69: is stored in
                     70: .IR *where .
                     71: .I Gcfree
                     72: is equivalent to
                     73: .IR free .
                     74: .IR p .
                     75: .SH SEE ALSO
                     76: .IR types (5),
                     77: .IR malloc (3)

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