NAME

       Ns_ConnCopyToChannel,  Ns_ConnCopyToDString, Ns_ConnCopyToFd, Ns_ConnCopyToFile - Copy request content to
       open file or dstring

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnCopyToChannel(conn, ncopy, chan)

       int
       Ns_ConnCopyToDString(conn, ncopy, dsPtr)

       int
       Ns_ConnCopyToFd(conn, ncopy, fd)

       int
       Ns_ConnCopyToFile(conn, ncopy, fp)

ARGUMENTS

       Ns_Channel   chan   (in)      Pointer to Tcl channel open for write.

       Ns_Conn      conn   (in)      Pointer to open connection.

       Ns_DString   dsPtr  (in)      Initialized dstring.

       int          fd     (in)      File descriptor open for write.

       FILE         fp     (in)      Stdio FILE pointer open for write.

       int          ncopy  (in)      Number of bytes to copy.
_________________________________________________________________

DESCRIPTION

       These functions copy content from an open connection request to the given  open  file  descriptor,  FILE,
       dstring,  or  Tcl_Channel.   The  routines  work  by copying from the content buffer; see the man page on
       Ns_ConnContent for how this buffer is managed for both small and large requests.

       The functions all return the number of bytes copied which will match the requested ncopy argument  unless
       there  is  an  error writing the content or the requested bytes is greater than the number of bytes still
       available to be read.  An internal offset into the connection is maintained and is shared  with  routines
       such as Ns_ConnRead which also consume content from the same buffer.  Note that routines which access the
       entire content, e.g., Ns_ConnContent, Ns_ConnContentFd,  or  Ns_ConnGetQuery  will  continue  to  provide
       access  to  the  entire  request  regardless if one of the Ns_ConnCopy or Ns_ConnRead functions have been
       used.

EXAMPLES

       The following example demonstrates copying user data to a temp file:

                fd = open("myfile.out", O_WRONLY|O_BINARY);
                len = Ns_ConnContentLength(conn);
                if (Ns_ConnCopyToFd(conn, len, fd) != len) {
                   ... error writing content or content already consumed ...
                }

SEE ALSO

       Ns_ConnRead(3), Ns_ConnReadLine(3), Ns_ConnContent(3), Ns_ConnContentFd(3)

KEYWORDS

       connection, content, read