From 9fc2b129167e1f2a16d942369f057f618a00d81c Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 7 Nov 2018 22:18:04 +0100 Subject: Move section 3 man pages to man3/ and add libsimple.h.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/libsimple_encalloc.3 | 154 ----------------------------------------------- 1 file changed, 154 deletions(-) delete mode 100644 man/libsimple_encalloc.3 (limited to 'man/libsimple_encalloc.3') diff --git a/man/libsimple_encalloc.3 b/man/libsimple_encalloc.3 deleted file mode 100644 index a8696e6..0000000 --- a/man/libsimple_encalloc.3 +++ /dev/null @@ -1,154 +0,0 @@ -.TH LIBSIMPLE_ENCALLOC 3 2018-11-03 libsimple -.SH NAME -libsimple_encalloc \- allocate initialised memory or die -.SH SYNOPSIS -.nf -#include - -void *libsimple_encalloc(int \fIstatus\fP, size_t \fIn\fP, size_t \fIm\fP); -static inline void *libsimple_ecalloc(size_t \fIn\fP, size_t \fIm\fP); - -#ifndef encalloc -# define encalloc libsimple_encalloc -#endif -#ifndef ecalloc -# define ecalloc libsimple_ecalloc -#endif -.fi -.PP -Link with -.IR \-lsimple . -.SH DESCRIPTION -The -.BR libsimple_encalloc () -and -.BR libsimple_ecalloc () -functions are wrappers for the -.BR calloc (3) -function, they allocate -.I n*m -zero-initialised 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_encalloc () -and -.BR libsimple_ecalloc () -functions will terminate the process if the memory -cannot be allocated (or if -.I n -or -.I m -is 0 and -.BR calloc (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_encalloc () -function is used or -.IR libsimple_default_failure_exit (3) -if the -.BR libsimple_ecalloc () -function is used. -.PP -The -.BR libsimple_encalloc () -and -.BR libsimple_ecalloc () -functions behaviour is unspecified if -.I n -or -.I m -is 0. -.SH RETURN VALUE -The -.BR libsimple_encalloc () -and -.BR libsimple_ecalloc () -functions return a pointer to the allocated memory -upon success completion; otherwise the process is terminated. -.SH ERRORS -The -.BR libsimple_encalloc () -and -.BR libsimple_ecalloc () -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_encalloc (), -.br -.BR libsimple_ecalloc () -T} Thread safety MT-Safe -T{ -.BR libsimple_encalloc (), -.br -.BR libsimple_ecalloc () -T} Async-signal safety AS-Safe -T{ -.BR libsimple_encalloc (), -.br -.BR libsimple_ecalloc () -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_enmalloc (3), -.BR libsimple_mallocz (3), -.BR libsimple_vmallocn (3), -.BR libsimple_vmalloczn (3), -.BR libsimple_vcallocn (3), -.BR libsimple_enrealloc (3), -.BR libsimple_vreallocn (3), -.BR libsimple_memalign (3), -.BR libsimple_memalignz (3), -.BR libsimple_vmemalignn (3), -.BR libsimple_vmemalignzn (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 libsimple_vmemalloc (3), -.BR libsimple_varrayalloc (3), -.BR calloc (3) -- cgit v1.2.3-70-g09d2