diff options
29 files changed, 562 insertions, 3 deletions
diff --git a/libsimple/strndup.h b/libsimple/strndup.h index 90fbfa1..961b131 100644 --- a/libsimple/strndup.h +++ b/libsimple/strndup.h @@ -4,10 +4,8 @@ # define libsimple_strndupa(s, n)\ ({\ const char *__s = (s);\ - size_t __n = (n);\ - size_t __m = strlen(__s);\ + size_t __n = strnlen(__s, n);\ char *__r;\ - __n = __n < __m ? __n : __m;\ __r = alloca(__n + 1);\ memcpy(__r, __s, __n);\ __r[__n] = '\0';\ diff --git a/man/aligned_memdup.3libsimple b/man/aligned_memdup.3libsimple new file mode 120000 index 0000000..a9c2fef --- /dev/null +++ b/man/aligned_memdup.3libsimple @@ -0,0 +1 @@ +libsimple_aligned_memdup.3
\ No newline at end of file diff --git a/man/aligned_memdupa.3libsimple b/man/aligned_memdupa.3libsimple new file mode 120000 index 0000000..1a50c24 --- /dev/null +++ b/man/aligned_memdupa.3libsimple @@ -0,0 +1 @@ +libsimple_aligned_memdupa.3
\ No newline at end of file diff --git a/man/ealigned_memdup.3libsimple b/man/ealigned_memdup.3libsimple new file mode 120000 index 0000000..f860b87 --- /dev/null +++ b/man/ealigned_memdup.3libsimple @@ -0,0 +1 @@ +libsimple_ealigned_memdup.3
\ No newline at end of file diff --git a/man/ememdup.3libsimple b/man/ememdup.3libsimple new file mode 120000 index 0000000..ea4b242 --- /dev/null +++ b/man/ememdup.3libsimple @@ -0,0 +1 @@ +libsimple_ememdup.3
\ No newline at end of file diff --git a/man/enaligned_memdup.3libsimple b/man/enaligned_memdup.3libsimple new file mode 120000 index 0000000..b6e0dd2 --- /dev/null +++ b/man/enaligned_memdup.3libsimple @@ -0,0 +1 @@ +libsimple_enaligned_memdup.3
\ No newline at end of file diff --git a/man/enmemdup.3libsimple b/man/enmemdup.3libsimple new file mode 120000 index 0000000..b7ce69c --- /dev/null +++ b/man/enmemdup.3libsimple @@ -0,0 +1 @@ +libsimple_enmemdup.3
\ No newline at end of file diff --git a/man/enstrdup.3libsimple b/man/enstrdup.3libsimple new file mode 120000 index 0000000..e8f7b76 --- /dev/null +++ b/man/enstrdup.3libsimple @@ -0,0 +1 @@ +libsimple_enstrdup.3
\ No newline at end of file diff --git a/man/enstrndup.3libsimple b/man/enstrndup.3libsimple new file mode 120000 index 0000000..e2011e0 --- /dev/null +++ b/man/enstrndup.3libsimple @@ -0,0 +1 @@ +libsimple_enstrndup.3
\ No newline at end of file diff --git a/man/estrdup.3libsimple b/man/estrdup.3libsimple new file mode 120000 index 0000000..df20a38 --- /dev/null +++ b/man/estrdup.3libsimple @@ -0,0 +1 @@ +libsimple_estrdup.3
\ No newline at end of file diff --git a/man/estrndup.3libsimple b/man/estrndup.3libsimple new file mode 120000 index 0000000..5c08b65 --- /dev/null +++ b/man/estrndup.3libsimple @@ -0,0 +1 @@ +libsimple_estrndup.3
\ No newline at end of file diff --git a/man/libsimple_aligned_memdup.3 b/man/libsimple_aligned_memdup.3 new file mode 100644 index 0000000..8e18087 --- /dev/null +++ b/man/libsimple_aligned_memdup.3 @@ -0,0 +1,151 @@ +.TH LIBSIMPLE_ALIGNED_MEMDUP 3 2018-10-27 libsimple +.SH NAME +libsimple_aligned_memdup \- duplicate bytes in memory +.SH SYNOPSIS +.nf +#include <libsimple.h> + +void *libsimple_aligned_memdupa(const void *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP); +void *libsimple_aligned_memdup(const void *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP); +void *libsimple_enaligned_memdup(int \fIstatus\fP, const void *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP); +static inline void *libsimple_ealigned_memdup(const void *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP); + +#ifndef aligned_memdupa +# define aligned_memdupa libsimple_aligned_memdupa +#endif +#ifndef aligned_memdup +# define aligned_memdup libsimple_aligned_memdup +#endif +#ifndef enaligned_memdup +# define enaligned_memdup libsimple_enaligned_memdup +#endif +#ifndef ealigned_memdup +# define ealigned_memdup libsimple_ealigned_memdup +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_aligned_memdup () +function constructs allocates memory with the alignment +specified in the +.I alignment +parameter and copies +.I n +first bytes from +.I s +into the new allocation. +.PP +The +.BR libsimple_enaligned_memdup () +and +.BR libsimple_ealigned_memdup () +functions are versions of the +.BR libsimple_aligned_memdup () +function that call the +.BR libsimple_enprintf (3) +function on failure, causing the process to print +an error message and exit. See +.BR libsimple_enprintf (3) +for more information. +.PP +The +.BR libsimple_memdupa () +function is implemented as a macro and is a version +of the +.BR libsimple_memdup () +function that uses allocates the memory on the stack +rather than on the heap, causing the return pointer +to become invalid when the calling function returns. +.SH RETURN VALUE +Upon successful completion, the +.BR libsimple_aligned_memdupa (), +.BR libsimple_aligned_memdup (), +.BR libsimple_enaligned_memdup (), +and +.BR libsimple_ealigned_memdup () +functions return a non-null pointer, on failure the +.BR libsimple_aligned_memdup () +function returns +.B NULL +and set +.I errno +to indicate the error, and the +.BR libsimple_enaligned_memdup (), +and +.BR libsimple_ealigned_memdup () +functions exit the process group. The +.BR libsimple_aligned_memdupa () +function cannot fail, however the kernel +can kill the process with a +.B SIGSEGV +signal if the memory cannot be allocated. +.PP +The returned pointer should be deallocated when it +is no longer needed, except for the pointer returned +by the +.BR libsimple_aligned_memdupa () +function, it is automatically deallocated when the +calling function returns. +.SH ERRORS +The +.BR libsimple_aligned_memdup () +function may fail for any reason specified for the +.BR aligned_alloc (3) +function. +.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_aligned_memdupa (), +.br +.BR libsimple_aligned_memdup (), +.br +.BR libsimple_enaligned_memdup (), +.br +.BR libsimple_ealigned_memdup (), +T} Thread safety MT-Safe +T{ +.BR libsimple_aligned_memdupa (), +.br +.BR libsimple_aligned_memdup (), +.br +.BR libsimple_enaligned_memdup (), +.br +.BR libsimple_ealigned_memdup (), +T} Async-signal safety AS-Safe +T{ +.BR libsimple_aligned_memdupa (), +.br +.BR libsimple_aligned_memdup (), +.br +.BR libsimple_enaligned_memdup (), +.br +.BR libsimple_ealigned_memdup (), +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_memdup (3), +.BR libsimple_enstrndup (3), +.BR libsimple_enstrdup (3), +.BR strndup (3), +.BR strdup (3) diff --git a/man/libsimple_aligned_memdupa.3 b/man/libsimple_aligned_memdupa.3 new file mode 120000 index 0000000..a9c2fef --- /dev/null +++ b/man/libsimple_aligned_memdupa.3 @@ -0,0 +1 @@ +libsimple_aligned_memdup.3
\ No newline at end of file diff --git a/man/libsimple_ealigned_memdup.3 b/man/libsimple_ealigned_memdup.3 new file mode 120000 index 0000000..b6e0dd2 --- /dev/null +++ b/man/libsimple_ealigned_memdup.3 @@ -0,0 +1 @@ +libsimple_enaligned_memdup.3
\ No newline at end of file diff --git a/man/libsimple_ememdup.3 b/man/libsimple_ememdup.3 new file mode 120000 index 0000000..b7ce69c --- /dev/null +++ b/man/libsimple_ememdup.3 @@ -0,0 +1 @@ +libsimple_enmemdup.3
\ No newline at end of file diff --git a/man/libsimple_enaligned_memdup.3 b/man/libsimple_enaligned_memdup.3 new file mode 120000 index 0000000..a9c2fef --- /dev/null +++ b/man/libsimple_enaligned_memdup.3 @@ -0,0 +1 @@ +libsimple_aligned_memdup.3
\ No newline at end of file diff --git a/man/libsimple_enmemdup.3 b/man/libsimple_enmemdup.3 new file mode 120000 index 0000000..ff9fc97 --- /dev/null +++ b/man/libsimple_enmemdup.3 @@ -0,0 +1 @@ +libsimple_memdup.3
\ No newline at end of file diff --git a/man/libsimple_enstrdup.3 b/man/libsimple_enstrdup.3 new file mode 100644 index 0000000..c65f13e --- /dev/null +++ b/man/libsimple_enstrdup.3 @@ -0,0 +1,119 @@ +.TH LIBSIMPLE_ENSTRDUP 3 2018-10-27 libsimple +.SH NAME +libsimple_enstrdup \- duplicate a string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +char *libsimple_strdupa(const char *\fIs\fP); +char *libsimple_enstrdup(int \fIstatus\fP, const char *\fIs\fP); +static inline char *libsimple_estrdup(const char *\fIs\fP); + +#ifndef strdupa +# define strdupa libsimple_strdupa +#endif +#ifndef enstrdup +# define enstrdup libsimple_enstrdup +#endif +#ifndef estrdup +# define estrdup libsimple_estrdup +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_enstrdup () +and +.BR libsimple_estrdup () +functions are versions of the +.BR strdup (3) +function that call the +.BR libsimple_enprintf (3) +function on failure, causing the process to print +an error message and exit. See +.BR libsimple_enprintf (3) +for more information. +.PP +The +.BR libsimple_strdupa () +function is implemented as a macro and is a version +of the +.BR strdup (3) +function that uses allocates the memory on the stack +rather than on the heap, causing the return pointer +to become invalid when the calling function returns. +.SH RETURN VALUE +Upon successful completion, the +.BR libsimple_strdupa (), +.BR libsimple_enstrdup (), +and +.BR libsimple_estrdup () +functions return a non-null pointer, on failure the +.BR libsimple_enstrdup (), +and +.BR libsimple_estrdup () +functions exit the process group. The +.BR libsimple_strdupa () +function cannot fail, however the kernel +can kill the process with a +.B SIGSEGV +signal if the memory cannot be allocated. +.PP +The returned pointer should be deallocated when it +is no longer needed, except for the pointer returned +by the +.BR libsimple_strdupa () +function, it is automatically deallocated when the +calling function returns. +.SH ERRORS +None. +.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_strdupa (), +.br +.BR libsimple_enstrdup (), +.br +.BR libsimple_estrdup (), +T} Thread safety MT-Safe +T{ +.BR libsimple_strdupa (), +.br +.BR libsimple_enstrdup (), +.br +.BR libsimple_estrdup (), +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strdupa (), +.br +.BR libsimple_enstrdup (), +.br +.BR libsimple_estrdup (), +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_enstrndup (3), +.BR libsimple_memdup (3), +.BR libsimple_aligned_memdup (3), +.BR strndup (3), +.BR strdup (3) diff --git a/man/libsimple_enstrndup.3 b/man/libsimple_enstrndup.3 new file mode 100644 index 0000000..d8d6882 --- /dev/null +++ b/man/libsimple_enstrndup.3 @@ -0,0 +1,119 @@ +.TH LIBSIMPLE_ENSTRNDUP 3 2018-10-27 libsimple +.SH NAME +libsimple_enstrndup \- duplicate the beginning of a string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +char *libsimple_strndupa(const char *\fIs\fP, size_t \fIn\fP); +char *libsimple_enstrndup(int \fIstatus\fP, const char *\fIs\fP, size_t \fIn\fP); +static inline char *libsimple_estrndup(const char *\fIs\fP, size_t \fIn\fP); + +#ifndef strndupa +# define strndupa libsimple_strndupa +#endif +#ifndef enstrndup +# define enstrndup libsimple_enstrndup +#endif +#ifndef estrndup +# define estrndup libsimple_estrndup +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_enstrndup () +and +.BR libsimple_estrndup () +functions are versions of the +.BR strndup (3) +function that call the +.BR libsimple_enprintf (3) +function on failure, causing the process to print +an error message and exit. See +.BR libsimple_enprintf (3) +for more information. +.PP +The +.BR libsimple_strndupa () +function is implemented as a macro and is a version +of the +.BR strndup (3) +function that uses allocates the memory on the stack +rather than on the heap, causing the return pointer +to become invalid when the calling function returns. +.SH RETURN VALUE +Upon successful completion, the +.BR libsimple_strndupa (), +.BR libsimple_enstrndup (), +and +.BR libsimple_estrndup () +functions return a non-null pointer, on failure the +.BR libsimple_enstrndup (), +and +.BR libsimple_estrndup () +functions exit the process group. The +.BR libsimple_strndupa () +function cannot fail, however the kernel +can kill the process with a +.B SIGSEGV +signal if the memory cannot be allocated. +.PP +The returned pointer should be deallocated when it +is no longer needed, except for the pointer returned +by the +.BR libsimple_strndupa () +function, it is automatically deallocated when the +calling function returns. +.SH ERRORS +None. +.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_strndupa (), +.br +.BR libsimple_enstrndup (), +.br +.BR libsimple_estrndup (), +T} Thread safety MT-Safe +T{ +.BR libsimple_strndupa (), +.br +.BR libsimple_enstrndup (), +.br +.BR libsimple_estrndup (), +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strndupa (), +.br +.BR libsimple_enstrndup (), +.br +.BR libsimple_estrndup (), +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_enstrdup (3), +.BR libsimple_memdup (3), +.BR libsimple_aligned_memdup (3), +.BR strndup (3), +.BR strdup (3) diff --git a/man/libsimple_estrdup.3 b/man/libsimple_estrdup.3 new file mode 120000 index 0000000..e8f7b76 --- /dev/null +++ b/man/libsimple_estrdup.3 @@ -0,0 +1 @@ +libsimple_enstrdup.3
\ No newline at end of file diff --git a/man/libsimple_estrndup.3 b/man/libsimple_estrndup.3 new file mode 120000 index 0000000..e2011e0 --- /dev/null +++ b/man/libsimple_estrndup.3 @@ -0,0 +1 @@ +libsimple_enstrndup.3
\ No newline at end of file diff --git a/man/libsimple_memdup.3 b/man/libsimple_memdup.3 new file mode 100644 index 0000000..8aa3586 --- /dev/null +++ b/man/libsimple_memdup.3 @@ -0,0 +1,148 @@ +.TH LIBSIMPLE_MEMDUP 3 2018-10-27 libsimple +.SH NAME +libsimple_memdup \- duplicate bytes in memory +.SH SYNOPSIS +.nf +#include <libsimple.h> + +void *libsimple_memdupa(const void *\fIs\fP, size_t \fIn\fP); +void *libsimple_memdup(const void *\fIs\fP, size_t \fIn\fP); +void *libsimple_enmemdup(int \fIstatus\fP, const void *\fIs\fP, size_t \fIn\fP); +static inline void *libsimple_ememdup(const void *\fIs\fP, size_t \fIn\fP); + +#ifndef memdupa +# define memdupa libsimple_memdupa +#endif +#ifndef memdup +# define memdup libsimple_memdup +#endif +#ifndef enmemdup +# define enmemdup libsimple_enmemdup +#endif +#ifndef ememdup +# define ememdup libsimple_ememdup +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memdup () +function constructs allocates memory and copies +.I n +first bytes from +.I s +into the new allocation. +.PP +The +.BR libsimple_enmemdup () +and +.BR libsimple_ememdup () +functions are versions of the +.BR libsimple_memdup () +function that call the +.BR libsimple_enprintf (3) +function on failure, causing the process to print +an error message and exit. See +.BR libsimple_enprintf (3) +for more information. +.PP +The +.BR libsimple_memdupa () +function is implemented as a macro and is a version +of the +.BR libsimple_memdup () +function that uses allocates the memory on the stack +rather than on the heap, causing the return pointer +to become invalid when the calling function returns. +.SH RETURN VALUE +Upon successful completion, the +.BR libsimple_memdupa (), +.BR libsimple_memdup (), +.BR libsimple_enmemdup (), +and +.BR libsimple_ememdup () +functions return a non-null pointer, on failure the +.BR libsimple_memdup () +function returns +.B NULL +and set +.I errno +to indicate the error, and the +.BR libsimple_enmemdup (), +and +.BR libsimple_ememdup () +functions exit the process group. The +.BR libsimple_memdupa () +function cannot fail, however the kernel +can kill the process with a +.B SIGSEGV +signal if the memory cannot be allocated. +.PP +The returned pointer should be deallocated when it +is no longer needed, except for the pointer returned +by the +.BR libsimple_memdupa () +function, it is automatically deallocated when the +calling function returns. +.SH ERRORS +The +.BR libsimple_memdup () +function may fail for any reason specified for the +.BR alloc (3) +function. +.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_memdupa (), +.br +.BR libsimple_memdup (), +.br +.BR libsimple_enmemdup (), +.br +.BR libsimple_ememdup (), +T} Thread safety MT-Safe +T{ +.BR libsimple_memdupa (), +.br +.BR libsimple_memdup (), +.br +.BR libsimple_enmemdup (), +.br +.BR libsimple_ememdup (), +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memdupa (), +.br +.BR libsimple_memdup (), +.br +.BR libsimple_enmemdup (), +.br +.BR libsimple_ememdup (), +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_aligned_memdup (3), +.BR libsimple_enstrndup (3), +.BR libsimple_enstrdup (3), +.BR strndup (3), +.BR strdup (3) diff --git a/man/libsimple_memdupa.3 b/man/libsimple_memdupa.3 new file mode 120000 index 0000000..ff9fc97 --- /dev/null +++ b/man/libsimple_memdupa.3 @@ -0,0 +1 @@ +libsimple_memdup.3
\ No newline at end of file diff --git a/man/libsimple_strdupa.3 b/man/libsimple_strdupa.3 new file mode 120000 index 0000000..e8f7b76 --- /dev/null +++ b/man/libsimple_strdupa.3 @@ -0,0 +1 @@ +libsimple_enstrdup.3
\ No newline at end of file diff --git a/man/libsimple_strndupa.3 b/man/libsimple_strndupa.3 new file mode 120000 index 0000000..e2011e0 --- /dev/null +++ b/man/libsimple_strndupa.3 @@ -0,0 +1 @@ +libsimple_enstrndup.3
\ No newline at end of file diff --git a/man/memdup.3libsimple b/man/memdup.3libsimple new file mode 120000 index 0000000..ff9fc97 --- /dev/null +++ b/man/memdup.3libsimple @@ -0,0 +1 @@ +libsimple_memdup.3
\ No newline at end of file diff --git a/man/memdupa.3libsimple b/man/memdupa.3libsimple new file mode 120000 index 0000000..9b957e5 --- /dev/null +++ b/man/memdupa.3libsimple @@ -0,0 +1 @@ +libsimple_memdupa.3
\ No newline at end of file diff --git a/man/strdupa.3libsimple b/man/strdupa.3libsimple new file mode 120000 index 0000000..17cc881 --- /dev/null +++ b/man/strdupa.3libsimple @@ -0,0 +1 @@ +libsimple_strdupa.3
\ No newline at end of file diff --git a/man/strndupa.3libsimple b/man/strndupa.3libsimple new file mode 120000 index 0000000..201bc24 --- /dev/null +++ b/man/strndupa.3libsimple @@ -0,0 +1 @@ +libsimple_strndupa.3
\ No newline at end of file |