Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
EXTRACT(1)		    General Commands Manual		    EXTRACT(1)

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 typ-
	       ically of the form .Ijpeg. The minus before the libraryname in-
	       dicates	that  this library should be removed from the existing
	       list.  To run only a few	selected plugins, use -l  in  combina-
	       tion 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	 stan-
	       dard 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 de-
	       fault, all keywords that	are found and not  removed  as	dupli-
	       cates are printed.

       -v      Print the version number	and exit.

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

       -x  type
	       Exclude keywords	of the specified type from the output. By  de-
	       fault,  all  keywords  that are found and not removed as	dupli-
	       cates 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.	libex-
       tractor 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  <chris-
       tian@grothoff.org> and Vidyut Samanta <vids@cs.ucla.edu>.  Use  <libex-
       tractor@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/

libextractor 1.0.0		  Aug 7, 2012			    EXTRACT(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | EXAMPLES | LEGAL NOTICE | BUGS | AUTHORS | AVAILABILITY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=extract&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help