<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "0.8.9">
  <!ENTITY manrevision "0.1">
  <!ENTITY date "Feb 2011">
  <!ENTITY app "<application>Soldumper</application>">
  <!ENTITY appname "Soldumper">
  <!ENTITY version "0.8">
]
>

<refentry id="soldumper">
<refmeta>
<refentrytitle>soldumper</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>

<!-- the refname becomes the output name of the man page -->
<refnamediv>
<refname>soldumper</refname>
<refpurpose>Gnash Local Shared Object (LSO) File Dumper</refpurpose>
</refnamediv>


<refsynopsisdiv><title>Synopsis</title>
<synopsis>
soldumper (options)... (file)...
</synopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
  Dump information about the .sol files used by the SharedObject
  ActionScript class.
</para>

<para>
  When a SWF player, including Gnash, plays a SWF "movie",
  the movie can contain
  scripts.  These scripts can call ActionScript classes.  One such class
  is SharedObject.  SharedObject creates shared objects, which end up
  stored in your computer's file system.  For example, a SWF game might
  store its score file in a SharedObject; or a privacy-invading SWF
  movie might store "cookies" in a SharedObject.  Before soldumper was
  written, these bits of stored information were hard for users to 
  notice or investigate.

  Soldumper prints these files,
  which are comprised of a header, and a
  collection of SWF AMF Objects that the movie has written in the shared
  object file.
</para>

<variablelist>
  <varlistentry>
    <term>-h</term>
    <listitem>
      <para>
	Print usage info.
      </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term>-l</term>
    <listitem>
      <para>
	List all the .sol files in the default path.
      </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term>-f</term>
    <listitem>
      <para>
	Ignore the global setting, use the current directory for files.
      </para>
    </listitem>
  </varlistentry>


  <varlistentry>
    <term>-v</term>
    <listitem>
      <para>
	Verbose output.
      </para>
    </listitem>
  </varlistentry>


</variablelist>

</refsect1>
</refentry>

