1<!-- Creator : groff version 1.22.4 --> 2<!-- CreationDate: Sun Aug 22 23:03:26 2021 --> 3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 4"http://www.w3.org/TR/html4/loose.dtd"> 5<html> 6<head> 7<meta name="generator" content="groff -Thtml, see www.gnu.org"> 8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 9<meta name="Content-Style" content="text/css"> 10<style type="text/css"> 11 p { margin-top: 0; margin-bottom: 0; vertical-align: top } 12 pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 13 table { margin-top: 0; margin-bottom: 0; vertical-align: top } 14 h1 { text-align: center } 15</style> 16<title></title> 17</head> 18<body> 19 20<hr> 21 22 23<p>ARCHIVE_READ_HEADER(3) BSD Library Functions Manual 24ARCHIVE_READ_HEADER(3)</p> 25 26<p style="margin-top: 1em"><b>NAME</b></p> 27 28 29<p style="margin-left:6%;"><b>archive_read_next_header</b>, 30<b>archive_read_next_header2</b> — functions for 31reading streaming archives</p> 32 33<p style="margin-top: 1em"><b>LIBRARY</b></p> 34 35<p style="margin-left:6%;">Streaming Archive Library 36(libarchive, -larchive)</p> 37 38<p style="margin-top: 1em"><b>SYNOPSIS</b></p> 39 40<p style="margin-left:6%;"><b>#include 41<archive.h></b></p> 42 43<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 44 45 46<p style="margin-left:12%;"><b>archive_read_next_header</b>(<i>struct archive *</i>, 47<i>struct archive_entry **</i>);</p> 48 49<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 50 51 52<p style="margin-left:12%;"><b>archive_read_next_header2</b>(<i>struct archive *</i>, 53<i>struct archive_entry *</i>);</p> 54 55<p style="margin-top: 1em"><b>DESCRIPTION <br> 56archive_read_next_header</b>()</p> 57 58<p style="margin-left:17%;">Read the header for the next 59entry and return a pointer to a struct archive_entry. This 60is a convenience wrapper around 61<b>archive_read_next_header2</b>() that reuses an internal 62struct archive_entry object for each request.</p> 63 64<p><b>archive_read_next_header2</b>()</p> 65 66<p style="margin-left:17%;">Read the header for the next 67entry and populate the provided struct archive_entry.</p> 68 69<p style="margin-top: 1em"><b>RETURN VALUES</b></p> 70 71<p style="margin-left:6%;">These functions return 72<b>ARCHIVE_OK</b> (the operation succeeded), 73<b>ARCHIVE_WARN</b> (the operation succeeded but a 74non-critical error was encountered), <b>ARCHIVE_EOF</b> 75(end-of-archive was encountered), <b>ARCHIVE_RETRY</b> (the 76operation failed but can be retried), and 77<b>ARCHIVE_FATAL</b> (there was a fatal error; the archive 78should be closed immediately).</p> 79 80<p style="margin-top: 1em"><b>ERRORS</b></p> 81 82<p style="margin-left:6%;">Detailed error codes and textual 83descriptions are available from the <b>archive_errno</b>() 84and <b>archive_error_string</b>() functions.</p> 85 86<p style="margin-top: 1em"><b>SEE ALSO</b></p> 87 88<p style="margin-left:6%;">tar(1), archive_read(3), 89archive_read_data(3), archive_read_extract(3), 90archive_read_filter(3), archive_read_format(3), 91archive_read_open(3), archive_read_set_options(3), 92archive_util(3), libarchive(3), tar(5)</p> 93 94<p style="margin-left:6%; margin-top: 1em">BSD 95February 2, 2012 BSD</p> 96<hr> 97</body> 98</html> 99