1 files changed, 62 insertions, 0 deletions
diff --git a/libabort_stracat.3 b/libabort_stracat.3
new file mode 100644
index 0000000..16fe165
--- /dev/null
+++ b/libabort_stracat.3
@@ -0,0 +1,62 @@
+.TH LIBABORT_STRACAT 3 LIBABORT
+.SH NAME
+libabort_stracat \- Append a string with bounds checking
+
+.SH SYNOPSIS
+.nf
+#include <libabort.h>
+
+char *\fBlibabort_stracat\fP(char *\fIdst\fP, const char *\fIsrc\fP, size_t \fIsize\fP);
+
+#if !defined(LIBABORT_NO_SHORTHANDS) && !defined(stracat)
+# define \fBstracat\fP libabort_stracat
+#endif
+.fi
+.PP
+Link with
+.IR -labort .
+
+.SH DESCRIPTION
+The
+.BR libabort_stracat ()
+function appends the NUL terminated string
+.I src
+to the NUL terminated string
+.I dst
+in the buffer
+.IR dst ,
+which is assumed to be
+.I size
+bytes long.
+.PP
+If the concatenated string does not fit in the destination buffer
+(including the terminating NUL byte), or if
+.I dst
+is not NUL terminated within the first
+.I size
+bytes, the
+.BR libabort_stracat ()
+function calls
+.BR abort (3).
+
+.SH RETURN VALUE
+The
+.BR libabort_stracat ()
+function returns
+.IR dst .
+
+.SH ERRORS
+The
+.BR libabort_stracat ()
+function cannot fail.
+
+.SH HISTORY
+The
+.BR libabort_stracat ()
+function added in version 1.0 of
+.BR libabort .
+
+.SH SEE ALSO
+.BR libabort (7),
+.BR libabort_stpacat (3),
+.BR libabort_stracpy (3)