Debian Codegraph @

upstream/debian-unstable/man1/exif.1

raw
1 .\" Copyright © 2002-2012 by Thomas Pircher (tehpeh at gmx dot net),
2 .\" Dan Fandrich et. al.
3 .\"
4 .\" Permission is granted to make and distribute verbatim copies of this
5 .\" manual provided the copyright notice and this permission notice are
6 .\" preserved on all copies.
7 .\"
8 .\" Permission is granted to copy and distribute modified versions of this
9 .\" manual under the conditions for verbatim copying, provided that the
10 .\" entire resulting derived work is distributed under the terms of a
11 .\" permission notice identical to this one
12 .\"
13 .\" Formatted or processed versions of this manual, if unaccompanied by
14 .\" the source, must acknowledge the copyright and authors of this work.
15 .\" License.
16 .\"
17 .TH exif 1 "2012-07-13" "exif 0.6.21.1" "command line front-end to libexif"
18 .SH "NAME"
19 exif \- shows EXIF information in JPEG files
20 .SH "SYNOPSIS"
21 .BI "exif [ " "OPTION" " ] [ " "file..." " ]"
22 .SH DESCRIPTION
23 .B "exif"
24 is a small command-line utility to show and change EXIF information in JPEG
25 files.
26 .PP
27 Most digital cameras produce EXIF files, which are JPEG files with extra tags
28 that contain information about the image. The
29 .B "exif"
30 command-line utility allows you to read EXIF information from and write EXIF
31 information to those files.
32 .B "exif"
33 internally uses the
34 .B "libexif"
35 library.
36 .PP
37 Each input file given on the command line is acted upon in turn, using
38 all the options given. Execution will be aborted immediately if one
39 file is not readable or does not contain EXIF tags.
40 .PP
41 As EXIF tags are read, any unknown ones are discarded and known ones are
42 automatically converted into the correct format, if they aren't already.
43 Corrupted MakerNote tags are also removed, but no format changes are made.
44 .SH "OPTIONS"
45 .TP
46 .BI "\-v, \-\-version"
47 Display the
48 .B exif
49 version number.
50 .TP
51 .BI "\-i, \-\-ids"
52 Show ID numbers instead of tag names.
53 .TP
54 .BI "\-t, \-\-tag=" "TAG"
55 Select only this
56 .IR "TAG" .
57 .I "TAG"
58 is the tag title, the short tag name, or the tag number
59 (hexadecimal numbers are prefixed with 0x), from the IFD specified
60 with \-\-ifd. The tag title is dependent on the current locale, whereas
61 name and number are locale-independent.
62 .TP
63 .BI "\-\-ifd=" "IFD"
64 Select a tag or tags from this
65 .IR "IFD" .
66 Valid IFDs are "0", "1", "EXIF", "GPS", and "Interoperability".
67 Defaults to "0".
68 .TP
69 .BI "\-l, \-\-list\-tags"
70 List all known EXIF tags and IFDs. A JPEG image must be provided, and
71 those tags which appear in the file are shown with an asterisk in the
72 corresponding position in the list.
73 .TP
74 .BI "\-|, \-\-show\-mnote"
75 Show the contents of the MakerNote tag. The contents of this tag are nonstandard
76 (and often undocumented) and may therefore not be recognized, or if they are
77 recognized they may not necessarily be interpreted correctly.
78 .TP
79 .BI "\-\-remove"
80 Remove the tag or (if no tag is specified) the entire IFD.
81 .TP
82 .BI "\-s, \-\-show\-description"
83 Show description of tag. The \-\-tag option must also be given.
84 .TP
85 .BI "\-e, \-\-extract\-thumbnail"
86 Extract the thumbnail, writing the thumbnail image to the file specified
87 with \-\-output.
88 .TP
89 .BI "\-r, \-\-remove\-thumbnail"
90 Remove the thumbnail from the image, writing the new image to the file specified
91 with \-\-output.
92 .TP
93 .BI "-n, \-\-insert\-thumbnail=" "FILE"
94 Insert
95 .I "FILE"
96 as thumbnail. No attempt is made to ensure that the contents of
97 .I "FILE"
98 are in a valid thumbnail format.
99 .TP
100 .BI "\-\-no-fixup"
101 Do not attempt to fix EXIF specification violations when reading tags.
102 When used in conjunction with \-\-create-exif, this option inhibits the
103 creation of the mandatory tags.
104 .B exif
105 will otherwise remove illegal or unknown tags, add some mandatory tags using
106 default values, and change the data type of some tags to match that required
107 by the specification.
108 .TP
109 .BI "\-o, \-\-output=" "FILE"
110 Write output image to
111 .IR "FILE" .
112 If this option is not given and an image file must be written, the
113 name used is the same as the input file with the suffix ".modified.jpeg".
114 .TP
115 .BI "\-\-set\-value=" "VALUE"
116 Set the data for the tag specified with \-\-tag and \-\-ifd to
117 .IR "VALUE" .
118 Compound values consisting of multiple components are separated with
119 spaces.
120 .TP
121 .BI "\-c, \-\-create-exif"
122 Create EXIF data if it does not exist. Mandatory tags are created with
123 default values unless the \-\-no-fixup option is given.
124 This option can be used instead of specifying an input file name in most
125 cases, to operate on the default values of the mandatory set of EXIF tags.
126 In this case, the \-\-output option has no effect and no file is written.
127 .TP
128 .BI "\-m, \-\-machine\-readable"
129 Produce output in a machine-readable (tab-delimited) format.
130 The \-\-xml-output and \-\-machine\-readable options are mutually exclusive.
131 .TP
132 .BI "\-w, \-\-width=" "N"
133 Set the maximum width of the output to N characters (default 80). This does
134 not apply to some output formats (e.g. XML).
135 .TP
136 .BI "\-x, \-\-xml-output"
137 Produce output in an XML format (when possible).
138 The \-\-xml-output and \-\-machine\-readable options are mutually exclusive.
139 Note that the XML schema changes with the locale, and it sometimes produces
140 invalid XML. This option is not recommended.
141 .TP
142 .BI "\-d, \-\-debug"
143 Show debugging messages. Also, when processing a file that contains corrupted
144 data, this option causes
145 .B exif
146 to attempt to continue processing. Normally,
147 corrupted data causes an abort.
148 .SS "Help options"
149 .TP
150 .BI "\-?, \-\-help"
151 Show help message.
152 .TP
153 .BI "\-\-usage"
154 Display brief usage message.
155 .SH "EXAMPLES"
156 Display all recognized EXIF tags in an image and the tag contents, with bad
157 tags fixed:
158 .LP
159 .RS
160 exif image.jpg
161 .RE
162 .LP
163 Display a table listing all known EXIF tags and whether each one exists in the
164 given image:
165 .LP
166 .RS
167 exif \-\-list-tags \-\-no-fixup image.jpg
168 .RE
169 .LP
170 Display details on all XResolution tags found in the given image:
171 .LP
172 .RS
173 exif \-\-tag=XResolution \-\-no-fixup image.jpg
174 .RE
175 .LP
176 Display the raw contents of the "Model" tag in the given image (with a newline
177 character appended):
178 .LP
179 .RS
180 exif \-\-ifd=0 \-\-tag=Model \-\-machine-readable image.jpg
181 .RE
182 .LP
183 Extract the thumbnail into the file thumbnail.jpg:
184 .LP
185 .RS
186 exif \-\-extract-thumbnail \-\-output=thumbnail.jpg image.jpg
187 .RE
188 .LP
189 Display a list of the numeric values of only the EXIF tags in the thumbnail IFD
190 (IFD 1) and the tag values:
191 .LP
192 .RS
193 exif \-\-ids \-\-ifd=1 \-\-no-fixup image.jpg
194 .RE
195 .LP
196 Display the meaning of tag 0x9209 in the "EXIF" IFD according to the EXIF
197 specification:
198 .LP
199 .RS
200 exif \-\-show-description \-\-ifd=EXIF \-\-tag=0x9209
201 .RE
202 .LP
203 Add an Orientation tag with value "Bottom-left" (4) to an existing image,
204 leaving the existing tags untouched:
205 .LP
206 .RS
207 exif \-\-output=new.jpg \-\-ifd=0 \-\-tag=0x0112 \-\-set-value=4 \-\-no-fixup image.jpg
208 .RE
209 .LP
210 Add a YCbCr Sub-Sampling tag with value 2,1 (a.k.a YCbCr 4:2:2) to an
211 existing image and fix the existing tags, if necessary:
212 .LP
213 .RS
214 exif \-\-output=new.jpg \-\-tag=YCbCrSubSampling \-\-ifd=0 \-\-set-value='2 1' image.jpg
215 .RE
216 .LP
217 Remove the "User Comment" tag from an image:
218 .LP
219 .RS
220 exif \-\-output=new.jpg \-\-remove \-\-tag="User Comment" \-\-ifd=EXIF image.jpg
221 .RE
222 .LP
223 Display a table with all known EXIF tags, highlighting mandatory ones:
224 .LP
225 .RS
226 exif \-cl
227 .RE
228 .LP
229 .SH "AUTHOR"
230 .B exif
231 was written by Lutz Mueller <[email protected]>
232 and numerous contributors.
233 This man page is Copyright \(co 2002-2012 Thomas Pircher,
234 Dan Fandrich and others.
235 .SH "SEE ALSO"
236 .UR "https://libexif.github.io/"
237 .BR "https://libexif.github.io/"
238 .UE