NAME

Sol::Parser - a .sol file reader

SYNOPSIS

  use Sol::Parser;
  my @content = Sol::Parser::parse("settings.sol");
  print join("\n", @content);

DESCRIPTION

Local Shared Object (LSO), sometimes known as flash cookies, is a cookie-like data entity used by Adobe Flash Player. LSOs are stored as files on the local file system with the .sol extension. This module reads a Local Shared Object file and return content as a list.

SOL DATA FORMAT

The SOL files use a binary encoding. It consists of a header and any number of elements. Both header and the elements have variable lengths.

Header

The header has the following structure:

• 6 bytes (discarded)

• 4 bytes that should contain the string 'TSCO'

• 7 bytes (discarded)

• 1 byte that signifies the length of name (X bytes)

• X bytes name

• 4 bytes (discarded)

Element

Each element has the following structure:

• 2 bytes length of element name (Y bytes)

• Y bytes element name

• 1 byte data type

• Z bytes data (depending on the data type)

• 1 byte trailer

TODO

Support XML output

Add support for datatypes date and doublestring.

BUGS

Please report any bugs or feature requests to bug-sol-parser at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Sol-Parser. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

  perldoc Sol::Parser

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Sol-Parser

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Sol-Parser

• CPAN Ratings

  http://cpanratings.perl.org/d/Sol-Parser

• Search CPAN

  http://search.cpan.org/dist/Sol-Parser

SEE ALSO

Local Shared Object

http://en.wikipedia.org/wiki/Local_Shared_Object

Flash coders Wiki doc on .Sol File Format

http://sourceforge.net/docman/?group_id=131628

ALTERNATIVE IMPLEMENTATIONS

http://www.sephiroth.it/python/solreader.php (PHP, by Alessandro Crugnola)

http://osflash.org/s2x (Python, by Aral Balkan)

COPYRIGHT & LICENSE

Copyright 2007 Andreas Faafeng, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Sol::Parser

perl -MCPAN -e shell
install Sol::Parser