Ns_ConnReturnFile(3)

NAME
Ns_ConnReturnFile - Return a file as a complete response

SYNOPSIS
#include "ns.h"

int
Ns_ConnReturnFile(conn, status, type, file)

ARGUMENTS
Pointer to open connection. Pointer to filename string. HTTP status code. 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