This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

MoreFiles(3)                         User Contributed Perl Documentation                        MoreFiles(3)



NAME
       Mac::MoreFiles - Sophisticated file management routines

SYNOPSIS
           use Mac::MoreFiles;

           $application = $Application{"MrPL"};

DESCRIPTION
       Variables


       %Application
           The %Application hash will return the path to the application for a given signature, searching on
           all mounted volumes.

       Functions


       FSpCreateMinimum SPEC
           Create a new file with no creator or file type.  The FSpCreateMinimum function creates a new file
           without attempting to set the the creator and file type of the new file.  This function is needed
           to create a file in an AppleShare "dropbox" where the user can make changes, but cannot see
           folder or files. The FSSpec in SPEC is used to create the file.

       FSpShare SPEC
           Establish a local volume or directory as a share point.  The FSpShare function establishes a
           local volume or directory as a share point. SPEC is an FSSpec record specifying the share point.

       FSpUnshare SPEC
           The FSpUnshare function removes a share point in SPEC.

       FSpFileCopy SRCSPEC, DSTSPEC, COPYNAME, PREFLIGHT
           The FSpFileCopy function duplicates a file and optionally renames it.  Since the PBHCopyFile()
           routine is only available on some AFP server volumes under specific conditions, this routine
           either uses PBHCopyFile(), or does all of the work PBHCopyFile() does.  The SRCSPEC is used to
           determine the location of the file to copy.  The DSTSPEC is used to determine the location of the
           destination directory.  If COPYNAME <> NIL, then it points to the name of the new file.

       FSpDirectoryCopy SRCSPEC, DSTSPEC, PREFLIGHT, [COPYERRHANDLER]
           Make a copy of a directory structure in a new location.  The FSpDirectoryCopy function makes a
           copy of a directory structure in a new location. COPYERRHANDLER is the Perl routine name to
           handle an error, should one arise. It will be called as:

               $bailout = &$COPYERRHANDLER(ERRORCODE,OPERATION,SRCSPEC,DSTSPEC);

       FSpIterateDirectory SPEC, MAXLEVELS, ITERATEFILTER, YOURDATAPTR
           Iterate (scan) through a directory's content.  The FSpIterateDirectory function performs a
           recursive iteration (scan) of the specified directory and calls your ITERATEFILTER function once
           for each file and directory found.

           The MAXLEVELS parameter lets you control how deep the recursion goes.  If MAXLEVELS is 1,
           FSpIterateDirectory only scans the specified directory; if MAXLEVELS is 2, FSpIterateDirectory
           scans the specified directory and one subdirectory below the specified directory; etc. Set
           MAXLEVELS to zero to scan all levels.

           The YOURDATAPTR parameter can point to whatever data structure you might want to access from
           within the ITERATEFILTER. Your filter function will be called as:

               $quit = &$filterFunction(YOURDATAPTR, SPEC);

       FSpDTGetAPPL VOLUME, CREATOR
           The FSpDTGetAPPL function finds an application (file type 'APPL') with the specified CREATOR on
           the specified VOLUME. It first tries to get the application mapping from the desktop database. If
           that fails, then it tries to find an application with the specified creator using the File
           Manager's CatSearch() routine. If that fails, then it tries to find an application in the Desktop
           file.  Returns FSSpec or "undef" on failure.

       FSpDTSetComment SPEC, COMMENT
           The FSpDTSetComment function sets a file or directory's Finder comment field. The volume must
           support the Desktop Manager because you only have read access to the Desktop file.

       FSpDTGetComment SPEC
           The FSpDTGetComment function gets a file or directory's Finder comment field (if any) from the
           Desktop Manager or if the Desktop Manager is not available, from the Finder's Desktop file.
           Returns Str255, or "undef" on failure.

       FSpDTCopyComment SRCSPEC, DSTSPEC
           The FSpDTCopyComment function copies the desktop database comment from the source to the
           destination object.  Both the source and the destination volumes must support the Desktop
           Manager.

AUTHOR
       Written by Matthias Ulrich Neeracher <neeracher@mac.com>, documentation by Bob Dalgleish
       <bob.dalgleish@sasknet.sk.ca>.  Currently maintained by Chris Nandor <pudge@pobox.com>.



perl v5.8.8                                      2007-09-23                                     MoreFiles(3)