diff options
author | Mattias Andrée <maandree@kth.se> | 2018-11-07 22:18:04 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2018-11-07 22:18:04 +0100 |
commit | 9fc2b129167e1f2a16d942369f057f618a00d81c (patch) | |
tree | c15d15d8afc525a423ce0d43d95f676e6e5a2541 /man/libsimple_pvallocz.3 | |
parent | Add arrayalloc man page (diff) | |
download | libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.gz libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.bz2 libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.xz |
Move section 3 man pages to man3/ and add libsimple.h.0
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man/libsimple_pvallocz.3')
-rw-r--r-- | man/libsimple_pvallocz.3 | 179 |
1 files changed, 0 insertions, 179 deletions
diff --git a/man/libsimple_pvallocz.3 b/man/libsimple_pvallocz.3 deleted file mode 100644 index c758fcd..0000000 --- a/man/libsimple_pvallocz.3 +++ /dev/null @@ -1,179 +0,0 @@ -.TH LIBSIMPLE_PVALLOCZ 3 2018-11-03 libsimple -.SH NAME -libsimple_pvallocz \- allocate optionally initialised memory with page size alignment -.SH SYNOPSIS -.nf -#include <libsimple.h> - -static inline void *libsimple_pvallocz(int \fIclear\fP, size_t \fIn\fP); -static inline void *libsimple_enpvallocz(int \fIstatus\fP, int \fIclear\fP, size_t \fIn\fP); -static inline void *libsimple_epvallocz(int \fIclear\fP, size_t \fIn\fP); - -#ifndef pvallocz -# define pvallocz libsimple_pvallocz -#endif -#ifndef enpvallocz -# define enpvallocz libsimple_enpvallocz -#endif -#ifndef epvallocz -# define epvallocz libsimple_epvallocz -#endif -.fi -.PP -Link with -.IR \-lsimple . -.SH DESCRIPTION -The -.BR libsimple_pvallocz (), -.BR libsimple_enpvallocz (), -and -.BR libsimple_epvallocz () -functions allocate -.I n -bytes, rounded up to the next multiple of the page size, -to the heap and return a pointer with an alignment of -the page size to the allocated memory. The memory will be -initialised with zeroes if -.I clear -is a non-zero value. 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_enpvallocz () -and -.BR libsimple_epvallocz () -functions will terminate the process if the memory -cannot be allocated of if the user tries 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_enpvallocz () -function is used or -.IR libsimple_default_failure_exit (3) -if the -.BR libsimple_epvallocz () -function is used. -.PP -The -.BR libsimple_enpvallocz () -and -.BR libsimple_epvallocz () -functions behaviour is unspecified if -.I n -is 0. -.SH RETURN VALUE -The -.BR libsimple_pvallocz (), -.BR libsimple_enpvallocz (), -and -.BR libsimple_epvallocz () -functions return a pointer to the allocated memory -upon success completion; otherwise the -.BR libsimple_pvallocz () -function return -.B NULL -and set -.I errno -it indicate the error, and the -.BR libsimple_enpvallocz () -and -.BR libsimple_epvallocz () -functions terminated the process. -.SH ERRORS -The -.BR libsimple_pvallocz () -function will fail if: -.TP -.B EINVAL -.I n -is 0. -.TP -.B ENOMEM -Enough memory could not be allocated. -.PP -The -.BR libsimple_enpvallocz () -and -.BR libsimple_epvallocz () -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_pvallocz (), -.br -.BR libsimple_enpvallocz (), -.br -.BR libsimple_epvallocz () -T} Thread safety MT-Safe -T{ -.BR libsimple_pvallocz (), -.br -.BR libsimple_enpvallocz (), -.br -.BR libsimple_epvallocz () -T} Async-signal safety AS-Safe -T{ -.BR libsimple_pvallocz (), -.br -.BR libsimple_enpvallocz (), -.br -.BR libsimple_epvallocz () -T} Async-cancel safety AC-Safe -.TE -.SH EXAMPLES -None. -.SH APPLICATION USAGE -None. -.SH RATIONALE -None. -.SH FUTURE DIRECTIONS -None. -.SH NOTES -The GNU implementation of -.BR pvalloc (3) -is \(dqMT-Unsafe init\(dq. -.SH BUGS -None. -.SH SEE ALSO -.BR libsimple_enmalloc (3), -.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_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_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) |