SREhttp/2 Manual

### SREhttp/2 !Special Commands

SREhttp/2 offers a set of special commands and `special directives`. These are commands and directives are selectors that start with an exclamation point (!), followed by a word or a phrase. That is, they are designed to be invoked (remotely) via your web browser.

The special commands will do a variety of tasks, such a executing TCP/IP actions, computing statistics, and requesting special server actions. The directives modify how SREhttp/2 processes a request.

Examples: |
    /!dir
    /!sendas_text_plain/foo.cmd
    /!reset
    /!ping?clients

### Currently available special commands

!auth
  SREhttp/2 will send back an "authorization" request. The primary users of this will be server administrators -- since a !AUTHORIZE link will repetitively ask for the client's username/password.

!ping?opt
  'PINGS' the client. `Opt` is optional; it can be CLIENTS, PING, or RESPONSETIME/

!statistics
  View current SREhttp/2 statistics.

!HOST?xxx.yyy.zzz.aaa
  Get information on IP address xxx.yyy.zzz.aaa

!reset
  Rereads SRE2003 and SREhttp/2 parameters. Requires SUPERUSER privileges

!lookup_File/sel
  Returns the file name that `sel` would be mapped to.

!dir?dirname
  Invokes SREhttp/2's built in directory lister; which will create a list of all files (and subdirectories) of `dirname`.
  To modify the various display parameters used by !dir, see DIR.TXT

  Notes:

  - The !DIR option of the DEFAULTS parameter also can be used to generate a directory listing.

### Currently available special directives

!force/sel1
  Force resolution of the `sel1` selector. This means that cache entries (both in the request cache and the SSI cache) will not be used.
  In addition, lookup of client privileges will be attemped (even if there are no required privileges for this resource). That is, for this request, ALWAYS_GET_PRIVS=2.

!sendas_mime_submime/sel1
  SREhttp/2 will process the `sel1` selector, and include a `Content-Type: mime/submime` response-header in the response. This overrides the usual methods SREhttp/2 uses to generate of a Content-Type response header.

!verbose=klevel
  For this request, set the VERBOSE parameter to `klevel`. This is useful for debugging (VERBOSE>1 causes a number of status messages to be written to the PMPRINTF window).

In addition, you can include `!special directives` that can be used by pre-response and mid-filter EXEC procedures -- you can use SREH2_FIND_SPECIAL procedure to extract special directives from the original request string (that is provided to these procedures).