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).