tventi-mem.3 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tventi-mem.3 (1023B)
       ---
            1 .TH VENTI-MEM 3
            2 .SH NAME
            3 vtbrk,
            4 vtmalloc,
            5 vtmallocz,
            6 vtrealloc,
            7 vtstrdup,
            8 vtfree \- error-checking memory allocators
            9 .SH SYNOPSIS
           10 .ft L
           11 #include <u.h>
           12 .br
           13 #include <libc.h>
           14 .br
           15 #include <venti.h>
           16 .ta +\w'\fLvoid* 'u
           17 .PP
           18 .B
           19 void*        vtbrk(int size)
           20 .PP
           21 .B
           22 void*        vtmalloc(int size)
           23 .PP
           24 .B
           25 void*        vtmallocz(int size)
           26 .PP
           27 .B
           28 void*        vtrealloc(void *ptr, int size)
           29 .PP
           30 .B 
           31 char*        vtstrdup(char *s)
           32 .PP
           33 .B
           34 void        vtfree(void *ptr)
           35 .SH DESCRIPTION
           36 These routines allocate and free memory.
           37 On failure, they print an error message and call
           38 .MR sysfatal (3) .
           39 They do not return.
           40 .PP
           41 .I Vtbrk
           42 returns a pointer to a new, permanently allocated block of at least
           43 .I size
           44 bytes.
           45 .PP
           46 .IR Vtmalloc ,
           47 .IR vtrealloc ,
           48 and
           49 .I vtstrdup
           50 are like
           51 .IR malloc ,
           52 .IR realloc ,
           53 and
           54 .IR strdup ,
           55 but, as noted above, do not return on error.
           56 .I Vtmallocz
           57 is like
           58 .I vtmalloc
           59 but zeros the block before returning it.
           60 Memory allocated with all four should be freed with
           61 .I vtfree
           62 when no longer needed.
           63 .SH SOURCE
           64 .B \*9/src/libventi
           65 .SH SEE ALSO
           66 .MR venti (3)