diff --git a/man/man1/exiv2.1 b/man/man1/exiv2.1 index 5185bd86..656bdc0f 100644 --- a/man/man1/exiv2.1 +++ b/man/man1/exiv2.1 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH EXIV2 1 "August 06, 2021" +.TH EXIV2 1 "August 09, 2021" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -136,59 +136,82 @@ encoding of the comment if necessary. .SH COMMAND SUMMARY .sp 1 .nf -exiv2 [ opt [arg] ]+ [ act ] file ... -.sp 1 -option [arg] long option description --a time --adjust Modify time stamps. [+|-]HH[:MM[:SS[.mmm]]] --b --binary This option is obsolete and should not be used. Reserved for test suite (with option -pC) --c txt --comment JPEG comment string to set in the image ('modify' action). ... --d tgt --delete Delete target(s) for the 'delete' action. ... --D +-n --days Time adjustment by a positive or negative number of days ... --e tgt --extract Extract target(s) for the 'extract' action. --f --force Do not prompt before overwriting existing files ... --F --Force Do not prompt before renaming files (Force rename) ... --g key --grep Only output info for this Exiv2 key --h --help Display help and exit. --i tgt --insert Insert target(s) for the 'insert' action. ... --k --keep Preserve file timestamps when updating files --K key --key Report key. Similar to -g (grep) however key must match exactly. --l dir --location Location (directory) for files to be inserted or extracted. --m cmdfile --modify read commands from cmd-file --M cmd --Modify Command line for the 'modify' action. ... --n enc --encode Charset to decode Exif Unicode user comments. See: man 3 iconv_open --O +-n --months Time adjustment by a positive or negative number of months, ... --p mod --print Print report (common reports) --P flg --Print Print report (fine grained control) --q --quiet Silence warnings and error messages from the Exiv2 library ... --Q lvl --log Set the log-level to 'd'(ebug), 'i'(nfo), 'w'(arning), 'e'(rror) --r fmt --rename Filename format for the 'rename' action. ... --S suf --suffix Use suffix .suf for source files for insert command. --t --timestamp Set the file timestamp according to the Exif create timestamp ... --T --Timestamp Only set the file timestamp according to Exif create timestamp ... --u --unknown Show unknown tags ... --v --verbose verbose --V --version Show the program version and exit. --Y +-n --years Time adjustment by a positive or negative number of years ... -.sp 1 -act pr | ex | in | rm | ad | mo | mv | fi | fc +\fBexiv2\fP [ \fIoption\fP [\fIarg\fP] ]+ [ \fIaction\fP ] \fIfile\fP ... +.sp 1 +Where \fIfile\fP contains image metadata, optionally using a URL prefix (e.g., https://clanmills.com/Stonehenge.jpg) or wildcard pattern (e.g., *.jpg) +.sp 1 +\fBoption\fP [\fIarg\fP] \fBlong option\fP [\fIarg\fP] Description +\fB-a\fP \fItime\fP \fB--adjust\fP \fItime\fP Automatically modify metadata time stamps ... +\fB-b\fP \fB--binary\fP Obsolete and should not be used. Reserved for test suite (with \fB-p\fP\fIC\fP) +\fB-c\fP \fItxt\fP \fB--comment\fP \fItxt\fP JPEG comment string to set in the image. For the 'modify' action ... +\fB-d\fP \fItgt1\fP \fB--delete\fP \fItgt1\fP Delete target(s) for the 'delete' action ... +\fB-D\fP \fI+-n\fP \fB--days\fP \fI+-n\fP Automated adjustment of the days in metadata dates ... +\fB-e\fP \fItgt3\fP \fB--extract\fP \fItgt3\fP Extract target(s) for the 'extract' action ... +\fB-f\fP \fB--force\fP Do not prompt before overwriting existing files ... +\fB-F\fP \fB--Force\fP Do not prompt before renaming files ... +\fB-g\fP \fIstr\fP \fB--grep\fP \fIstr\fP Only output where \fIstr\fP matches in output text ... +\fB-h\fP \fB--help\fP Display help and exit +\fB-i\fP \fItgt2\fP \fB--insert\fP \fItgt2\fP Insert target(s) for the 'insert' action ... +\fB-k\fP \fB--keep\fP Preserve file timestamps when updating files ... +\fB-K\fP \fIkey\fP \fB--key\fP \fIkey\fP Report a key. Similar to \fB-g\fP, however \fIkey\fP must match exactly ... +\fB-l\fP \fIdir\fP \fB--location\fP \fIdir\fP Location (directory) for files to be inserted or extracted ... +\fB-m\fP \fIcmdfile\fP \fB--modify\fP \fIcmdfile\fP Read commands from a file ... +\fB-M\fP \fIcmd\fP \fB--Modify\fP \fIcmd\fP Modify the metadata with the command. For the 'modify' action ... +\fB-n\fP \fIenc\fP \fB--encode\fP \fIenc\fP Charset to decode Exif Unicode user comments ... +\fB-O\fP \fI+-n\fP \fB--months\fP \fI+-n\fP Automated adjustment of the months in metadata dates ... +\fB-p\fP \fImod\fP \fB--print\fP \fImod\fP Print report (common reports) ... +\fB-P\fP \fIflg\fP \fB--Print\fP \fIflg\fP Print report (fine grained control) ... +\fB-q\fP \fB--quiet\fP Silence warnings and error messages ... +\fB-Q\fP \fIlvl\fP \fB--log\fP \fIlvl\fP Set the log-level to 'd'(ebug), 'i'(nfo), 'w'(arning), 'e'(rror) ... +\fB-r\fP \fIfmt\fP \fB--rename\fP \fIfmt\fP Filename format for the 'rename' action ... +\fB-S\fP \fIsuf\fP \fB--suffix\fP \fIsuf\fP Use suffix for source files when using the 'insert' command ... +\fB-t\fP \fB--timestamp\fP Set the file timestamp from Exif metadata. For the 'rename' action ... +\fB-T\fP \fB--Timestamp\fP Only set the file timestamp from Exif metadata. For the 'rename' action ... +\fB-u\fP \fB--unknown\fP Show unknown tags ... +\fB-v\fP \fB--verbose\fP Verbose +\fB-V\fP \fB--version\fP Show the program version and exit ... +\fB-Y\fP \fI+-n\fP \fB--years\fP \fI+-n\fP Automated adjustment of the years in metadata dates ... +.sp 1 +\fIaction\fP pr | ex | in | rm | ad | mo | mv | fi | fc print, extract, insert, delete, adjust, modify, rename, fixiso, fixcom -cmd See "Commands" below. +\fIcmd\fP \fBset | add | del\fP \fIkey\fP [[\fItype\fP] \fIvalue\fP] + (see \fBCommand format\fP) -flg E | I | X | x | g | k | l | n | y | c | s | v | t | h +\fIenc\fP Values defined in \fBiconv_open\fP(3) (e.g., UTF-8) + +\fIflg\fP E | I | X | x | g | k | l | n | y | c | s | v | t | h Exif, IPTC, XMP, num, grp, key, label, name, type, count, size, vanilla, translated, hex -fmt Default format is %Y%m%d_%H%M%S. +\fIfmt\fP Default format: %Y%m%d_%H%M%S + +\fIkey\fP Exiv2 key using the format Family.Group.Tagname (e.g., Exif.Image.Model) -lvl d | i | i | w | e +\fIlvl\fP d | i | w | e debug, info, warning, error -mod s | a | e | t | v | h | i | x | c | p | i | C | R | S | X - summary, all, exif, translated, vanilla, hex, iptc, xmp, comment, preview, +\fImod\fP s | a | e | t | v | h | i | x | c | p | C | R | S | X + summary, all, Exif, translated, vanilla, hex, IPTC, XMP, comment, preview, ICC Profile, Recursive Structure, Simple Structure, raw XMP -tgt a | c | e | i | p | t | x | C | X | XX | - - all, comment, exif, iptc, preview, thumb, xmp, ICC Profile, SideCar, RawXMP, stdin/out +\fIsuf\fP '.' then the file's extension (e.g., '.txt') + +\fItime\fP [+|-]HH[:MM[:SS[.mmm]]] + (Default is \fB+\fP when \fB+\fP/\fB-\fP are missing) + +\fItgt1\fP a | c | e | i | t | x | C | - + all, comment, Exif, IPTC, thumbnail, XMP, ICC Profile, stdin/out + +\fItgt\fP2 a | c | e | i | t | x | C | X | XX | - + all, comment, Exif, IPTC, thumbnail, XMP, ICC Profile, SideCar, Raw XMP, stdin/out + +\fItgt3\fP a e | i | p | t | x | C | X | XX | - + all, Exif, IPTC, preview, thumbnail, XMP, ICC Profile, SideCar, Raw XMP, stdin/out + +\fItype\fP An Exif, IPTC or XMP tag type (e.g., xmpText). See \fBEXIV2 TAGNAMES AND VALUES\fP + +\fI+-n\fP The amount to change in the date (e.g., -3). Default is \fB+\fP when \fB+\fP/\fB-\fP are missing + .fi .ne 40 .SH OPTIONS @@ -622,7 +645,7 @@ Empty lines and lines starting with \fB#\fP in a command file are ignored (comments). Remaining lines are commands as described above. .br .ne 40 -.SH EXIF TAGNAMES AND VALUES +.SH EXIV2 TAGNAMES AND VALUES Exiv2 displays metadata tags and values. .sp 1 The tag is a triplet of Family.Group.Tagname. The following groups are defined for the family Exif: