plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

venti-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)