GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FILE::TYPE (3)

.ds Aq ’

NAME

File::Type - determine file type using magic

CONTENTS

SYNOPSIS



    my $ft = File::Type->new();
   
    # read in data from file to $data, then
    my $type_from_data = $ft->checktype_contents($data);
   
    # alternatively, check file from disk
    my $type_from_file = $ft->checktype_filename($file);

    # convenient method for checking either a file or data
    my $type_1 = $ft->mime_type($file);
    my $type_2 = $ft->mime_type($data);



DESCRIPTION

File::Type uses magic numbers (typically at the start of a file) to determine the MIME type of that file.

File::Type can use either a filename, or file contents, to determine the type of a file.

METHODS

    new

Returns a new File::Type object.

    mime_type($argument)

Takes either data or a filename, determines what it is, and passes the argument through to the relevant method below. If the argument is a directory, returns undef.

    checktype_filename($filename)

Opens $filename (if possible; if not, returns undef) and returns the MIME type of the file.

    checktype_contents($data)

Matches $data against the magic database criteria and returns the MIME type of the file.

TODO

* Add additional magic match criteria

BUGS

None known.

    NOTES

Some magic definitions in the mime-magic file used in the creation of this module vary from those in other apps (eg image/x-png not image/png).

SEE ALSO

File::MMagic and File::MimeInfo perform the same job, but have a number of problems that led to the creation of this module.

File::MMagic inlines a copy of the magic database, and uses a DATA filehandle, which causes problems when running under mod_perl.

File::MimeInfo uses an external magic file, and relies on file extensions rather than magic to determine the mime type.

As a result, File::Type uses a seperate module and script to create the code at the core of this module, which means that there is no need to include a magic database at all, and that it is safe to run under mod_perl.

File::Type::Builder, which generates the code at the heart of this module.

ACKNOWLEDGMENTS

File::Type is built from a mime-magic file from cleancode.org. The original can be found at <http://cleancode.org/cgi-bin/viewcvs.cgi/email/mime-magic.mime?rev=1.1.1.1>.

AUTHOR

Paul Mison <pmison@fotango.com>

COPYRIGHT

Copyright 2003-2004 Fotango Ltd.

LICENSE

Licensed under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 FILE::TYPE (3) 2004-05-06

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.