3 files changed, 70 insertions, 1 deletions

diff --git a/Makefile.am b/Makefile.am
index a5d2ce5..9a4cccc 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -83,6 +83,7 @@ man_MANS				= doc/mans/bindletools.1 \
                                           doc/mans/bindle_decode.3 \
                                           doc/mans/bindle_dirname_r.3 \
                                           doc/mans/bindle_enqueue.3 \
+                                          doc/mans/bindle_filetostr.3 \
                                           doc/mans/bindle_peek.3 \
                                           doc/mans/bindle_push.3 \
                                           doc/mans/bindle_refcount.3 \
@@ -131,6 +132,7 @@ EXTRA_DIST				= $(doc_DATA) \
                                           doc/mans/bindle_decode.3.in \
                                           doc/mans/bindle_dirname_r.3.in \
                                           doc/mans/bindle_enqueue.3.in \
+                                          doc/mans/bindle_filetostr.3.in \
                                           doc/mans/bindle_peek.3.in \
                                           doc/mans/bindle_push.3.in \
                                           doc/mans/bindle_refcount.3.in \
@@ -281,6 +283,9 @@ doc/mans/bindle_dirname_r.3: Makefile $(srcdir)/doc/mans/bindle_dirname_r.3.in
 doc/mans/bindle_enqueue.3: Makefile $(srcdir)/doc/mans/bindle_enqueue.3.in
         @$(do_subst_dt)
 
+doc/mans/bindle_filetostr.3: Makefile $(srcdir)/doc/mans/bindle_filetostr.3.in
+        @$(do_subst_dt)
+
 doc/mans/bindle_peek.3: Makefile $(srcdir)/doc/mans/bindle_peek.3.in
         @$(do_subst_dt)
 
diff --git a/TODO.md b/TODO.md
index 5961861..48b68c5 100644
--- a/TODO.md
+++ b/TODO.md
@@ -18,7 +18,6 @@ All rights reserved.
      - write bindletools-urlencoding.1
    * libbindle Man Pages
      - write bindle_debug.3
-     - write bindle_filetostr.3
      - write bindle_get_option.3
      - write bindle_getpass.3
      - write bindle_readline.3
diff --git a/doc/mans/bindle_filetostr.3.in b/doc/mans/bindle_filetostr.3.in
new file mode 100644
index 0000000..4e68f78
--- /dev/null
+++ b/doc/mans/bindle_filetostr.3.in
@@ -0,0 +1,65 @@
+.\"
+.\" Bindle Binaries Tools
+.\" Copyright (C) 2022 David M. Syzdek <david@syzdek.net>.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions are
+.\" met:
+.\"
+.\"    * Redistributions of source code must retain the above copyright
+.\"      notice, this list of conditions and the following disclaimer.
+.\"    * Redistributions in binary form must reproduce the above copyright
+.\"      notice, this list of conditions and the following disclaimer in the
+.\"      documentation and/or other materials provided with the distribution.
+.\"    * Neither the name of David M. Syzdek nor the
+.\"      names of its contributors may be used to endorse or promote products
+.\"      derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+.\" IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+.\" THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DAVID M. SYZDEK BE LIABLE FOR
+.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.TH "BINDLE_STRING" "3" "@RELEASE_MONTH@" "@PACKAGE_NAME@" "Library Functions Manual"
+.SH NAME
+bindle_filetostr - Bindle Binary Tools string routines
+
+.SH LIBRARY
+Bindle Binaries Tools (libbindle, -lbindle)
+
+.SH SYNOPSIS
+.nf
+\fB#include\fR \fB<bindle.h>\fR
+.sp
+.BI "int bindle_filetostr( char * " dst ", const char * " path ", size_t " size " );"
+
+.SH DESCRIPTION
+The \fBbindle_filetostr\fR() function opens the file located at \fIpath\fR and
+copies up to \fIsize\fR - 1 bytes from the file into the buffer pointed to by
+\fIdst\fR.  If the file is smaller than the buffer, the entire file is copied
+into the buffer.
+
+.SH RETURN VALUES
+If successful, the \fBbindle_filetostr\fR() function returns the number of
+bytes copied to the buffer pointed to by \fIdst\fR otherwise errno is set
+and -1 is returned.
+
+.SH SEE ALSO
+.BR bindle_strings (3)
+
+.SH AUTHOR
+David M. Syzdek <david@syzdek.net>
+
+.SH ACKNOWLEDGEMENTS
+\fB@PACKAGE_NAME@\fR is developed and maintained by David M. Syzdek
+<david@syzdek.net>.
+
+.\" end of man page