file::mimeinfo::magic(3pm) [debian man page]

File::MimeInfo::Magic(3pm)				User Contributed Perl Documentation				File::MimeInfo::Magic(3pm)

NAME

       File::MimeInfo::Magic - Determine file type with magic

SYNOPSIS

	       use File::MimeInfo::Magic;
	       my $mime_type = mimetype($file);

DESCRIPTION

       This module inherits from File::MimeInfo, it is transparent to its functions but adds support for the freedesktop magic file.

       Magic data is hashed when you need it for the first time.  If you want to force hashing earlier use the "rehash()" function.

EXPORT

       The method "mimetype" is exported by default. The methods "magic", "inodetype", "globs" and "describe" can be exported on demand.

METHODS

       See also File::MimeInfo for methods that are inherited.

       "mimetype($file)"
	   Returns a mime-type string for $file, returns undef on failure.

	   This method bundles "inodetype()", "globs()" and "magic()".

	   Magic rules with an priority of 80 and higher are checked before "globs()" is called, all other magic rules afterwards.

	   If this doesn't work the file is read and the mime-type defaults to 'text/plain' or to 'application/octet-stream' when the first ten
	   chars of the file match ascii control chars (white spaces excluded).  If the file doesn't exist or isn't readable "undef" is returned.

	   If $file is an object reference only "magic" and the default method are used. See below for details.

       "magic($file)"
	   Returns a mime-type string for $file based on the magic rules, returns undef on failure.

	   $file can be an object reference, in that case it is supposed to have a "seek()" and a "read()" method. This allows you for example to
	   determine the mimetype of data in memory by using IO::Scalar.

	   Be aware that when using a filehandle or an "IO::" object you need to set the ":utf8" binmode yourself if apropriate.

       "rehash()"
	   Rehash the data files. Glob and magic information is preparsed when this method is called.

	   If you want to by-pass the XDG basedir system you can specify your database directories by setting @File::MimeInfo::DIRS. But normally
	   it is better to change the XDG basedir environment variables.

       "default"
       "describe"
       "extensions"
       "globs"
       "inodetype"
	   These routines are imported from File::MimeInfo.

SEE ALSO

       File::MimeInfo

LIMITATIONS

       Only word sizes of 1, 2 or 4 are supported. Any other word size is ignored and will cause a warning.

BUGS

       Please mail the author when you encounter any bugs.

AUTHOR

       Jaap Karssenberg <pardus@cpan.org>

       Copyright (c) 2003, 2012 Jaap G Karssenberg. All rights reserved.  This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.14.2							    2012-01-05						File::MimeInfo::Magic(3pm)

Check Out this Related Man Page

File::Type(3pm) 					User Contributed Perl Documentation					   File::Type(3pm)

NAME

       File::Type - determine file type using magic

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://clean-
       code.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.

perl v5.8.8							    2004-10-08							   File::Type(3pm)

Linux and UNIX Man Pages

file::mimeinfo::magic(3pm) [debian man page]

Check Out this Related Man Page