Introduction
------------

DFS-Perl is a perl module interface to DFS internals. It includes both a
simple API to manipulate DFS ACLs, and also methods for accessing DFS
servers, such as the flserver and ftserver. Most aspects of DFS-Perl are
read-only; however, DFS-Perl does allow you to change fileset quotas and
create/delete mount points directly from perl.


Installation
------------

Before installing DFS-Perl, you need to have DCE-Perl installed and
configured on your system.

DCE-Perl is available via CPAN, or via the URL:

http://www.intranet.csupomona.edu/~henson/www/projects/DCE-Perl/


The lastest version of DCE-Perl available as of this writing is 0.17,
which fixes a bug involving foreign ACL types. If you are using an earlier
version of DCE-Perl, please upgrade before proceeding.


Once DCE-Perl has been successfully installed, you need to read the file
README.LIBDCEDFS and verify that libdcedfs.a and the necessary header files
are available on your system. If you are unable to acquire or build an
appropriate libdcedfs.a, you can build an ACL only version of DFS-Perl by
typing "rm DFS.xs; ln -s DFS-crippled.xs DFS.xs" in the distribution
directory, and removing the reference to libdcedfs.a from Makefile.PL
before proceeding.


Once these prerequisites are met, you can build and install DFS-Perl by
running the following commands:

    cd /path/to/DFS-Perl-0.25
    perl Makefile.PL
    make
    make install


Changes
-------

0.25 - Optimized internal ACL data representation to delay registry lookups
      until needed, and cache all lookups to avoid redundant registry
      access. Thanks to Reggie Hunt <[email protected]> for the
      suggestion.

    - The $acl->entry() method now returns an array of ($perms, $status).
      Any existing code must be modified to take this change into
      account. In particular, if you use aclmod, be sure to acquire and
      install version 1.1 (or newer), which has been modified to conform
      with the API change.

    - Added support for foreign ACL types. Thanks much to Reggie Hunt
      <[email protected]> for supplying the code upon which this support
      is based.

    - Ability to build an ACL-only version for those platforms unable to
      acquire or compile libdcedfs.


0.20 - Added ability to pass in an open registry handle to ACL bind method.
      Useful when used in account creation scripts when a connection
      to the master registry is needed. If no handle is supplied, the
      default registry handle will be used.

      Added exception handling for DFS RPCs, and fault tolerance for
      flserver calls.

      New methods:

        -- DCE::DFS::crmount(), for creating mount points

        -- DCE::DFS::delmount(), for deleting mount points

        -- DCE::DFS::aggregate::ftserver(), to acquire an ftserver object
           from an aggregate object

        -- DCE::DFS::fileset::ftserver(), to acquire an ftserver object
           from a fileset object

        -- DCE::DFS::fileset::aggregate(), to acquire an aggregate object
           from a fileset object

      Added skeleton of documentation.

      Minor updates to dfs_usage.pl


0.15 - Beta release including new classes to interface to DFS flservers,
      ftservers, aggregates, and filesets.


0.10 - First publicly released version.


Feedback/Availability
---------------------

Please report any bugs or feature requests to <[email protected]>.

DFS-Perl and DCE-Perl have a mailing list available for discussion and
announcements. To subscribe, send email to <[email protected]>
with a body of "subscribe dce-perl".


The latest version of DFS-Perl is currently available at

http://www.intranet.csupomona.edu/~henson/www/projects/DFS-Perl/

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.