File: mapserv.1.xml

package info (click to toggle)
mapserver 8.6.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 18,492 kB
  • sloc: ansic: 137,759; cpp: 124,149; python: 3,175; xml: 1,722; yacc: 1,114; cs: 1,001; sh: 836; lex: 778; java: 588; perl: 489; makefile: 383; tcl: 158; ruby: 55
file content (111 lines) | stat: -rw-r--r-- 2,901 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id='mapserv'>

  <refmeta>
    <refentrytitle>mapserv</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>mapserv</refname>
    <refpurpose>mapserver CGI interface</refpurpose>
  </refnamediv>

  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>mapserv</command>
      <group>
        <arg choice='plain'><option>-v</option></arg>
        <arg choice='plain'>
          <arg choice='opt'><option>-nh</option></arg>
          QUERY_STRING="<replaceable>QUERY_STRING</replaceable>"
        </arg>
      </group>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'>
    <title>DESCRIPTION</title>
    <para>
      <command>mapserv</command> provides commandline access to the MapServer
      CGI interface.
    </para>
  </refsect1>

  <refsect1 id='options'>
    <title>OPTIONS</title>
    <variablelist>

      <varlistentry>
        <term><option>-v</option></term>
        <listitem>
          <para>Display mapserver version and build options.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-nh</option></term>
        <listitem>
          <para>Suppress HTTP headers.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>QUERY_STRING</option>="<replaceable>QUERY_STRING</replaceable>"</term>
        <listitem>
          <para>
            CGI QUERY_STRING parameter, e.g. 
            QUERY_STRING="MAP=/home/user/wfs.map&amp;SERVICE=WFS&amp;REQUEST=GetCapabilities"
          </para>
        </listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1 id='example'>
    <title>EXAMPLE</title>

    <informalexample>
      <para>
        The CGI interface can be tested at the commandline by using the "QUERY_STRING" switch, such as:
      </para>

      <screen>
       mapserv "QUERY_STRING=map=/home/user/wms.map&amp;mode=map"
      </screen>
    </informalexample>

    <informalexample>
      <para>
        To suppress the HTTP headers, you can use the "<option>-nh</option>" switch, such as:
      </para>

      <screen>
       mapserv -nh "QUERY_STRING=map=/home/user/wms.map&amp;mode=map"
      </screen>
    </informalexample>

    <informalexample>
      <para>
        To save the output into an image file, use the pipe command such as:
      </para>

      <screen>
       mapserv -nh "QUERY_STRING=map=/home/user/wms.map&amp;mode=map" > test.png
      </screen>
    </informalexample>
  </refsect1>

  <refsect1 id='see-also'>
    <title>SEE ALSO</title>

    <para>
      <ulink url="http://mapserver.org/cgi/index.html">
        <citetitle>MapServer CGI Documentation</citetitle>
      </ulink>
    </para>
  </refsect1>

</refentry>