update release version and regenerate preformatted copies.
[gnash.git] / doc / C / dumpshm.man-xml
blob882fc20b87109f39d5d42b4b80dcf589be3f41ea
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
4   <!ENTITY legal SYSTEM "legal.xml">
5   <!ENTITY appversion "0.8.9">
6   <!ENTITY manrevision "0.1">
7   <!ENTITY date "Feb 2011">
8   <!ENTITY app "<application>Dumpshm</application>">
9   <!ENTITY appname "Dumpshm">
10   <!ENTITY version "0.8">
14 <refentry id="dumpshm">
15 <refmeta>
16 <refentrytitle>dumpshm</refentrytitle>
17 <manvolnum>1</manvolnum>
18 </refmeta>
20 <!-- the refname becomes the output name of the man page -->
21 <refnamediv>
22 <refname>dumpshm</refname>
23 <refpurpose>Gnash LocalConnection Memory Dumper</refpurpose>
24 </refnamediv>
27 <refsynopsisdiv><title>Synopsis</title>
28 <synopsis>
29 dumpshm (options)... (file)...
30 </synopsis>
31 </refsynopsisdiv>
33 <refsect1><title>Description</title>
34 <para>
35   When any SWF player, including the Gnash player,
36   plays a SWF "movie", the movie can contain
37   scripts.  These scripts can call ActionScript classes.  One such class
38   is LocalConnection.  LocalConnection passes objects from one movie to
39   another, via your computer's shared memory system.
40 </para>
42 <para>
43   Dumpshm prints these shared memory segments, which are comprised of
44   a header, and a collection of SWF AMF Objects created by the movie.
45   It is used for debugging (or understanding the operation of) a SWF 
46   movie.
47 </para>
49 <variablelist>
50   <varlistentry>
51     <term>-h</term>
52     <listitem>
53       <para>
54         Print usage info.
55       </para>
56     </listitem>
57   </varlistentry>
59   <varlistentry>
60     <term>-i</term>
61     <listitem>
62       <para>
63         Find the key for an existing memory segment.
64       </para>
65     </listitem>
66   </varlistentry>
68   <varlistentry>
69     <term>-r</term>
70     <listitem>
71       <para>
72         Dump memory segment to the terminal.
73       </para>
74     </listitem>
75   </varlistentry>
77   <varlistentry>
78     <term>-c</term>
79     <listitem>
80       <para>
81         Dump memory segment to a disk file, segment.raw.
82       </para>
83     </listitem>
84   </varlistentry>
86   <varlistentry>
87     <term>-v</term>
88     <listitem>
89       <para>
90         Verbose output.
91       </para>
92     </listitem>
93   </varlistentry>
96 </variablelist>
98 </refsect1>
99 </refentry>