GoServe: READ command

READ command

Syntax:

  READ [BODY|HEADER] {VAR varname | FILE [APPEND] NAME filespec}

Reads (receives) information from an HTTP client. Either the header lines or the body data are read, depending on whether HEADER or BODY was specified, respectively. The default action is to read the body. Then:

If 'VAR varname' was specified, the header or body data are placed in the named Rexx variable, as a single string. The name of the variable is used just as if it appeared in the filter program (for example, the name 'local.j' might have the value of J substituted in the name).
If 'FILE NAME filespec' was specified, the data are written directly to the file named by 'filespec'. 'filespec' should normally be a fully qualified name (if it is not, GoServe will write the file in its working directory). 'filespec' may not include an 'upwards reference' sequence ("..\" or "../"), as such a sequence could possibly allow clients to modify any file on the server machine.
The named file is overwritten unless APPEND is specified (in which case the data are written following the end of any existing data).

The READ command has no effect under the Gopher protocol, or if the client did not send an HTTP/1.0 request (though in both cases the command syntax is checked).

[ previous section | GoServe | next section ]