NAME

       ns_connsendfp,   ns_respond,   ns_return,   ns_returnadminnotice,   ns_returnbadrequest,  ns_returnerror,
       ns_returnfile, ns_returnforbidden, ns_returnfp,  ns_returnnotfound,  ns_returnnotice,  ns_returnredirect,
       ns_returnunauthorized, ns_write - commands

SYNOPSIS

       ns_connsendfp fp len

       ns_respond

       ns_return status type string

       ns_returnadminnotice status msg ?longmsg?

       ns_returnbadrequest reason

       ns_returnerror status msg

       ns_returnfile status type filename

       ns_returnforbidden

       ns_returnfp status type fileid len

       ns_returnnotfound

       ns_returnnotice status msg ?longmsg?

       ns_returnredirect location

       ns_returnunauthorized

       ns_write string
_________________________________________________________________

DESCRIPTION

       These  procedures provide a simple interface for returning information to the client. They build HTTP/1.0
       headers and send the appropriate data out the socket to the client. The script does not end at  the  time
       ns_return* is invoked so you can continue processing data after the client has gotten the data and closed
       the socket.

       type should be a MIME type (see ns_guesstype manual page for a list).  status  is  a  three-digit  number
       fitting  the pattern below: 1xx Informational - Not used, but reserved for future use.  2xx Success - The
       action was successfully received, understood, and accepted.  3xx Redirection -  Further  action  must  be
       taken  in order to complete the request.  4xx Client Error - The request contains bad syntax or cannot be
       fulfilled.  5xx Server Error - The server failed to fulfill an apparently  valid  request.   Some  common
       status values and their meanings are: 201 Created 202 Accepted 203 Provisional Information 204 No Content
       300 Multiple Choices 301 Moved Permanently  302  Moved  Temporarily  303  Method  304  Not  Modified  401
       Unauthorized  402 Payment Required 403 Forbidden 404 Not Found 405 Method Not Allowed 406 None Acceptable
       407 Proxy Authentication Required 408 Request Time-out 409 Conflict 410 Gone 501 Not Implemented 502  Bad
       Gateway 503 Service Unavailable 504 Gateway Time-out ns_connsendfp
              This function writes len bytes of the specified channel or file to the conn.
       ns_return
              Sends back both the headers and the string.
       ns_returnadminnotice
              Wraps   the   text   msg   and   longmsg   in   some   html,   appends  a  line  with  a  link  to
              "mailto:serveradministrator" based on the virtual server parameter "WebMaster".
       ns_returnbadrequest
              Returns a 400 status code and a formatted HTML message containing the reason text.
       ns_returnerror
              Wraps the text msg in some html and returns that to the client.
       ns_returnfile
              Sends back the headers and the contents of the file.
       ns_returnforbidden
              Returns a 403 status code.
       ns_returnfp
              First sends the appropriate headers.  Next, it writes out the contents of file  from  the  current
              file position until the end of the file.
       ns_returnnotfound
              Returns a 404 status code.
       ns_returnnotice
              Wraps teh text msg and longmsg in some html and returns that to the client.
       ns_returnredirect
              Returns a redirect to the passed in location
       ns_returnunauthorized
              Returns a 401 status code
       ns_write
              Writes  the  string  out  the  connection.  You  can use it instead of the ns_return or ns_respond
              functions to build HTTP responses. AOLserver will not include the  usual  headers  on  the  output
              data. The script does not end at the time ns_write* is invoked so you can continue processing data
              after the client has gotten the data and closed the socket.

SEE ALSO

       ns_respond(n), ns_writefp(n)

KEYWORDS