diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/exif.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/exif.1 | 237 |
1 files changed, 237 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/exif.1 b/upstream/debian-bookworm/man1/exif.1 new file mode 100644 index 00000000..9029211a --- /dev/null +++ b/upstream/debian-bookworm/man1/exif.1 @@ -0,0 +1,237 @@ +.\" Copyright © 2002-2012 by Thomas Pircher (tehpeh at gmx dot net), +.\" Dan Fandrich et. al. +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" License. +.\" +.TH exif 1 "2012-07-13" "exif 0.6.21.1" "command line front-end to libexif" +.SH "NAME" +exif \- shows EXIF information in JPEG files +.SH "SYNOPSIS" +.BI "exif [ " "OPTION" " ] [ " "file..." " ]" +.SH DESCRIPTION +.B "exif" +is a small command-line utility to show and change EXIF information in JPEG +files. +.PP +Most digital cameras produce EXIF files, which are JPEG files with extra tags +that contain information about the image. The +.B "exif" +command-line utility allows you to read EXIF information from and write EXIF +information to those files. +.B "exif" +internally uses the +.B "libexif" +library. +.PP +Each input file given on the command line is acted upon in turn, using +all the options given. Execution will be aborted immediately if one +file is not readable or does not contain EXIF tags. +.PP +As EXIF tags are read, any unknown ones are discarded and known ones are +automatically converted into the correct format, if they aren't already. +Corrupted MakerNote tags are also removed, but no format changes are made. +.SH "OPTIONS" +.TP +.BI "\-v, \-\-version" +Display the +.B exif +version number. +.TP +.BI "\-i, \-\-ids" +Show ID numbers instead of tag names. +.TP +.BI "\-t, \-\-tag=" "TAG" +Select only this +.IR "TAG" . +.I "TAG" +is the tag title, the short tag name, or the tag number +(hexadecimal numbers are prefixed with 0x), from the IFD specified +with \-\-ifd. The tag title is dependent on the current locale, whereas +name and number are locale-independent. +.TP +.BI "\-\-ifd=" "IFD" +Select a tag or tags from this +.IR "IFD" . +Valid IFDs are "0", "1", "EXIF", "GPS", and "Interoperability". +Defaults to "0". +.TP +.BI "\-l, \-\-list\-tags" +List all known EXIF tags and IFDs. A JPEG image must be provided, and +those tags which appear in the file are shown with an asterisk in the +corresponding position in the list. +.TP +.BI "\-|, \-\-show\-mnote" +Show the contents of the MakerNote tag. The contents of this tag are nonstandard +(and often undocumented) and may therefore not be recognized, or if they are +recognized they may not necessarily be interpreted correctly. +.TP +.BI "\-\-remove" +Remove the tag or (if no tag is specified) the entire IFD. +.TP +.BI "\-s, \-\-show\-description" +Show description of tag. The \-\-tag option must also be given. +.TP +.BI "\-e, \-\-extract\-thumbnail" +Extract the thumbnail, writing the thumbnail image to the file specified +with \-\-output. +.TP +.BI "\-r, \-\-remove\-thumbnail" +Remove the thumbnail from the image, writing the new image to the file specified +with \-\-output. +.TP +.BI "-n, \-\-insert\-thumbnail=" "FILE" +Insert +.I "FILE" +as thumbnail. No attempt is made to ensure that the contents of +.I "FILE" +are in a valid thumbnail format. +.TP +.BI "\-\-no-fixup" +Do not attempt to fix EXIF specification violations when reading tags. +When used in conjunction with \-\-create-exif, this option inhibits the +creation of the mandatory tags. +.B exif +will otherwise remove illegal or unknown tags, add some mandatory tags using +default values, and change the data type of some tags to match that required +by the specification. +.TP +.BI "\-o, \-\-output=" "FILE" +Write output image to +.IR "FILE" . +If this option is not given and an image file must be written, the +name used is the same as the input file with the suffix ".modified.jpeg". +.TP +.BI "\-\-set\-value=" "VALUE" +Set the data for the tag specified with \-\-tag and \-\-ifd to +.IR "VALUE" . +Compound values consisting of multiple components are separated with +spaces. +.TP +.BI "\-c, \-\-create-exif" +Create EXIF data if it does not exist. Mandatory tags are created with +default values unless the \-\-no-fixup option is given. +This option can be used instead of specifying an input file name in most +cases, to operate on the default values of the mandatory set of EXIF tags. +In this case, the \-\-output option has no effect and no file is written. +.TP +.BI "\-m, \-\-machine\-readable" +Produce output in a machine-readable (tab-delimited) format. +The \-\-xml-output and \-\-machine\-readable options are mutually exclusive. +.TP +.BI "\-w, \-\-width=" "N" +Set the maximum width of the output to N characters (default 80). This does +not apply to some output formats (e.g. XML). +.TP +.BI "\-x, \-\-xml-output" +Produce output in an XML format (when possible). +The \-\-xml-output and \-\-machine\-readable options are mutually exclusive. +Note that the XML schema changes with the locale, and it sometimes produces +invalid XML. This option is not recommended. +.TP +.BI "\-d, \-\-debug" +Show debugging messages. Also, when processing a file that contains corrupted +data, this option causes +.B exif +to attempt to continue processing. Normally, +corrupted data causes an abort. +.SS "Help options" +.TP +.BI "\-?, \-\-help" +Show help message. +.TP +.BI "\-\-usage" +Display brief usage message. +.SH "EXAMPLES" +Display all recognized EXIF tags in an image and the tag contents, with bad +tags fixed: +.LP +.RS +exif image.jpg +.RE +.LP +Display a table listing all known EXIF tags and whether each one exists in the +given image: +.LP +.RS +exif \-\-list-tags \-\-no-fixup image.jpg +.RE +.LP +Display details on all XResolution tags found in the given image: +.LP +.RS +exif \-\-tag=XResolution \-\-no-fixup image.jpg +.RE +.LP +Display the raw contents of the "Model" tag in the given image (with a newline +character appended): +.LP +.RS +exif \-\-ifd=0 \-\-tag=Model \-\-machine-readable image.jpg +.RE +.LP +Extract the thumbnail into the file thumbnail.jpg: +.LP +.RS +exif \-\-extract-thumbnail \-\-output=thumbnail.jpg image.jpg +.RE +.LP +Display a list of the numeric values of only the EXIF tags in the thumbnail IFD +(IFD 1) and the tag values: +.LP +.RS +exif \-\-ids \-\-ifd=1 \-\-no-fixup image.jpg +.RE +.LP +Display the meaning of tag 0x9209 in the "EXIF" IFD according to the EXIF +specification: +.LP +.RS +exif \-\-show-description \-\-ifd=EXIF \-\-tag=0x9209 +.RE +.LP +Add an Orientation tag with value "Bottom-left" (4) to an existing image, +leaving the existing tags untouched: +.LP +.RS +exif \-\-output=new.jpg \-\-ifd=0 \-\-tag=0x0112 \-\-set-value=4 \-\-no-fixup image.jpg +.RE +.LP +Add a YCbCr Sub-Sampling tag with value 2,1 (a.k.a YCbCr 4:2:2) to an +existing image and fix the existing tags, if necessary: +.LP +.RS +exif \-\-output=new.jpg \-\-tag=YCbCrSubSampling \-\-ifd=0 \-\-set-value='2 1' image.jpg +.RE +.LP +Remove the "User Comment" tag from an image: +.LP +.RS +exif \-\-output=new.jpg \-\-remove \-\-tag="User Comment" \-\-ifd=EXIF image.jpg +.RE +.LP +Display a table with all known EXIF tags, highlighting mandatory ones: +.LP +.RS +exif \-cl +.RE +.LP +.SH "AUTHOR" +.B exif +was written by Lutz Mueller <lutz@users.sourceforge.net> +and numerous contributors. +This man page is Copyright \(co 2002-2012 Thomas Pircher, +Dan Fandrich and others. +.SH "SEE ALSO" +.UR "https://libexif.github.io/" +.BR "https://libexif.github.io/" |