Win32-StreamNames version 1.01
==============================


Win32::StreamNames - Perl extension for reading Windows ADS names

SYNOPSIS

    use Win32::StreamNames;
    @streams = StreamNames( $file );
    
    if (@streams)
    {
       ...
    }
    else
    {
       # No Additional Data Stream names
       ...
    }

DESCRIPTION

Additional Data Streams (ADS) were introduced in Windows 2000 with
NTFS 5 (data streams have always been a feature of Windows).
With ADS, a simple file can be extended to include other 
information, and Windows Explorer does just that with its
Summary Information (from the file Properties dialog).

To get at the stream names associated with a file requires a call
to the BackupRead Win32 API, This module provides a simple wrapper
to the API calls.

The only externl function, StreamNames, takes a file or directory 
name as an argument, and returns a list of stream names.  These may
be appended to the original filename to get a fully qualified name,
which may be opened using the usual Perl functions.  

If the specified file or directory cannot be opened then $^E is set   
and an empty list is returned.  Note that an empty list is not
necessarily an error, since a file need not have any additional
streams.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module will only run on Microsoft Windows, and requires a C compiler, a
linker, and a 'make' utility (usually nmake.exe) for installation.

The tests will only run on NTFS5 (available with Windows 2000) or later.

The tests use Win32API::File to check the file system type, which is
bundled with the ActiveState Perl implementation.

COPYRIGHT AND LICENCE

Copyright (C) 2005, 2007 Clive Darke

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

