From 46caf26f0047bd91abd480928eba9744a9324135 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 3 Nov 2018 12:21:57 +0100 Subject: More man pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/libsimple_enmalloc.3 | 148 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 man/libsimple_enmalloc.3 (limited to 'man/libsimple_enmalloc.3') diff --git a/man/libsimple_enmalloc.3 b/man/libsimple_enmalloc.3 new file mode 100644 index 0000000..de4ab76 --- /dev/null +++ b/man/libsimple_enmalloc.3 @@ -0,0 +1,148 @@ +.TH LIBSIMPLE_ENMALLOC 3 2018-11-03 libsimple +.SH NAME +libsimple_enmalloc \- allocate memory or die +.SH SYNOPSIS +.nf +#include + +void *libsimple_enmalloc(int \fIstatus\fP, size_t \fIn\fP); +static inline void *libsimple_emalloc(size_t \fIn\fP); + +#ifndef enmalloc +# define enmalloc libsimple_enmalloc +#endif +#ifndef emalloc +# define emalloc libsimple_emalloc +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_enmalloc () +and +.BR libsimple_emalloc () +functions are wrappers for the +.BR malloc (3) +function, they allocate +.I n +uninitialised bytes to the heap and return a +pointer with an alignment of +.I alignof(max_align_t) +to the allocated memory. The function +.BR free (3) +shall be called with the returned pointer as +input when the allocated memory is no longer needed. +.PP +The +.BR libsimple_enmalloc () +and +.BR libsimple_emalloc () +functions will terminate the process if the memory +cannot be allocated (or if +.I n +is 0 and +.BR malloc (3) +returns +.B NULL +when it is used to allocate 0 bytes), by calling the +.BR libsimple_enprintf () +and +.BR libsimple_eprintf () +functions, respectively. +On failure, the process's exit value will be +.I status +if the +.BR libsimple_enmalloc () +function is used or +.IR libsimple_default_failure_exit (3) +if the +.BR libsimple_emalloc () +function is used. +.PP +The +.BR libsimple_enmalloc () +and +.BR libsimple_emalloc () +functions behaviour is unspecified if +.I n +is 0. +.SH RETURN VALUE +The +.BR libsimple_enmalloc () +and +.BR libsimple_emalloc () +functions return a pointer to the allocated memory +upon success completion; otherwise the process is terminated. +.SH ERRORS +The +.BR libsimple_enmalloc () +and +.BR libsimple_emalloc () +functions will terminate the process on failure. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR libsimple_enmalloc (), +.br +.BR libsimple_emalloc () +T} Thread safety MT-Safe env +T{ +.BR libsimple_enmalloc (), +.br +.BR libsimple_emalloc () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_enmalloc (), +.br +.BR libsimple_emalloc () +T} Async-cancel safety AC-Safe +.TE +.SH EXAMPLES +None. +.SH APPLICATION USAGE +None. +.SH RATIONALE +None. +.SH FUTURE DIRECTIONS +None. +.SH NOTES +None, +.SH BUGS +None. +.SH SEE ALSO +.BR libsimple_mallocz (3), +.BR libsimple_vmallocn (3), +.BR libsimple_vmalloczn (3), +.BR libsimple_encalloc (3), +.BR libsimple_vcallocn (3), +.BR libsimple_enrealloc (3), +.BR libsimple_vreallocn (3), +.BR libsimple_vmemalignn (3), +.BR libsimple_vmemalignzn (3), +.BR libsimple_enmemalign (3), +.BR libsimple_memalignz (3), +.BR libsimple_enposix_memalign (3), +.BR libsimple_posix_memalignz (3), +.BR libsimple_vposix_memalignn (3), +.BR libsimple_vposix_memalignzn (3), +.BR libsimple_enaligned_alloc (3), +.BR libsimple_aligned_allocz (3), +.BR libsimple_valigned_allocn (3), +.BR libsimple_valigned_alloczn (3), +.BR libsimple_pvalloc (3), +.BR libsimple_pvallocz (3), +.BR libsimple_vpvallocn (3), +.BR libsimple_vpvalloczn (3), +.BR libsimple_valloc (3), +.BR libsimple_vallocz (3), +.BR libsimple_vvallocn (3), +.BR libsimple_vvalloczn (3), +.BR malloc (3) -- cgit v1.2.3-70-g09d2