debian man page for ns_conncopytodstring

Ns_ConnCopy(3aolserver) 				   AOLserver Library Procedures 				   Ns_ConnCopy(3aolserver)

__________________________________________________________________________________________________________________________________________________

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 rou-
       tines 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 con-
       tent 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)