NAME

       Ns_ConnReturnFile - Return a file as a complete response

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnReturnFile(conn, status, type, file)

ARGUMENTS

       Ns_Conn   conn   (in)      Pointer to open connection.

       char      *file  (in)      Pointer to filename string.

       int       status (in)      HTTP status code.

       char      *type  (in)      Pointer to mimetype string.
_________________________________________________________________

DESCRIPTION

       This  routine  is  used  to  generate complete responses, including the HTTP status code specified by the
       status argument and appropriate headers followed by the contents of the  file  specified  with  the  file
       argument.   This routine utilizes the underlying builtin file-server code (aka, "fastpath").  As such, it
       shares the fastpath capabilities to automatically cache pre-read or memory mapped copies of the files and
       can safely support multiple, simultaneous responses.  The following headers are included in the output:

       Last-modified
              Constructed based on the modification time of the given file.

       Content-length
              Constructed based on the size of the give file.

       Content-type
              Constructed with the given type argument.  If type is NULL, the type will be determined  based  on
              the filename using the Ns_GetMimeType routine

SEE ALSO

       Ns_ConnFlush(3), Ns_ConnReturnOpenFd(3), Ns_GetMimeType(3)

KEYWORDS

       connnection, response

AOLserver                                              4.0                         Ns_ConnReturnFile(3aolserver)