bionic (3) Ns_ConnGetStatus.3aolserver.gz

NAME

       Ns_ConnGetStatus, Ns_ConnSetStatus - Routines to manage the HTTP response status

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnGetStatus(conn)

       void
       Ns_ConnSetStatus(conn, status)

ARGUMENTS

       Ns_Conn   conn   (in)      Pointer to open connection.

       int       status (in)      Integer HTTP status code.
_________________________________________________________________

DESCRIPTION

       These  routines  manage  the  HTTP  response  code  sent to the client in a later call to Ns_ConnFlush or
       Ns_ConnFlushDirect.  Higher level routines such  as  the  Ns_ConnReturn  functions  normally  call  these
       routines  automatically  using standard HTTP status codes and the Ns_ConnQueueHeaders routine can be used
       to set the status code for lower level code which bypasses Ns_ConnFlush.

       int Ns_ConnGetStatus(conn)
              Return the current HTTP status to be sent.

       int Ns_ConnSetStatus(conn, status)
              Set the status code to be sent in the response, for example, 200 for a normal  "OK"  response.   A
              later call to Ns_ConnFlush will construct the appropriate HTTP response including the given status
              with the cooresponding string status code.

EXAMPLES

       The following example demonstrates setting an odd status code followed by a call to Ns_ConnFlushDirect to
       send some data:

                Ns_ConnSetStatus(conn, 600);
                Ns_ConnSetType(conn, "text/plain");
                Ns_ConnFlushDirect(conn, "hello", 5, 0);

       The following should provide similar results:

                Ns_ConnSetRequiredHeaders(conn, "text/plain", 5);
                Ns_ConnQueueHeaders(conn, 600);
                Ns_ConnPuts(conn, "hello");
                Ns_ConnClose(conn);

SEE ALSO

       Ns_ConnGetType(3),           Ns_ConnSetType(3),          Ns_ConnFlush(3),          Ns_ConnFlushDirect(3),
       Ns_ConnSetRequiredHeaders(3), Ns_ConnQueueHeaders(3), ns_conn(n)

KEYWORDS

       connectionn, response, status