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