<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY exam-tt "EXAMPLES">

<!ENTITY cmd "tiffdump">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="tiffdump-1">

<refmeta><refentrytitle>tiffdump</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">26 Mar 2004</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>tiffdump</primary></indexterm><indexterm><primary>display

verbatim information about TIFF files</primary></indexterm>

<refnamediv id="tiffdump-1-name"><refname>tiffdump</refname><refpurpose>display

verbatim information about TIFF files</refpurpose></refnamediv>

<refsynopsisdiv id="tiffdump-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>

options</replaceable></option></arg><arg choice="plain" rep="repeat"><option

role="nodash"><replaceable>input.tif</replaceable></option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="tiffdump-1-desc"><title>&desc-tt;</title>

<para><command>&cmd;</command> displays directory information from files created

according to the Tag Image File Format, Revision 6.0. The header of each TIFF

file (magic number, version, and first directory offset) is displayed, followed

by the tag contents of each directory in the file. For each tag, the name,

datatype, count, and values are displayed. When the symbolic name for a tag

or datatype is known, the symbolic name is displayed followed by the numeric

decimal value. Tag values are displayed enclosed in &ldquo;&lt;>&rdquo; characters

immediately preceded by the value of the count field. For example, an ImageWidth

tag might be displayed as &ldquo;ImageWidth (256) SHORT (3) 1&lt;800>&rdquo;.

</para>

<para><command>&cmd;</command> is particularly useful for investigating the

contents of TIFF files that <filename>libtiff</filename> does not understand.

</para>

</refsect1>

<refsect1 id="tiffdump-1-opts"><title>&opts-tt;</title>

<para>The following options are supported:</para>

<variablelist termlength="narrow">

<varlistentry><term><option>h</option></term><listitem><para>Force numeric

data to be displayed in hexadecimal rather than the default decimal

format.</para>

</listitem></varlistentry>

<varlistentry><term><option>o</option></term><listitem><para>Dump the contents

of the IFD at a particular file offset. The file offset may be specified using

the usual C-style syntax, that is, a leading &ldquo;0x&rdquo; for hexadecimal

and a leading &ldquo;0&rdquo; for octal.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="tiffdump-1-oper"><title>&oper-tt;</title>

<para>The following operands are supported:</para>

<variablelist termlength="narrow">

<varlistentry><term><option role="nodash"><replaceable>input.tif</replaceable></option></term>

<listitem><para>The name of the TIFF file.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="tiffdump-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>image/library/libtiff</para></entry>

</row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Uncommitted</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="tiffdump-1-also"><title>&also-tt;</title>

<para><citerefentry><refentrytitle>tiffinfo</refentrytitle><manvolnum>1</manvolnum>

</citerefentry>, <citerefentry><refentrytitle>libtiff</refentrytitle><manvolnum>

3</manvolnum></citerefentry></para>

</refsect1>

<refsect1 id="tiffdump-1-note"><title>&note-tt;</title>

<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>

</refsect1>

</refentry>