Ns conn

From AOLserver Wiki
Revision as of 23:53, 3 October 2009 by Akhassin (talk | contribs)
Jump to navigation Jump to search

<manpage>ns_conn</manpage>

NAME

ns_conn - Find information about the current HTTP connection.

SYNOPSIS

ns_conn option ?arg arg ...?

DESCRIPTION

This command is used to retrieve various pieces of information about a connection.
The legal options (which may be abbreviated) are:
  • ns_conn authpassword
Returns the decoded user password from the authorization data.
  • ns_conn authuser
Returns the decoded user name from the authorization data.
  • ns_conn channel
New in 4.5.1: Return a Tcl channel from the current connection. This channel can be used to talk via raw Tcl I/O to the remote client afterwards. Output cannot be mixed with ns_write.
  • ns_conn close
Closes the connection so the script (or ADP) can do any time-consuming processing without making the client wait. If you use ns_conn close in an ADP, streaming should be turned on before closing the connection (i.e. <SCRIPT RUNAT=SERVER STREAM=ON>) or nothing will get sent out at all.
  • ns_conn content ?offset? ?length?
Returns the content of the HTTP request body, optionally a substring of that content starting at offset and extending length characters.
  • ns_conn contentlength
Returns the number of bytes in the content passed in.
  • ns_conn contentsentlength ?bytes?
New in 4.5.1: Query or set the number of octets sent to the client. This command can be used in connection with "ns_conn channel" to adjust the length entry in a log file in cases, the file was sent via raw Tcl I/O.
  • ns_conn copy off len chan
Copies data from the current connection to chan starting at byte off for len bytes?
  • ns_conn driver
Returns the name of the module (nssock or nsssl) that is acting as the communications driver for this connection.
  • ns_conn encoding
Returns the TCL-encoding for the connection which is used to convert the output of ns_write.
  • ns_conn form
Returns any submitted form data as an ns_set. This form data may have been submitted with a POST or appended to the URL in a GET request. Note: ns_conn form is not suitable for multipart formdata file upload widgets.
  • ns_conn headers
Returns all the header data as an ns_set. The keys of the ns_set represent the field names. The case of the returned field names depends on the HeaderCase configuration parameter. By default, HeaderCase is "Preserve", which means case is preserved.
  • ns_conn host
Returns the host part of the URL in the HTTP request.
  • ns_conn isconnected
Returns 1 if you're in a connection thread, and you are therefore allowed to make calls to ns_conn. It returns 0 if you're not in a connection thread (such as when you're in a schedule procedure) and you are not allowed to make calls to ns_conn.
  • ns_conn location
Returns the location string for this virtual server in the form: protocol://hostname[:port] as configured for the driver (may be different from the actual Host header).
  • ns_conn method
Returns the HTTP method, e.g. GET.
  • ns_conn outputheaders
Returns an ns_set that will be used in building the headers that will be sent out when a result is returned to the client. This ns_set can be manipulated like any other ns_set. You can also use this command to write to the set of output headers. For example: ns_set put [ns_conn outputheaders] key value. Keys that exist in the standard set of output headers will be overwritten by user-specified values in this ns_set if any.
  • ns_conn peeraddr
Returns the IP address of the client, i.e. the "other side" of the HTTP connection. The IP address is returned in the form of a string separated with periods (e.g., 155.164.59.75).
  • ns_conn port
Returns the port specified explicitly in the URL of the HTTP request. If the browser does not explicity send the ":port" part of the URL, the port number returned will be 0.
  • ns_conn protocol
Returns the protocol of the URL in the HTTP request (usually unspecified).
  • ns_conn query
Returns any query data that was part of the HTTP request.
  • ns_conn request
Returns the HTTP request line as presented by the client, e.g. GET / HTTP/1.1.
  • ns_conn start
Returns the time the connection request started in "sec:usec" (aka ns_time) format.
  • ns_conn sock
Returns the underlying socket for the connection.
  • ns_conn urlencoding
Returns the TCL-encoding for the connection which is used to convert input forms to proper UTF.
  • ns_conn url
Returns the URL of the HTTP request. This is the portion of the request after the hostname, for example [ns_conn url] on http://aolserver.com/ returns /index.adp.
  • ns_conn urlc
Returns the number of elements (delimited by `/') in the URL of the HTTP request.
  • ns_conn urlv
Returns a list containing the pieces of the URL delimited by `/'.
  • ns_conn version
Returns the version of the HTTP request. This is usually 1.0 or 1.1.

EXAMPLES


SEE ALSO

ns_getform, ns_queryget, ns_time