<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_STAT(3)</title>
</head>
<body>
<table class="head">
<tr>
<td class="head-ltitle">ZIP_SOURCE_STAT(3)</td>
<td class="head-vol">Library Functions Manual</td>
<td class="head-rtitle">ZIP_SOURCE_STAT(3)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">zip_source_stat</code> —
<span class="Nd">get information about zip_source</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
<p class="Pp">libzip (-lzip)</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="In">#include
<<a class="In">zip.h</a>></code></p>
<p class="Pp"><var class="Ft">int</var>
<br/>
<code class="Fn">zip_source_stat</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
*source</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
*sb</var>);</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The
<a class="permalink" href="#zip_source_stat"><code class="Fn" id="zip_source_stat">zip_source_stat</code></a>()
function obtains information about the zip source
<var class="Ar">source</var></p>
<p class="Pp">The <var class="Ar">sb</var> argument is a pointer to a
<var class="Ft">struct zip_source_stat</var> (shown below), into which
information about the zip source is placed.</p>
<div class="Bd Pp Li">
<pre>struct zip_source_stat {
zip_uint64_t valid; /* which fields have valid values */
const char *name; /* name of the file */
zip_uint64_t index; /* index within archive */
zip_uint64_t size; /* size of file (uncompressed) */
zip_uint64_t comp_size; /* size of file (compressed) */
time_t mtime; /* modification time */
zip_uint32_t crc; /* crc of file data */
zip_uint16_t comp_method; /* compression method used */
zip_uint16_t encryption_method; /* encryption method used */
zip_uint32_t flags; /* reserved for future use */
};</pre>
</div>
The structure pointed to by <var class="Ar">sb</var> must be initialized with
<a class="permalink" href="#zip_stat_init"><code class="Fn" id="zip_stat_init">zip_stat_init</code></a>(<var class="Fa">3</var>)
before calling <code class="Fn">zip_source_stat</code>().
<p class="Pp">The <var class="Ar">valid</var> field of the structure specifies
which other fields are valid. Check if the flag defined by the following
defines are in <var class="Ar">valid</var> before accessing the fields:</p>
<div class="Bd-indent">
<dl class="Bl-tag Bl-compact">
<dt id="ZIP_STAT_NAME"><a class="permalink" href="#ZIP_STAT_NAME"><code class="Dv">ZIP_STAT_NAME</code></a></dt>
<dd><var class="Ar">name</var></dd>
<dt id="ZIP_STAT_INDEX"><a class="permalink" href="#ZIP_STAT_INDEX"><code class="Dv">ZIP_STAT_INDEX</code></a></dt>
<dd><var class="Ar">index</var></dd>
<dt id="ZIP_STAT_SIZE"><a class="permalink" href="#ZIP_STAT_SIZE"><code class="Dv">ZIP_STAT_SIZE</code></a></dt>
<dd><var class="Ar">size</var></dd>
<dt id="ZIP_STAT_COMP_SIZE"><a class="permalink" href="#ZIP_STAT_COMP_SIZE"><code class="Dv">ZIP_STAT_COMP_SIZE</code></a></dt>
<dd><var class="Ar">comp_size</var></dd>
<dt id="ZIP_STAT_MTIME"><a class="permalink" href="#ZIP_STAT_MTIME"><code class="Dv">ZIP_STAT_MTIME</code></a></dt>
<dd><var class="Ar">mtime</var></dd>
<dt id="ZIP_STAT_CRC"><a class="permalink" href="#ZIP_STAT_CRC"><code class="Dv">ZIP_STAT_CRC</code></a></dt>
<dd><var class="Ar">crc</var></dd>
<dt id="ZIP_STAT_COMP_METHOD"><a class="permalink" href="#ZIP_STAT_COMP_METHOD"><code class="Dv">ZIP_STAT_COMP_METHOD</code></a></dt>
<dd><var class="Ar">comp_method</var></dd>
<dt id="ZIP_STAT_ENCRYPTION_METHOD"><a class="permalink" href="#ZIP_STAT_ENCRYPTION_METHOD"><code class="Dv">ZIP_STAT_ENCRYPTION_METHOD</code></a></dt>
<dd><var class="Ar">encryption_method</var></dd>
<dt id="ZIP_STAT_FLAGS"><a class="permalink" href="#ZIP_STAT_FLAGS"><code class="Dv">ZIP_STAT_FLAGS</code></a></dt>
<dd><var class="Ar">flags</var></dd>
</dl>
</div>
<p class="Pp" id="NOTE"><a class="permalink" href="#NOTE"><i class="Em">NOTE</i></a>:
Some fields may only be filled out after all data has been read from the
source, for example the <var class="Ar">crc</var> or
<var class="Ar">size</var> fields.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
VALUES</a></h1>
<p class="Pp">Upon successful completion 0 is returned. Otherwise, -1 is
returned and the error information in <var class="Ar">source</var> is set to
indicate the error.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(5)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp"><code class="Fn">zip_source_stat</code>() was added in libzip
1.0.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp"><span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
<<a class="Mt" href="mailto:wiz@gatalith.at">wiz@gatalith.at</a>></p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
<td class="foot-os">NiH</td>
</tr>
</table>
</body>
</html>