'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH mapserv 1 "05 February 2024" "" ""
.SH NAME
mapserv \- mapserver CGI interface
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBmapserv\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\*(T<\fB\-v\fR\*(T> | 
[\*(T<\fB\-nh\fR\*(T>]
QUERY_STRING=" \fIQUERY_STRING\fR"
]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBmapserv\fR provides commandline access to the MapServer
CGI interface.
.SH OPTIONS
.TP 
\*(T<\fB\-v\fR\*(T>
Display mapserver version and build options.
.TP 
\*(T<\fB\-nh\fR\*(T>
Suppress HTTP headers.
.TP 
\*(T<\fBQUERY_STRING\fR\*(T>="\fIQUERY_STRING\fR"
CGI QUERY_STRING parameter, e.g. 
QUERY_STRING="MAP=/home/user/wfs.map&SERVICE=WFS&REQUEST=GetCapabilities"
.SH EXAMPLE
The CGI interface can be tested at the commandline by using the "QUERY_STRING" switch, such as:
.PP
.nf
\*(T<
       mapserv "QUERY_STRING=map=/home/user/wms.map&mode=map"
      \*(T>
.fi
.PP
To suppress the HTTP headers, you can use the "\*(T<\fB\-nh\fR\*(T>" switch, such as:
.PP
.nf
\*(T<
       mapserv \-nh "QUERY_STRING=map=/home/user/wms.map&mode=map"
      \*(T>
.fi
.PP
To save the output into an image file, use the pipe command such as:
.PP
.nf
\*(T<
       mapserv \-nh "QUERY_STRING=map=/home/user/wms.map&mode=map" > test.png
      \*(T>
.fi
.SH "SEE ALSO"
.URL http://mapserver.org/cgi/index.html "         MapServer CGI Documentation       "