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

AOLserver                                              4.0                               Ns_ConnCopy(3aolserver)