NAME

       extract - determine meta-information about a file

SYNOPSIS

       extract [ -bgihLmnvV ] [ -l library ] [ -p type ] [ -x type ] file ...

DESCRIPTION

       This manual page documents version 1.0.0 of the extract command.

       extract  tests  each  file  specified  in  the  argument  list  in  an  attempt  to  infer
       meta-information from it.  Each file is subjected to the  meta-data  extraction  libraries
       from libextractor.

       libextractor classifies meta-information (also referred to as keywords) into types. A list
       of all types can be obtained with the -L option.

OPTIONS

       -b      Display the output in BiBTeX format.

       -g      Use grep-friendly output (all keywords on a single line for each file).   Use  the
               verbose  option  to  print  the filename first, followed by the keywords.  Use the
               verbose option twice to also display the keyword  types.   This  option  will  not
               print keyword types or non-textual metadata.

       -h      Print a brief summary of the options.

       -i      Run plugins in-process (for debugging).  By default, each plugin is run in its own
               process.

       -l libraries
               Use the specified libraries to extract keywords. The general format  of  libraries
               is  .I  [[-]LIBRARYNAME[:[-]LIBRARYNAME]*]  where  LIBRARYNAME  is  a libextractor
               compatible library and  typically  of  the  form  .Ijpeg.  The  minus  before  the
               libraryname  indicates that this library should be removed from the existing list.
               To run only a few selected plugins, use -l in combination with -n.

       -L      Print a list of all known keyword types.

       -m      Load the file into memory and perform extraction from memory (for debugging).

       -n      Do not use the default set  of  extractors  (typically  all  standard  extractors,
               currently mp3, ogg, jpg, gif, png, tiff, real, html, pdf and mime-types), use only
               the extractors specified with the .B -l option.

       -p  type
               Print only the keywords matching the specified type. By default, all keywords that
               are found and not removed as duplicates are printed.

       -v      Print the version number and exit.

       -V      Be  verbose.   This  option  can be specified multiple times to increase verbosity
               further.

       -x  type
               Exclude keywords of the specified type from the output. By default,  all  keywords
               that are found and not removed as duplicates are printed.

SEE ALSO

       libextractor(3) - description of the libextractor library

EXAMPLES

       $ extract test/test.jpg
       comment - (C) 2001 by Christian Grothoff, using gimp 1.2 1
       mimetype - image/jpeg

       $ extract -V -x comment test/test.jpg
       Keywords for file test/test.jpg:
       mimetype - image/jpeg

       $ extract -p comment test/test.jpg
       comment - (C) 2001 by Christian Grothoff, using gimp 1.2 1

       $ extract -nV -l png.so -p comment test/test.jpg test/test.png
       Keywords for file test/test.jpg:
       Keywords for file test/test.png:
       comment - Testing keyword extraction

LEGAL NOTICE

       libextractor  and  the  extract  tool  are  released under the GPL.  libextractor is a GNU
       package.

BUGS

       A couple of file-formats (on the order of 10^3) are not recognized...

AUTHORS

       extract was originally written by Christian Grothoff <christian@grothoff.org>  and  Vidyut
       Samanta   <vids@cs.ucla.edu>.   Use   <libextractor@gnu.org>   to   contact   the  current
       maintainer(s).

AVAILABILITY

       You     can     obtain     the     original     author's     latest      version      from
       http://www.gnu.org/software/libextractor/