GoServe: HEADER command

HEADER command

Syntax:

  HEADER [NOAUTO] [{ADD|DROP} value]

Adds a header line to the HTTP response header, or drops one already added. Header lines added by this command are sent to the client after header lines generated automatically by GoServe. For example:

  HEADER ADD Title: My own title

Blanks following the keyword ADD or DROP are removed by GoServe, so continuation header lines must be started with the tab ('09'x) character.

If DROP is used, only the field identifier (up to and including the colon) should be specified. The first header line that matches (of the lines added using HEADER ADD) is dropped, together with any following continuation lines; automatically generated header lines are not affected. A case-insensitive comparison is used for determining a match.

NOAUTO may be used either alone on the command or in conjunction with the ADD or DROP form. If any HEADER command specifies NOAUTO, no header lines will be automatically generated by GoServe (except the final empty line); all lines must be explicitly defined using HEADER ADD. For example:

  HEADER NOAUTO ADD Server: Special/0.01
  HEADER        ADD Title: Two-line header

At least one keyword must be used on the HEADER command. The HEADER command has no effect under the Gopher protocol (though the command syntax is checked). It also has no effect if the incoming request uses HTTP/0.9 -- in this case, the protocol does not permit a header to be returned, as it would be treated as part of the data.

[ previous section | GoServe | next section ]