| .TH VENTI-MEM 3 | |
| .SH NAME | |
| vtbrk, | |
| vtmalloc, | |
| vtmallocz, | |
| vtrealloc, | |
| vtstrdup, | |
| vtfree \- error-checking memory allocators | |
| .SH SYNOPSIS | |
| .ft L | |
| #include <u.h> | |
| .br | |
| #include <libc.h> | |
| .br | |
| #include <venti.h> | |
| .ta +\w'\fLvoid* 'u | |
| .PP | |
| .B | |
| void* vtbrk(int size) | |
| .PP | |
| .B | |
| void* vtmalloc(int size) | |
| .PP | |
| .B | |
| void* vtmallocz(int size) | |
| .PP | |
| .B | |
| void* vtrealloc(void *ptr, int size) | |
| .PP | |
| .B | |
| char* vtstrdup(char *s) | |
| .PP | |
| .B | |
| void vtfree(void *ptr) | |
| .SH DESCRIPTION | |
| These routines allocate and free memory. | |
| On failure, they print an error message and call | |
| .IR sysfatal (3). | |
| They do not return. | |
| .PP | |
| .I Vtbrk | |
| returns a pointer to a new block of at least | |
| .I size | |
| bytes. | |
| The block cannot be freed. | |
| .PP | |
| .IR Vtmalloc , | |
| .IR vtrealloc , | |
| and | |
| .I vtstrdup | |
| are like | |
| .IR malloc , | |
| .IR realloc , | |
| and | |
| .IR strdup , | |
| but, as noted above, do not return on error. | |
| .I Vtmallocz | |
| is like | |
| .I vtmalloc | |
| but zeros the block before returning it. | |
| Memory allocated with all four should be freed with | |
| .I vtfree | |
| when no longer needed. | |
| .SH SOURCE | |
| .B \*9/src/libventi | |
| .SH SEE ALSO | |
| .IR venti (3) |