| tventi-mem.3 - plan9port - [fork] Plan 9 from user space | |
| git clone git://src.adamsgaard.dk/plan9port | |
| Log | |
| Files | |
| Refs | |
| README | |
| 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) |