File Coverage

blib/lib/Win32/Security/NamedObject.pm
Criterion Covered Total %
statement 7 9 77.7
branch n/a
condition n/a
subroutine 3 3 100.0
pod n/a
total 10 12 83.3


line stmt bran cond sub pod time code
1             #############################################################################
2             #
3             # Win32::Security::NamedObject - Security manipulation for named objects
4             #
5             # Author: Toby Ovod-Everett
6             #
7             #############################################################################
8             # Copyright 2003, 2004 Toby Ovod-Everett. All rights reserved
9             #
10             # This program is free software; you can redistribute it and/or modify it
11             # under the same terms as Perl itself.
12             #
13             # For comments, questions, bugs or general interest, feel free to
14             # contact Toby Ovod-Everett at toby@ovod-everett.org
15             #############################################################################
16            
17             =head1 NAME
18            
19             C - Security manipulation for named objects
20            
21             =head1 SYNOPSIS
22            
23             use Win32::Security::NamedObject;
24            
25             my $noFoo = Win32::Security::NamedObject->('FILE', "C:\\Foo\\foo.txt");
26             my $dacl = $noFoo->dacl();
27             print $dacl->dump();
28            
29             =head1 DESCRIPTION
30            
31             This module provide an object-oriented interface for manipulating security
32             information on named objects (i.e. files, registry keys, etc.). Note that, like
33             the rest of C, it currently only provides support for files.
34             It has been architected to eventually support all object types supported by the
35             C Win32 API call. Also, it currently only supports access
36             to the DACL and Owner information - SACL access will come later.
37            
38             =head2 Installation instructions
39            
40             C installs as part of C and
41             depends upon the other modules in the distribution. There are three options for
42             installing this distribution:
43            
44             =over 4
45            
46             =item *
47            
48             Using C or later:
49            
50             Build.PL
51             perl build test
52             perl build install
53            
54             See C for more information about enabling the more extensive test
55             suite.
56            
57             =item *
58            
59             Using the PPM (the file has the extension C<.ppm.zip>) on CPAN and installing
60             under ActivePerl for Win32 by unzipping the C<.ppm.zip> file and then:
61            
62             ppm install Win32-Security.ppd
63            
64             =item *
65            
66             Installing manually by copying the C<*.pm> files in C to
67             C and the C<*.pl> files in C