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.