# # $Id: README,v 0.70 2005/08/09 15:47:00 dankogai Exp $ # NAME MacOSX::File - A collection of modules to manipulate files on MacOS X TIGER As of Mac OS X v10.4 (Tiger), most of these operations with resource fork are supported by the ordinary (cp|mv|rsync). If you are looking for psync, you may as well consider using rsync -E instead. DESCRIPTION MacOSX::File is a collection of modules that allows you to do what binaries in /Developer/Tools allows you to do directly via perl. You can implement your own CpMac, MvMac, GetFileInfo and SetFile without calling these bina- ries. Subroutines defined in MacOSX::File itself Others are defined in other submodules. see SUBMODULES below. EXPORT by default: unlink(), strerr() on request: $OSErr, $CopyErr unlink(@files) Just like CORE::unlink, deletes a list of files. Returns the number of files successfully deleted. In addition to that, MacOSX::File::unlink also attempts to delete '._' files, files used in UFS volume to store Finder attributes and Resouce fork. $cnt = unlink 'a', 'b', 'c'; # deletes 'a', 'b', 'c' # and '._a', '._b', '._c' # and returns 3 if all of them are # unlinked strerr() Return string representation of File Manager errors if any. See MacOSX::File::Constants for details. SUBMODULES MacOSX::File::Catalog - Gets/Sets FSCatalogInfo Attributes MacOSX::File::Copy - copy/move with HFS(+) attributes MacOSX::File::Info - Gets/Sets File Attributes (Subset of ::Catal og) MacOSX::File::Spec - Gets FSSpec Structure SCRIPTS pcpmac - CpMac reimplemented pmvmac - MvMac reimplemented pgetfinfo - GetFileInfo reimplemented psetfinfo - SetFile reimplemented psync - update copy utility, very reason I wrote this module INSTALLATION To install this module, first make sure Developer kit is installed. Then type the following: perl Makefile.PL make make test make install DEPENDENCIES This module requires MacOS X. Develper kit is needed to "make install". COPYRIGHT AND LICENCE Copyright 2002-2003 Dan Kogai <dankogai@dan.co.jp> This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.