archive_write_set_format_pax.c revision 313571
1/*-
2 * Copyright (c) 2003-2007 Tim Kientzle
3 * Copyright (c) 2010-2012 Michihiro NAKAJIMA
4 * Copyright (c) 2016 Martin Matuska
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 *    notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 *    notice, this list of conditions and the following disclaimer in the
14 *    documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS OR
17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 * IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 */
27
28#include "archive_platform.h"
29__FBSDID("$FreeBSD: stable/10/contrib/libarchive/libarchive/archive_write_set_format_pax.c 313571 2017-02-11 00:56:18Z mm $");
30
31#ifdef HAVE_ERRNO_H
32#include <errno.h>
33#endif
34#ifdef HAVE_STDLIB_H
35#include <stdlib.h>
36#endif
37#ifdef HAVE_STRING_H
38#include <string.h>
39#endif
40
41#include "archive.h"
42#include "archive_entry.h"
43#include "archive_entry_locale.h"
44#include "archive_private.h"
45#include "archive_write_private.h"
46
47struct sparse_block {
48	struct sparse_block	*next;
49	int		is_hole;
50	uint64_t	offset;
51	uint64_t	remaining;
52};
53
54struct pax {
55	uint64_t	entry_bytes_remaining;
56	uint64_t	entry_padding;
57	struct archive_string	l_url_encoded_name;
58	struct archive_string	pax_header;
59	struct archive_string	sparse_map;
60	size_t			sparse_map_padding;
61	struct sparse_block	*sparse_list;
62	struct sparse_block	*sparse_tail;
63	struct archive_string_conv *sconv_utf8;
64	int			 opt_binary;
65
66	unsigned flags;
67#define WRITE_SCHILY_XATTR       (1 << 0)
68#define WRITE_LIBARCHIVE_XATTR   (1 << 1)
69};
70
71static void		 add_pax_attr(struct archive_string *, const char *key,
72			     const char *value);
73static void		 add_pax_attr_binary(struct archive_string *,
74			     const char *key,
75			     const char *value, size_t value_len);
76static void		 add_pax_attr_int(struct archive_string *,
77			     const char *key, int64_t value);
78static void		 add_pax_attr_time(struct archive_string *,
79			     const char *key, int64_t sec,
80			     unsigned long nanos);
81static int		 add_pax_acl(struct archive_write *,
82			    struct archive_entry *, struct pax *, int);
83static ssize_t		 archive_write_pax_data(struct archive_write *,
84			     const void *, size_t);
85static int		 archive_write_pax_close(struct archive_write *);
86static int		 archive_write_pax_free(struct archive_write *);
87static int		 archive_write_pax_finish_entry(struct archive_write *);
88static int		 archive_write_pax_header(struct archive_write *,
89			     struct archive_entry *);
90static int		 archive_write_pax_options(struct archive_write *,
91			     const char *, const char *);
92static char		*base64_encode(const char *src, size_t len);
93static char		*build_gnu_sparse_name(char *dest, const char *src);
94static char		*build_pax_attribute_name(char *dest, const char *src);
95static char		*build_ustar_entry_name(char *dest, const char *src,
96			     size_t src_length, const char *insert);
97static char		*format_int(char *dest, int64_t);
98static int		 has_non_ASCII(const char *);
99static void		 sparse_list_clear(struct pax *);
100static int		 sparse_list_add(struct pax *, int64_t, int64_t);
101static char		*url_encode(const char *in);
102
103/*
104 * Set output format to 'restricted pax' format.
105 *
106 * This is the same as normal 'pax', but tries to suppress
107 * the pax header whenever possible.  This is the default for
108 * bsdtar, for instance.
109 */
110int
111archive_write_set_format_pax_restricted(struct archive *_a)
112{
113	struct archive_write *a = (struct archive_write *)_a;
114	int r;
115
116	archive_check_magic(_a, ARCHIVE_WRITE_MAGIC,
117	    ARCHIVE_STATE_NEW, "archive_write_set_format_pax_restricted");
118
119	r = archive_write_set_format_pax(&a->archive);
120	a->archive.archive_format = ARCHIVE_FORMAT_TAR_PAX_RESTRICTED;
121	a->archive.archive_format_name = "restricted POSIX pax interchange";
122	return (r);
123}
124
125/*
126 * Set output format to 'pax' format.
127 */
128int
129archive_write_set_format_pax(struct archive *_a)
130{
131	struct archive_write *a = (struct archive_write *)_a;
132	struct pax *pax;
133
134	archive_check_magic(_a, ARCHIVE_WRITE_MAGIC,
135	    ARCHIVE_STATE_NEW, "archive_write_set_format_pax");
136
137	if (a->format_free != NULL)
138		(a->format_free)(a);
139
140	pax = (struct pax *)calloc(1, sizeof(*pax));
141	if (pax == NULL) {
142		archive_set_error(&a->archive, ENOMEM,
143		    "Can't allocate pax data");
144		return (ARCHIVE_FATAL);
145	}
146	pax->flags = WRITE_LIBARCHIVE_XATTR | WRITE_SCHILY_XATTR;
147
148	a->format_data = pax;
149	a->format_name = "pax";
150	a->format_options = archive_write_pax_options;
151	a->format_write_header = archive_write_pax_header;
152	a->format_write_data = archive_write_pax_data;
153	a->format_close = archive_write_pax_close;
154	a->format_free = archive_write_pax_free;
155	a->format_finish_entry = archive_write_pax_finish_entry;
156	a->archive.archive_format = ARCHIVE_FORMAT_TAR_PAX_INTERCHANGE;
157	a->archive.archive_format_name = "POSIX pax interchange";
158	return (ARCHIVE_OK);
159}
160
161static int
162archive_write_pax_options(struct archive_write *a, const char *key,
163    const char *val)
164{
165	struct pax *pax = (struct pax *)a->format_data;
166	int ret = ARCHIVE_FAILED;
167
168	if (strcmp(key, "hdrcharset")  == 0) {
169		/*
170		 * The character-set we can use are defined in
171		 * IEEE Std 1003.1-2001
172		 */
173		if (val == NULL || val[0] == 0)
174			archive_set_error(&a->archive, ARCHIVE_ERRNO_MISC,
175			    "pax: hdrcharset option needs a character-set name");
176		else if (strcmp(val, "BINARY") == 0 ||
177		    strcmp(val, "binary") == 0) {
178			/*
179			 * Specify binary mode. We will not convert
180			 * filenames, uname and gname to any charsets.
181			 */
182			pax->opt_binary = 1;
183			ret = ARCHIVE_OK;
184		} else if (strcmp(val, "UTF-8") == 0) {
185			/*
186			 * Specify UTF-8 character-set to be used for
187			 * filenames. This is almost the test that
188			 * running platform supports the string conversion.
189			 * Especially libarchive_test needs this trick for
190			 * its test.
191			 */
192			pax->sconv_utf8 = archive_string_conversion_to_charset(
193			    &(a->archive), "UTF-8", 0);
194			if (pax->sconv_utf8 == NULL)
195				ret = ARCHIVE_FATAL;
196			else
197				ret = ARCHIVE_OK;
198		} else
199			archive_set_error(&a->archive, ARCHIVE_ERRNO_MISC,
200			    "pax: invalid charset name");
201		return (ret);
202	}
203
204	/* Note: The "warn" return is just to inform the options
205	 * supervisor that we didn't handle it.  It will generate
206	 * a suitable error if no one used this option. */
207	return (ARCHIVE_WARN);
208}
209
210/*
211 * Note: This code assumes that 'nanos' has the same sign as 'sec',
212 * which implies that sec=-1, nanos=200000000 represents -1.2 seconds
213 * and not -0.8 seconds.  This is a pretty pedantic point, as we're
214 * unlikely to encounter many real files created before Jan 1, 1970,
215 * much less ones with timestamps recorded to sub-second resolution.
216 */
217static void
218add_pax_attr_time(struct archive_string *as, const char *key,
219    int64_t sec, unsigned long nanos)
220{
221	int digit, i;
222	char *t;
223	/*
224	 * Note that each byte contributes fewer than 3 base-10
225	 * digits, so this will always be big enough.
226	 */
227	char tmp[1 + 3*sizeof(sec) + 1 + 3*sizeof(nanos)];
228
229	tmp[sizeof(tmp) - 1] = 0;
230	t = tmp + sizeof(tmp) - 1;
231
232	/* Skip trailing zeros in the fractional part. */
233	for (digit = 0, i = 10; i > 0 && digit == 0; i--) {
234		digit = nanos % 10;
235		nanos /= 10;
236	}
237
238	/* Only format the fraction if it's non-zero. */
239	if (i > 0) {
240		while (i > 0) {
241			*--t = "0123456789"[digit];
242			digit = nanos % 10;
243			nanos /= 10;
244			i--;
245		}
246		*--t = '.';
247	}
248	t = format_int(t, sec);
249
250	add_pax_attr(as, key, t);
251}
252
253static char *
254format_int(char *t, int64_t i)
255{
256	uint64_t ui;
257
258	if (i < 0)
259		ui = (i == INT64_MIN) ? (uint64_t)(INT64_MAX) + 1 : (uint64_t)(-i);
260	else
261		ui = i;
262
263	do {
264		*--t = "0123456789"[ui % 10];
265	} while (ui /= 10);
266	if (i < 0)
267		*--t = '-';
268	return (t);
269}
270
271static void
272add_pax_attr_int(struct archive_string *as, const char *key, int64_t value)
273{
274	char tmp[1 + 3 * sizeof(value)];
275
276	tmp[sizeof(tmp) - 1] = 0;
277	add_pax_attr(as, key, format_int(tmp + sizeof(tmp) - 1, value));
278}
279
280/*
281 * Add a key/value attribute to the pax header.  This function handles
282 * the length field and various other syntactic requirements.
283 */
284static void
285add_pax_attr(struct archive_string *as, const char *key, const char *value)
286{
287	add_pax_attr_binary(as, key, value, strlen(value));
288}
289
290/*
291 * Add a key/value attribute to the pax header.  This function handles
292 * binary values.
293 */
294static void
295add_pax_attr_binary(struct archive_string *as, const char *key,
296		    const char *value, size_t value_len)
297{
298	int digits, i, len, next_ten;
299	char tmp[1 + 3 * sizeof(int)];	/* < 3 base-10 digits per byte */
300
301	/*-
302	 * PAX attributes have the following layout:
303	 *     <len> <space> <key> <=> <value> <nl>
304	 */
305	len = 1 + (int)strlen(key) + 1 + (int)value_len + 1;
306
307	/*
308	 * The <len> field includes the length of the <len> field, so
309	 * computing the correct length is tricky.  I start by
310	 * counting the number of base-10 digits in 'len' and
311	 * computing the next higher power of 10.
312	 */
313	next_ten = 1;
314	digits = 0;
315	i = len;
316	while (i > 0) {
317		i = i / 10;
318		digits++;
319		next_ten = next_ten * 10;
320	}
321	/*
322	 * For example, if string without the length field is 99
323	 * chars, then adding the 2 digit length "99" will force the
324	 * total length past 100, requiring an extra digit.  The next
325	 * statement adjusts for this effect.
326	 */
327	if (len + digits >= next_ten)
328		digits++;
329
330	/* Now, we have the right length so we can build the line. */
331	tmp[sizeof(tmp) - 1] = 0;	/* Null-terminate the work area. */
332	archive_strcat(as, format_int(tmp + sizeof(tmp) - 1, len + digits));
333	archive_strappend_char(as, ' ');
334	archive_strcat(as, key);
335	archive_strappend_char(as, '=');
336	archive_array_append(as, value, value_len);
337	archive_strappend_char(as, '\n');
338}
339
340static void
341archive_write_pax_header_xattr(struct pax *pax, const char *encoded_name,
342    const void *value, size_t value_len)
343{
344	struct archive_string s;
345	char *encoded_value;
346
347	if (pax->flags & WRITE_LIBARCHIVE_XATTR) {
348		encoded_value = base64_encode((const char *)value, value_len);
349
350		if (encoded_name != NULL && encoded_value != NULL) {
351			archive_string_init(&s);
352			archive_strcpy(&s, "LIBARCHIVE.xattr.");
353			archive_strcat(&s, encoded_name);
354			add_pax_attr(&(pax->pax_header), s.s, encoded_value);
355			archive_string_free(&s);
356		}
357		free(encoded_value);
358	}
359	if (pax->flags & WRITE_SCHILY_XATTR) {
360		archive_string_init(&s);
361		archive_strcpy(&s, "SCHILY.xattr.");
362		archive_strcat(&s, encoded_name);
363		add_pax_attr_binary(&(pax->pax_header), s.s, value, value_len);
364		archive_string_free(&s);
365	}
366}
367
368static int
369archive_write_pax_header_xattrs(struct archive_write *a,
370    struct pax *pax, struct archive_entry *entry)
371{
372	int i = archive_entry_xattr_reset(entry);
373
374	while (i--) {
375		const char *name;
376		const void *value;
377		char *url_encoded_name = NULL, *encoded_name = NULL;
378		size_t size;
379		int r;
380
381		archive_entry_xattr_next(entry, &name, &value, &size);
382		url_encoded_name = url_encode(name);
383		if (url_encoded_name != NULL) {
384			/* Convert narrow-character to UTF-8. */
385			r = archive_strcpy_l(&(pax->l_url_encoded_name),
386			    url_encoded_name, pax->sconv_utf8);
387			free(url_encoded_name); /* Done with this. */
388			if (r == 0)
389				encoded_name = pax->l_url_encoded_name.s;
390			else if (errno == ENOMEM) {
391				archive_set_error(&a->archive, ENOMEM,
392				    "Can't allocate memory for Linkname");
393				return (ARCHIVE_FATAL);
394			}
395		}
396
397		archive_write_pax_header_xattr(pax, encoded_name,
398		    value, size);
399
400	}
401	return (ARCHIVE_OK);
402}
403
404static int
405get_entry_hardlink(struct archive_write *a, struct archive_entry *entry,
406    const char **name, size_t *length, struct archive_string_conv *sc)
407{
408	int r;
409
410	r = archive_entry_hardlink_l(entry, name, length, sc);
411	if (r != 0) {
412		if (errno == ENOMEM) {
413			archive_set_error(&a->archive, ENOMEM,
414			    "Can't allocate memory for Linkname");
415			return (ARCHIVE_FATAL);
416		}
417		return (ARCHIVE_WARN);
418	}
419	return (ARCHIVE_OK);
420}
421
422static int
423get_entry_pathname(struct archive_write *a, struct archive_entry *entry,
424    const char **name, size_t *length, struct archive_string_conv *sc)
425{
426	int r;
427
428	r = archive_entry_pathname_l(entry, name, length, sc);
429	if (r != 0) {
430		if (errno == ENOMEM) {
431			archive_set_error(&a->archive, ENOMEM,
432			    "Can't allocate memory for Pathname");
433			return (ARCHIVE_FATAL);
434		}
435		return (ARCHIVE_WARN);
436	}
437	return (ARCHIVE_OK);
438}
439
440static int
441get_entry_uname(struct archive_write *a, struct archive_entry *entry,
442    const char **name, size_t *length, struct archive_string_conv *sc)
443{
444	int r;
445
446	r = archive_entry_uname_l(entry, name, length, sc);
447	if (r != 0) {
448		if (errno == ENOMEM) {
449			archive_set_error(&a->archive, ENOMEM,
450			    "Can't allocate memory for Uname");
451			return (ARCHIVE_FATAL);
452		}
453		return (ARCHIVE_WARN);
454	}
455	return (ARCHIVE_OK);
456}
457
458static int
459get_entry_gname(struct archive_write *a, struct archive_entry *entry,
460    const char **name, size_t *length, struct archive_string_conv *sc)
461{
462	int r;
463
464	r = archive_entry_gname_l(entry, name, length, sc);
465	if (r != 0) {
466		if (errno == ENOMEM) {
467			archive_set_error(&a->archive, ENOMEM,
468			    "Can't allocate memory for Gname");
469			return (ARCHIVE_FATAL);
470		}
471		return (ARCHIVE_WARN);
472	}
473	return (ARCHIVE_OK);
474}
475
476static int
477get_entry_symlink(struct archive_write *a, struct archive_entry *entry,
478    const char **name, size_t *length, struct archive_string_conv *sc)
479{
480	int r;
481
482	r = archive_entry_symlink_l(entry, name, length, sc);
483	if (r != 0) {
484		if (errno == ENOMEM) {
485			archive_set_error(&a->archive, ENOMEM,
486			    "Can't allocate memory for Linkname");
487			return (ARCHIVE_FATAL);
488		}
489		return (ARCHIVE_WARN);
490	}
491	return (ARCHIVE_OK);
492}
493
494/* Add ACL to pax header */
495static int
496add_pax_acl(struct archive_write *a,
497    struct archive_entry *entry, struct pax *pax, int flags)
498{
499	char *p;
500	const char *attr;
501	int acl_types;
502
503	acl_types = archive_entry_acl_types(entry);
504
505	if ((acl_types & ARCHIVE_ENTRY_ACL_TYPE_NFS4) != 0)
506		attr = "SCHILY.acl.ace";
507	else if ((flags & ARCHIVE_ENTRY_ACL_TYPE_ACCESS) != 0)
508		attr = "SCHILY.acl.access";
509	else if ((flags & ARCHIVE_ENTRY_ACL_TYPE_DEFAULT) != 0)
510		attr = "SCHILY.acl.default";
511	else
512		return (ARCHIVE_FATAL);
513
514	p = archive_entry_acl_to_text_l(entry, NULL, flags, pax->sconv_utf8);
515	if (p == NULL) {
516		if (errno == ENOMEM) {
517			archive_set_error(&a->archive, ENOMEM, "%s %s",
518			    "Can't allocate memory for ", attr);
519			return (ARCHIVE_FATAL);
520		}
521		archive_set_error(&a->archive,
522		    ARCHIVE_ERRNO_FILE_FORMAT, "%s %s %s",
523		    "Can't translate ", attr, " to UTF-8");
524		return(ARCHIVE_WARN);
525	} else if (*p != '\0') {
526		add_pax_attr(&(pax->pax_header),
527		    attr, p);
528		free(p);
529	}
530	return(ARCHIVE_OK);
531}
532
533/*
534 * TODO: Consider adding 'comment' and 'charset' fields to
535 * archive_entry so that clients can specify them.  Also, consider
536 * adding generic key/value tags so clients can add arbitrary
537 * key/value data.
538 *
539 * TODO: Break up this 700-line function!!!!  Yowza!
540 */
541static int
542archive_write_pax_header(struct archive_write *a,
543    struct archive_entry *entry_original)
544{
545	struct archive_entry *entry_main;
546	const char *p;
547	const char *suffix;
548	int need_extension, r, ret;
549	int acl_types;
550	int sparse_count;
551	uint64_t sparse_total, real_size;
552	struct pax *pax;
553	const char *hardlink;
554	const char *path = NULL, *linkpath = NULL;
555	const char *uname = NULL, *gname = NULL;
556	const void *mac_metadata;
557	size_t mac_metadata_size;
558	struct archive_string_conv *sconv;
559	size_t hardlink_length, path_length, linkpath_length;
560	size_t uname_length, gname_length;
561
562	char paxbuff[512];
563	char ustarbuff[512];
564	char ustar_entry_name[256];
565	char pax_entry_name[256];
566	char gnu_sparse_name[256];
567	struct archive_string entry_name;
568
569	ret = ARCHIVE_OK;
570	need_extension = 0;
571	pax = (struct pax *)a->format_data;
572
573	/* Sanity check. */
574	if (archive_entry_pathname(entry_original) == NULL) {
575		archive_set_error(&a->archive, ARCHIVE_ERRNO_MISC,
576			  "Can't record entry in tar file without pathname");
577		return (ARCHIVE_FAILED);
578	}
579
580	/*
581	 * Choose a header encoding.
582	 */
583	if (pax->opt_binary)
584		sconv = NULL;/* Binary mode. */
585	else {
586		/* Header encoding is UTF-8. */
587		if (pax->sconv_utf8 == NULL) {
588			/* Initialize the string conversion object
589			 * we must need */
590			pax->sconv_utf8 = archive_string_conversion_to_charset(
591			    &(a->archive), "UTF-8", 1);
592			if (pax->sconv_utf8 == NULL)
593				/* Couldn't allocate memory */
594				return (ARCHIVE_FAILED);
595		}
596		sconv = pax->sconv_utf8;
597	}
598
599	r = get_entry_hardlink(a, entry_original, &hardlink,
600	    &hardlink_length, sconv);
601	if (r == ARCHIVE_FATAL)
602		return (r);
603	else if (r != ARCHIVE_OK) {
604		r = get_entry_hardlink(a, entry_original, &hardlink,
605		    &hardlink_length, NULL);
606		if (r == ARCHIVE_FATAL)
607			return (r);
608		archive_set_error(&a->archive, ARCHIVE_ERRNO_FILE_FORMAT,
609		    "Can't translate linkname '%s' to %s", hardlink,
610		    archive_string_conversion_charset_name(sconv));
611		ret = ARCHIVE_WARN;
612		sconv = NULL;/* The header charset switches to binary mode. */
613	}
614
615	/* Make sure this is a type of entry that we can handle here */
616	if (hardlink == NULL) {
617		switch (archive_entry_filetype(entry_original)) {
618		case AE_IFBLK:
619		case AE_IFCHR:
620		case AE_IFIFO:
621		case AE_IFLNK:
622		case AE_IFREG:
623			break;
624		case AE_IFDIR:
625		{
626			/*
627			 * Ensure a trailing '/'.  Modify the original
628			 * entry so the client sees the change.
629			 */
630#if defined(_WIN32) && !defined(__CYGWIN__)
631			const wchar_t *wp;
632
633			wp = archive_entry_pathname_w(entry_original);
634			if (wp != NULL && wp[wcslen(wp) -1] != L'/') {
635				struct archive_wstring ws;
636
637				archive_string_init(&ws);
638				path_length = wcslen(wp);
639				if (archive_wstring_ensure(&ws,
640				    path_length + 2) == NULL) {
641					archive_set_error(&a->archive, ENOMEM,
642					    "Can't allocate pax data");
643					archive_wstring_free(&ws);
644					return(ARCHIVE_FATAL);
645				}
646				/* Should we keep '\' ? */
647				if (wp[path_length -1] == L'\\')
648					path_length--;
649				archive_wstrncpy(&ws, wp, path_length);
650				archive_wstrappend_wchar(&ws, L'/');
651				archive_entry_copy_pathname_w(
652				    entry_original, ws.s);
653				archive_wstring_free(&ws);
654				p = NULL;
655			} else
656#endif
657				p = archive_entry_pathname(entry_original);
658			/*
659			 * On Windows, this is a backup operation just in
660			 * case getting WCS failed. On POSIX, this is a
661			 * normal operation.
662			 */
663			if (p != NULL && p[strlen(p) - 1] != '/') {
664				struct archive_string as;
665
666				archive_string_init(&as);
667				path_length = strlen(p);
668				if (archive_string_ensure(&as,
669				    path_length + 2) == NULL) {
670					archive_set_error(&a->archive, ENOMEM,
671					    "Can't allocate pax data");
672					archive_string_free(&as);
673					return(ARCHIVE_FATAL);
674				}
675#if defined(_WIN32) && !defined(__CYGWIN__)
676				/* NOTE: This might break the pathname
677				 * if the current code page is CP932 and
678				 * the pathname includes a character '\'
679				 * as a part of its multibyte pathname. */
680				if (p[strlen(p) -1] == '\\')
681					path_length--;
682				else
683#endif
684				archive_strncpy(&as, p, path_length);
685				archive_strappend_char(&as, '/');
686				archive_entry_copy_pathname(
687				    entry_original, as.s);
688				archive_string_free(&as);
689			}
690			break;
691		}
692		case AE_IFSOCK:
693			archive_set_error(&a->archive,
694			    ARCHIVE_ERRNO_FILE_FORMAT,
695			    "tar format cannot archive socket");
696			return (ARCHIVE_FAILED);
697		default:
698			archive_set_error(&a->archive,
699			    ARCHIVE_ERRNO_FILE_FORMAT,
700			    "tar format cannot archive this (type=0%lo)",
701			    (unsigned long)
702			    archive_entry_filetype(entry_original));
703			return (ARCHIVE_FAILED);
704		}
705	}
706
707	/*
708	 * If Mac OS metadata blob is here, recurse to write that
709	 * as a separate entry.  This is really a pretty poor design:
710	 * In particular, it doubles the overhead for long filenames.
711	 * TODO: Help Apple folks design something better and figure
712	 * out how to transition from this legacy format.
713	 *
714	 * Note that this code is present on every platform; clients
715	 * on non-Mac are unlikely to ever provide this data, but
716	 * applications that copy entries from one archive to another
717	 * should not lose data just because the local filesystem
718	 * can't store it.
719	 */
720	mac_metadata =
721	    archive_entry_mac_metadata(entry_original, &mac_metadata_size);
722	if (mac_metadata != NULL) {
723		const char *oname;
724		char *name, *bname;
725		size_t name_length;
726		struct archive_entry *extra = archive_entry_new2(&a->archive);
727
728		oname = archive_entry_pathname(entry_original);
729		name_length = strlen(oname);
730		name = malloc(name_length + 3);
731		if (name == NULL || extra == NULL) {
732			/* XXX error message */
733			archive_entry_free(extra);
734			free(name);
735			return (ARCHIVE_FAILED);
736		}
737		strcpy(name, oname);
738		/* Find last '/'; strip trailing '/' characters */
739		bname = strrchr(name, '/');
740		while (bname != NULL && bname[1] == '\0') {
741			*bname = '\0';
742			bname = strrchr(name, '/');
743		}
744		if (bname == NULL) {
745			memmove(name + 2, name, name_length + 1);
746			memmove(name, "._", 2);
747		} else {
748			bname += 1;
749			memmove(bname + 2, bname, strlen(bname) + 1);
750			memmove(bname, "._", 2);
751		}
752		archive_entry_copy_pathname(extra, name);
753		free(name);
754
755		archive_entry_set_size(extra, mac_metadata_size);
756		archive_entry_set_filetype(extra, AE_IFREG);
757		archive_entry_set_perm(extra,
758		    archive_entry_perm(entry_original));
759		archive_entry_set_mtime(extra,
760		    archive_entry_mtime(entry_original),
761		    archive_entry_mtime_nsec(entry_original));
762		archive_entry_set_gid(extra,
763		    archive_entry_gid(entry_original));
764		archive_entry_set_gname(extra,
765		    archive_entry_gname(entry_original));
766		archive_entry_set_uid(extra,
767		    archive_entry_uid(entry_original));
768		archive_entry_set_uname(extra,
769		    archive_entry_uname(entry_original));
770
771		/* Recurse to write the special copyfile entry. */
772		r = archive_write_pax_header(a, extra);
773		archive_entry_free(extra);
774		if (r < ARCHIVE_WARN)
775			return (r);
776		if (r < ret)
777			ret = r;
778		r = (int)archive_write_pax_data(a, mac_metadata,
779		    mac_metadata_size);
780		if (r < ARCHIVE_WARN)
781			return (r);
782		if (r < ret)
783			ret = r;
784		r = archive_write_pax_finish_entry(a);
785		if (r < ARCHIVE_WARN)
786			return (r);
787		if (r < ret)
788			ret = r;
789	}
790
791	/* Copy entry so we can modify it as needed. */
792#if defined(_WIN32) && !defined(__CYGWIN__)
793	/* Make sure the path separators in pathname, hardlink and symlink
794	 * are all slash '/', not the Windows path separator '\'. */
795	entry_main = __la_win_entry_in_posix_pathseparator(entry_original);
796	if (entry_main == entry_original)
797		entry_main = archive_entry_clone(entry_original);
798#else
799	entry_main = archive_entry_clone(entry_original);
800#endif
801	if (entry_main == NULL) {
802		archive_set_error(&a->archive, ENOMEM,
803		    "Can't allocate pax data");
804		return(ARCHIVE_FATAL);
805	}
806	archive_string_empty(&(pax->pax_header)); /* Blank our work area. */
807	archive_string_empty(&(pax->sparse_map));
808	sparse_total = 0;
809	sparse_list_clear(pax);
810
811	if (hardlink == NULL &&
812	    archive_entry_filetype(entry_main) == AE_IFREG)
813		sparse_count = archive_entry_sparse_reset(entry_main);
814	else
815		sparse_count = 0;
816	if (sparse_count) {
817		int64_t offset, length, last_offset = 0;
818		/* Get the last entry of sparse block. */
819		while (archive_entry_sparse_next(
820		    entry_main, &offset, &length) == ARCHIVE_OK)
821			last_offset = offset + length;
822
823		/* If the last sparse block does not reach the end of file,
824		 * We have to add a empty sparse block as the last entry to
825		 * manage storing file data. */
826		if (last_offset < archive_entry_size(entry_main))
827			archive_entry_sparse_add_entry(entry_main,
828			    archive_entry_size(entry_main), 0);
829		sparse_count = archive_entry_sparse_reset(entry_main);
830	}
831
832	/*
833	 * First, check the name fields and see if any of them
834	 * require binary coding.  If any of them does, then all of
835	 * them do.
836	 */
837	r = get_entry_pathname(a, entry_main, &path, &path_length, sconv);
838	if (r == ARCHIVE_FATAL)
839		return (r);
840	else if (r != ARCHIVE_OK) {
841		r = get_entry_pathname(a, entry_main, &path,
842		    &path_length, NULL);
843		if (r == ARCHIVE_FATAL)
844			return (r);
845		archive_set_error(&a->archive, ARCHIVE_ERRNO_FILE_FORMAT,
846		    "Can't translate pathname '%s' to %s", path,
847		    archive_string_conversion_charset_name(sconv));
848		ret = ARCHIVE_WARN;
849		sconv = NULL;/* The header charset switches to binary mode. */
850	}
851	r = get_entry_uname(a, entry_main, &uname, &uname_length, sconv);
852	if (r == ARCHIVE_FATAL)
853		return (r);
854	else if (r != ARCHIVE_OK) {
855		r = get_entry_uname(a, entry_main, &uname, &uname_length, NULL);
856		if (r == ARCHIVE_FATAL)
857			return (r);
858		archive_set_error(&a->archive, ARCHIVE_ERRNO_FILE_FORMAT,
859		    "Can't translate uname '%s' to %s", uname,
860		    archive_string_conversion_charset_name(sconv));
861		ret = ARCHIVE_WARN;
862		sconv = NULL;/* The header charset switches to binary mode. */
863	}
864	r = get_entry_gname(a, entry_main, &gname, &gname_length, sconv);
865	if (r == ARCHIVE_FATAL)
866		return (r);
867	else if (r != ARCHIVE_OK) {
868		r = get_entry_gname(a, entry_main, &gname, &gname_length, NULL);
869		if (r == ARCHIVE_FATAL)
870			return (r);
871		archive_set_error(&a->archive, ARCHIVE_ERRNO_FILE_FORMAT,
872		    "Can't translate gname '%s' to %s", gname,
873		    archive_string_conversion_charset_name(sconv));
874		ret = ARCHIVE_WARN;
875		sconv = NULL;/* The header charset switches to binary mode. */
876	}
877	linkpath = hardlink;
878	linkpath_length = hardlink_length;
879	if (linkpath == NULL) {
880		r = get_entry_symlink(a, entry_main, &linkpath,
881		    &linkpath_length, sconv);
882		if (r == ARCHIVE_FATAL)
883			return (r);
884		else if (r != ARCHIVE_OK) {
885			r = get_entry_symlink(a, entry_main, &linkpath,
886			    &linkpath_length, NULL);
887			if (r == ARCHIVE_FATAL)
888				return (r);
889			archive_set_error(&a->archive,
890			    ARCHIVE_ERRNO_FILE_FORMAT,
891			    "Can't translate linkname '%s' to %s", linkpath,
892			    archive_string_conversion_charset_name(sconv));
893			ret = ARCHIVE_WARN;
894			sconv = NULL;
895		}
896	}
897
898	/* If any string conversions failed, get all attributes
899	 * in binary-mode. */
900	if (sconv == NULL && !pax->opt_binary) {
901		if (hardlink != NULL) {
902			r = get_entry_hardlink(a, entry_main, &hardlink,
903			    &hardlink_length, NULL);
904			if (r == ARCHIVE_FATAL)
905				return (r);
906			linkpath = hardlink;
907			linkpath_length = hardlink_length;
908		}
909		r = get_entry_pathname(a, entry_main, &path,
910		    &path_length, NULL);
911		if (r == ARCHIVE_FATAL)
912			return (r);
913		r = get_entry_uname(a, entry_main, &uname, &uname_length, NULL);
914		if (r == ARCHIVE_FATAL)
915			return (r);
916		r = get_entry_gname(a, entry_main, &gname, &gname_length, NULL);
917		if (r == ARCHIVE_FATAL)
918			return (r);
919	}
920
921	/* Store the header encoding first, to be nice to readers. */
922	if (sconv == NULL)
923		add_pax_attr(&(pax->pax_header), "hdrcharset", "BINARY");
924
925
926	/*
927	 * If name is too long, or has non-ASCII characters, add
928	 * 'path' to pax extended attrs.  (Note that an unconvertible
929	 * name must have non-ASCII characters.)
930	 */
931	if (has_non_ASCII(path)) {
932		/* We have non-ASCII characters. */
933		add_pax_attr(&(pax->pax_header), "path", path);
934		archive_entry_set_pathname(entry_main,
935		    build_ustar_entry_name(ustar_entry_name,
936			path, path_length, NULL));
937		need_extension = 1;
938	} else {
939		/* We have an all-ASCII path; we'd like to just store
940		 * it in the ustar header if it will fit.  Yes, this
941		 * duplicates some of the logic in
942		 * archive_write_set_format_ustar.c
943		 */
944		if (path_length <= 100) {
945			/* Fits in the old 100-char tar name field. */
946		} else {
947			/* Find largest suffix that will fit. */
948			/* Note: strlen() > 100, so strlen() - 100 - 1 >= 0 */
949			suffix = strchr(path + path_length - 100 - 1, '/');
950			/* Don't attempt an empty prefix. */
951			if (suffix == path)
952				suffix = strchr(suffix + 1, '/');
953			/* We can put it in the ustar header if it's
954			 * all ASCII and it's either <= 100 characters
955			 * or can be split at a '/' into a prefix <=
956			 * 155 chars and a suffix <= 100 chars.  (Note
957			 * the strchr() above will return NULL exactly
958			 * when the path can't be split.)
959			 */
960			if (suffix == NULL       /* Suffix > 100 chars. */
961			    || suffix[1] == '\0'    /* empty suffix */
962			    || suffix - path > 155)  /* Prefix > 155 chars */
963			{
964				add_pax_attr(&(pax->pax_header), "path", path);
965				archive_entry_set_pathname(entry_main,
966				    build_ustar_entry_name(ustar_entry_name,
967					path, path_length, NULL));
968				need_extension = 1;
969			}
970		}
971	}
972
973	if (linkpath != NULL) {
974		/* If link name is too long or has non-ASCII characters, add
975		 * 'linkpath' to pax extended attrs. */
976		if (linkpath_length > 100 || has_non_ASCII(linkpath)) {
977			add_pax_attr(&(pax->pax_header), "linkpath", linkpath);
978			if (linkpath_length > 100) {
979				if (hardlink != NULL)
980					archive_entry_set_hardlink(entry_main,
981					    "././@LongHardLink");
982				else
983					archive_entry_set_symlink(entry_main,
984					    "././@LongSymLink");
985			}
986			need_extension = 1;
987		}
988	}
989	/* Save a pathname since it will be renamed if `entry_main` has
990	 * sparse blocks. */
991	archive_string_init(&entry_name);
992	archive_strcpy(&entry_name, archive_entry_pathname(entry_main));
993
994	/* If file size is too large, add 'size' to pax extended attrs. */
995	if (archive_entry_size(entry_main) >= (((int64_t)1) << 33)) {
996		add_pax_attr_int(&(pax->pax_header), "size",
997		    archive_entry_size(entry_main));
998		need_extension = 1;
999	}
1000
1001	/* If numeric GID is too large, add 'gid' to pax extended attrs. */
1002	if ((unsigned int)archive_entry_gid(entry_main) >= (1 << 18)) {
1003		add_pax_attr_int(&(pax->pax_header), "gid",
1004		    archive_entry_gid(entry_main));
1005		need_extension = 1;
1006	}
1007
1008	/* If group name is too large or has non-ASCII characters, add
1009	 * 'gname' to pax extended attrs. */
1010	if (gname != NULL) {
1011		if (gname_length > 31 || has_non_ASCII(gname)) {
1012			add_pax_attr(&(pax->pax_header), "gname", gname);
1013			need_extension = 1;
1014		}
1015	}
1016
1017	/* If numeric UID is too large, add 'uid' to pax extended attrs. */
1018	if ((unsigned int)archive_entry_uid(entry_main) >= (1 << 18)) {
1019		add_pax_attr_int(&(pax->pax_header), "uid",
1020		    archive_entry_uid(entry_main));
1021		need_extension = 1;
1022	}
1023
1024	/* Add 'uname' to pax extended attrs if necessary. */
1025	if (uname != NULL) {
1026		if (uname_length > 31 || has_non_ASCII(uname)) {
1027			add_pax_attr(&(pax->pax_header), "uname", uname);
1028			need_extension = 1;
1029		}
1030	}
1031
1032	/*
1033	 * POSIX/SUSv3 doesn't provide a standard key for large device
1034	 * numbers.  I use the same keys here that Joerg Schilling
1035	 * used for 'star.'  (Which, somewhat confusingly, are called
1036	 * "devXXX" even though they code "rdev" values.)  No doubt,
1037	 * other implementations use other keys.  Note that there's no
1038	 * reason we can't write the same information into a number of
1039	 * different keys.
1040	 *
1041	 * Of course, this is only needed for block or char device entries.
1042	 */
1043	if (archive_entry_filetype(entry_main) == AE_IFBLK
1044	    || archive_entry_filetype(entry_main) == AE_IFCHR) {
1045		/*
1046		 * If rdevmajor is too large, add 'SCHILY.devmajor' to
1047		 * extended attributes.
1048		 */
1049		int rdevmajor, rdevminor;
1050		rdevmajor = archive_entry_rdevmajor(entry_main);
1051		rdevminor = archive_entry_rdevminor(entry_main);
1052		if (rdevmajor >= (1 << 18)) {
1053			add_pax_attr_int(&(pax->pax_header), "SCHILY.devmajor",
1054			    rdevmajor);
1055			/*
1056			 * Non-strict formatting below means we don't
1057			 * have to truncate here.  Not truncating improves
1058			 * the chance that some more modern tar archivers
1059			 * (such as GNU tar 1.13) can restore the full
1060			 * value even if they don't understand the pax
1061			 * extended attributes.  See my rant below about
1062			 * file size fields for additional details.
1063			 */
1064			/* archive_entry_set_rdevmajor(entry_main,
1065			   rdevmajor & ((1 << 18) - 1)); */
1066			need_extension = 1;
1067		}
1068
1069		/*
1070		 * If devminor is too large, add 'SCHILY.devminor' to
1071		 * extended attributes.
1072		 */
1073		if (rdevminor >= (1 << 18)) {
1074			add_pax_attr_int(&(pax->pax_header), "SCHILY.devminor",
1075			    rdevminor);
1076			/* Truncation is not necessary here, either. */
1077			/* archive_entry_set_rdevminor(entry_main,
1078			   rdevminor & ((1 << 18) - 1)); */
1079			need_extension = 1;
1080		}
1081	}
1082
1083	/*
1084	 * Technically, the mtime field in the ustar header can
1085	 * support 33 bits, but many platforms use signed 32-bit time
1086	 * values.  The cutoff of 0x7fffffff here is a compromise.
1087	 * Yes, this check is duplicated just below; this helps to
1088	 * avoid writing an mtime attribute just to handle a
1089	 * high-resolution timestamp in "restricted pax" mode.
1090	 */
1091	if (!need_extension &&
1092	    ((archive_entry_mtime(entry_main) < 0)
1093		|| (archive_entry_mtime(entry_main) >= 0x7fffffff)))
1094		need_extension = 1;
1095
1096	/* I use a star-compatible file flag attribute. */
1097	p = archive_entry_fflags_text(entry_main);
1098	if (!need_extension && p != NULL  &&  *p != '\0')
1099		need_extension = 1;
1100
1101	/* If there are extended attributes, we need an extension */
1102	if (!need_extension && archive_entry_xattr_count(entry_original) > 0)
1103		need_extension = 1;
1104
1105	/* If there are sparse info, we need an extension */
1106	if (!need_extension && sparse_count > 0)
1107		need_extension = 1;
1108
1109	acl_types = archive_entry_acl_types(entry_original);
1110
1111	/* If there are any ACL entries, we need an extension */
1112	if (!need_extension && acl_types != 0)
1113		need_extension = 1;
1114
1115	/*
1116	 * Libarchive used to include these in extended headers for
1117	 * restricted pax format, but that confused people who
1118	 * expected ustar-like time semantics.  So now we only include
1119	 * them in full pax format.
1120	 */
1121	if (a->archive.archive_format != ARCHIVE_FORMAT_TAR_PAX_RESTRICTED) {
1122		if (archive_entry_ctime(entry_main) != 0  ||
1123		    archive_entry_ctime_nsec(entry_main) != 0)
1124			add_pax_attr_time(&(pax->pax_header), "ctime",
1125			    archive_entry_ctime(entry_main),
1126			    archive_entry_ctime_nsec(entry_main));
1127
1128		if (archive_entry_atime(entry_main) != 0 ||
1129		    archive_entry_atime_nsec(entry_main) != 0)
1130			add_pax_attr_time(&(pax->pax_header), "atime",
1131			    archive_entry_atime(entry_main),
1132			    archive_entry_atime_nsec(entry_main));
1133
1134		/* Store birth/creationtime only if it's earlier than mtime */
1135		if (archive_entry_birthtime_is_set(entry_main) &&
1136		    archive_entry_birthtime(entry_main)
1137		    < archive_entry_mtime(entry_main))
1138			add_pax_attr_time(&(pax->pax_header),
1139			    "LIBARCHIVE.creationtime",
1140			    archive_entry_birthtime(entry_main),
1141			    archive_entry_birthtime_nsec(entry_main));
1142	}
1143
1144	/*
1145	 * The following items are handled differently in "pax
1146	 * restricted" format.  In particular, in "pax restricted"
1147	 * format they won't be added unless need_extension is
1148	 * already set (we're already generating an extended header, so
1149	 * may as well include these).
1150	 */
1151	if (a->archive.archive_format != ARCHIVE_FORMAT_TAR_PAX_RESTRICTED ||
1152	    need_extension) {
1153		if (archive_entry_mtime(entry_main) < 0  ||
1154		    archive_entry_mtime(entry_main) >= 0x7fffffff  ||
1155		    archive_entry_mtime_nsec(entry_main) != 0)
1156			add_pax_attr_time(&(pax->pax_header), "mtime",
1157			    archive_entry_mtime(entry_main),
1158			    archive_entry_mtime_nsec(entry_main));
1159
1160		/* I use a star-compatible file flag attribute. */
1161		p = archive_entry_fflags_text(entry_main);
1162		if (p != NULL  &&  *p != '\0')
1163			add_pax_attr(&(pax->pax_header), "SCHILY.fflags", p);
1164
1165		/* I use star-compatible ACL attributes. */
1166		if ((acl_types & ARCHIVE_ENTRY_ACL_TYPE_NFS4) != 0) {
1167			ret = add_pax_acl(a, entry_original, pax,
1168			    ARCHIVE_ENTRY_ACL_STYLE_EXTRA_ID |
1169			    ARCHIVE_ENTRY_ACL_STYLE_SEPARATOR_COMMA);
1170			if (ret == ARCHIVE_FATAL)
1171				return (ARCHIVE_FATAL);
1172		}
1173		if (acl_types & ARCHIVE_ENTRY_ACL_TYPE_ACCESS) {
1174			ret = add_pax_acl(a, entry_original, pax,
1175			    ARCHIVE_ENTRY_ACL_TYPE_ACCESS |
1176			    ARCHIVE_ENTRY_ACL_STYLE_EXTRA_ID |
1177			    ARCHIVE_ENTRY_ACL_STYLE_SEPARATOR_COMMA);
1178			if (ret == ARCHIVE_FATAL)
1179				return (ARCHIVE_FATAL);
1180		}
1181		if (acl_types & ARCHIVE_ENTRY_ACL_TYPE_DEFAULT) {
1182			ret = add_pax_acl(a, entry_original, pax,
1183			    ARCHIVE_ENTRY_ACL_TYPE_DEFAULT |
1184			    ARCHIVE_ENTRY_ACL_STYLE_EXTRA_ID |
1185			    ARCHIVE_ENTRY_ACL_STYLE_SEPARATOR_COMMA);
1186			if (ret == ARCHIVE_FATAL)
1187				return (ARCHIVE_FATAL);
1188		}
1189
1190		/* We use GNU-tar-compatible sparse attributes. */
1191		if (sparse_count > 0) {
1192			int64_t soffset, slength;
1193
1194			add_pax_attr_int(&(pax->pax_header),
1195			    "GNU.sparse.major", 1);
1196			add_pax_attr_int(&(pax->pax_header),
1197			    "GNU.sparse.minor", 0);
1198			add_pax_attr(&(pax->pax_header),
1199			    "GNU.sparse.name", entry_name.s);
1200			add_pax_attr_int(&(pax->pax_header),
1201			    "GNU.sparse.realsize",
1202			    archive_entry_size(entry_main));
1203
1204			/* Rename the file name which will be used for
1205			 * ustar header to a special name, which GNU
1206			 * PAX Format 1.0 requires */
1207			archive_entry_set_pathname(entry_main,
1208			    build_gnu_sparse_name(gnu_sparse_name,
1209			        entry_name.s));
1210
1211			/*
1212			 * - Make a sparse map, which will precede a file data.
1213			 * - Get the total size of available data of sparse.
1214			 */
1215			archive_string_sprintf(&(pax->sparse_map), "%d\n",
1216			    sparse_count);
1217			while (archive_entry_sparse_next(entry_main,
1218			    &soffset, &slength) == ARCHIVE_OK) {
1219				archive_string_sprintf(&(pax->sparse_map),
1220				    "%jd\n%jd\n",
1221				    (intmax_t)soffset,
1222				    (intmax_t)slength);
1223				sparse_total += slength;
1224				if (sparse_list_add(pax, soffset, slength)
1225				    != ARCHIVE_OK) {
1226					archive_set_error(&a->archive,
1227					    ENOMEM,
1228					    "Can't allocate memory");
1229					archive_entry_free(entry_main);
1230					archive_string_free(&entry_name);
1231					return (ARCHIVE_FATAL);
1232				}
1233			}
1234		}
1235
1236		/* Store extended attributes */
1237		if (archive_write_pax_header_xattrs(a, pax, entry_original)
1238		    == ARCHIVE_FATAL) {
1239			archive_entry_free(entry_main);
1240			archive_string_free(&entry_name);
1241			return (ARCHIVE_FATAL);
1242		}
1243	}
1244
1245	/* Only regular files have data. */
1246	if (archive_entry_filetype(entry_main) != AE_IFREG)
1247		archive_entry_set_size(entry_main, 0);
1248
1249	/*
1250	 * Pax-restricted does not store data for hardlinks, in order
1251	 * to improve compatibility with ustar.
1252	 */
1253	if (a->archive.archive_format != ARCHIVE_FORMAT_TAR_PAX_INTERCHANGE &&
1254	    hardlink != NULL)
1255		archive_entry_set_size(entry_main, 0);
1256
1257	/*
1258	 * XXX Full pax interchange format does permit a hardlink
1259	 * entry to have data associated with it.  I'm not supporting
1260	 * that here because the client expects me to tell them whether
1261	 * or not this format expects data for hardlinks.  If I
1262	 * don't check here, then every pax archive will end up with
1263	 * duplicated data for hardlinks.  Someday, there may be
1264	 * need to select this behavior, in which case the following
1265	 * will need to be revisited. XXX
1266	 */
1267	if (hardlink != NULL)
1268		archive_entry_set_size(entry_main, 0);
1269
1270	/* Save a real file size. */
1271	real_size = archive_entry_size(entry_main);
1272	/*
1273	 * Overwrite a file size by the total size of sparse blocks and
1274	 * the size of sparse map info. That file size is the length of
1275	 * the data, which we will exactly store into an archive file.
1276	 */
1277	if (archive_strlen(&(pax->sparse_map))) {
1278		size_t mapsize = archive_strlen(&(pax->sparse_map));
1279		pax->sparse_map_padding = 0x1ff & (-(ssize_t)mapsize);
1280		archive_entry_set_size(entry_main,
1281		    mapsize + pax->sparse_map_padding + sparse_total);
1282	}
1283
1284	/* Format 'ustar' header for main entry.
1285	 *
1286	 * The trouble with file size: If the reader can't understand
1287	 * the file size, they may not be able to locate the next
1288	 * entry and the rest of the archive is toast.  Pax-compliant
1289	 * readers are supposed to ignore the file size in the main
1290	 * header, so the question becomes how to maximize portability
1291	 * for readers that don't support pax attribute extensions.
1292	 * For maximum compatibility, I permit numeric extensions in
1293	 * the main header so that the file size stored will always be
1294	 * correct, even if it's in a format that only some
1295	 * implementations understand.  The technique used here is:
1296	 *
1297	 *  a) If possible, follow the standard exactly.  This handles
1298	 *  files up to 8 gigabytes minus 1.
1299	 *
1300	 *  b) If that fails, try octal but omit the field terminator.
1301	 *  That handles files up to 64 gigabytes minus 1.
1302	 *
1303	 *  c) Otherwise, use base-256 extensions.  That handles files
1304	 *  up to 2^63 in this implementation, with the potential to
1305	 *  go up to 2^94.  That should hold us for a while. ;-)
1306	 *
1307	 * The non-strict formatter uses similar logic for other
1308	 * numeric fields, though they're less critical.
1309	 */
1310	if (__archive_write_format_header_ustar(a, ustarbuff, entry_main, -1, 0,
1311	    NULL) == ARCHIVE_FATAL)
1312		return (ARCHIVE_FATAL);
1313
1314	/* If we built any extended attributes, write that entry first. */
1315	if (archive_strlen(&(pax->pax_header)) > 0) {
1316		struct archive_entry *pax_attr_entry;
1317		time_t s;
1318		int64_t uid, gid;
1319		int mode;
1320
1321		pax_attr_entry = archive_entry_new2(&a->archive);
1322		p = entry_name.s;
1323		archive_entry_set_pathname(pax_attr_entry,
1324		    build_pax_attribute_name(pax_entry_name, p));
1325		archive_entry_set_size(pax_attr_entry,
1326		    archive_strlen(&(pax->pax_header)));
1327		/* Copy uid/gid (but clip to ustar limits). */
1328		uid = archive_entry_uid(entry_main);
1329		if (uid >= 1 << 18)
1330			uid = (1 << 18) - 1;
1331		archive_entry_set_uid(pax_attr_entry, uid);
1332		gid = archive_entry_gid(entry_main);
1333		if (gid >= 1 << 18)
1334			gid = (1 << 18) - 1;
1335		archive_entry_set_gid(pax_attr_entry, gid);
1336		/* Copy mode over (but not setuid/setgid bits) */
1337		mode = archive_entry_mode(entry_main);
1338#ifdef S_ISUID
1339		mode &= ~S_ISUID;
1340#endif
1341#ifdef S_ISGID
1342		mode &= ~S_ISGID;
1343#endif
1344#ifdef S_ISVTX
1345		mode &= ~S_ISVTX;
1346#endif
1347		archive_entry_set_mode(pax_attr_entry, mode);
1348
1349		/* Copy uname/gname. */
1350		archive_entry_set_uname(pax_attr_entry,
1351		    archive_entry_uname(entry_main));
1352		archive_entry_set_gname(pax_attr_entry,
1353		    archive_entry_gname(entry_main));
1354
1355		/* Copy mtime, but clip to ustar limits. */
1356		s = archive_entry_mtime(entry_main);
1357		if (s < 0) { s = 0; }
1358		if (s >= 0x7fffffff) { s = 0x7fffffff; }
1359		archive_entry_set_mtime(pax_attr_entry, s, 0);
1360
1361		/* Standard ustar doesn't support atime. */
1362		archive_entry_set_atime(pax_attr_entry, 0, 0);
1363
1364		/* Standard ustar doesn't support ctime. */
1365		archive_entry_set_ctime(pax_attr_entry, 0, 0);
1366
1367		r = __archive_write_format_header_ustar(a, paxbuff,
1368		    pax_attr_entry, 'x', 1, NULL);
1369
1370		archive_entry_free(pax_attr_entry);
1371
1372		/* Note that the 'x' header shouldn't ever fail to format */
1373		if (r < ARCHIVE_WARN) {
1374			archive_set_error(&a->archive, ARCHIVE_ERRNO_MISC,
1375			    "archive_write_pax_header: "
1376			    "'x' header failed?!  This can't happen.\n");
1377			return (ARCHIVE_FATAL);
1378		} else if (r < ret)
1379			ret = r;
1380		r = __archive_write_output(a, paxbuff, 512);
1381		if (r != ARCHIVE_OK) {
1382			sparse_list_clear(pax);
1383			pax->entry_bytes_remaining = 0;
1384			pax->entry_padding = 0;
1385			return (ARCHIVE_FATAL);
1386		}
1387
1388		pax->entry_bytes_remaining = archive_strlen(&(pax->pax_header));
1389		pax->entry_padding =
1390		    0x1ff & (-(int64_t)pax->entry_bytes_remaining);
1391
1392		r = __archive_write_output(a, pax->pax_header.s,
1393		    archive_strlen(&(pax->pax_header)));
1394		if (r != ARCHIVE_OK) {
1395			/* If a write fails, we're pretty much toast. */
1396			return (ARCHIVE_FATAL);
1397		}
1398		/* Pad out the end of the entry. */
1399		r = __archive_write_nulls(a, (size_t)pax->entry_padding);
1400		if (r != ARCHIVE_OK) {
1401			/* If a write fails, we're pretty much toast. */
1402			return (ARCHIVE_FATAL);
1403		}
1404		pax->entry_bytes_remaining = pax->entry_padding = 0;
1405	}
1406
1407	/* Write the header for main entry. */
1408	r = __archive_write_output(a, ustarbuff, 512);
1409	if (r != ARCHIVE_OK)
1410		return (r);
1411
1412	/*
1413	 * Inform the client of the on-disk size we're using, so
1414	 * they can avoid unnecessarily writing a body for something
1415	 * that we're just going to ignore.
1416	 */
1417	archive_entry_set_size(entry_original, real_size);
1418	if (pax->sparse_list == NULL && real_size > 0) {
1419		/* This is not a sparse file but we handle its data as
1420		 * a sparse block. */
1421		sparse_list_add(pax, 0, real_size);
1422		sparse_total = real_size;
1423	}
1424	pax->entry_padding = 0x1ff & (-(int64_t)sparse_total);
1425	archive_entry_free(entry_main);
1426	archive_string_free(&entry_name);
1427
1428	return (ret);
1429}
1430
1431/*
1432 * We need a valid name for the regular 'ustar' entry.  This routine
1433 * tries to hack something more-or-less reasonable.
1434 *
1435 * The approach here tries to preserve leading dir names.  We do so by
1436 * working with four sections:
1437 *   1) "prefix" directory names,
1438 *   2) "suffix" directory names,
1439 *   3) inserted dir name (optional),
1440 *   4) filename.
1441 *
1442 * These sections must satisfy the following requirements:
1443 *   * Parts 1 & 2 together form an initial portion of the dir name.
1444 *   * Part 3 is specified by the caller.  (It should not contain a leading
1445 *     or trailing '/'.)
1446 *   * Part 4 forms an initial portion of the base filename.
1447 *   * The filename must be <= 99 chars to fit the ustar 'name' field.
1448 *   * Parts 2, 3, 4 together must be <= 99 chars to fit the ustar 'name' fld.
1449 *   * Part 1 must be <= 155 chars to fit the ustar 'prefix' field.
1450 *   * If the original name ends in a '/', the new name must also end in a '/'
1451 *   * Trailing '/.' sequences may be stripped.
1452 *
1453 * Note: Recall that the ustar format does not store the '/' separating
1454 * parts 1 & 2, but does store the '/' separating parts 2 & 3.
1455 */
1456static char *
1457build_ustar_entry_name(char *dest, const char *src, size_t src_length,
1458    const char *insert)
1459{
1460	const char *prefix, *prefix_end;
1461	const char *suffix, *suffix_end;
1462	const char *filename, *filename_end;
1463	char *p;
1464	int need_slash = 0; /* Was there a trailing slash? */
1465	size_t suffix_length = 99;
1466	size_t insert_length;
1467
1468	/* Length of additional dir element to be added. */
1469	if (insert == NULL)
1470		insert_length = 0;
1471	else
1472		/* +2 here allows for '/' before and after the insert. */
1473		insert_length = strlen(insert) + 2;
1474
1475	/* Step 0: Quick bailout in a common case. */
1476	if (src_length < 100 && insert == NULL) {
1477		strncpy(dest, src, src_length);
1478		dest[src_length] = '\0';
1479		return (dest);
1480	}
1481
1482	/* Step 1: Locate filename and enforce the length restriction. */
1483	filename_end = src + src_length;
1484	/* Remove trailing '/' chars and '/.' pairs. */
1485	for (;;) {
1486		if (filename_end > src && filename_end[-1] == '/') {
1487			filename_end --;
1488			need_slash = 1; /* Remember to restore trailing '/'. */
1489			continue;
1490		}
1491		if (filename_end > src + 1 && filename_end[-1] == '.'
1492		    && filename_end[-2] == '/') {
1493			filename_end -= 2;
1494			need_slash = 1; /* "foo/." will become "foo/" */
1495			continue;
1496		}
1497		break;
1498	}
1499	if (need_slash)
1500		suffix_length--;
1501	/* Find start of filename. */
1502	filename = filename_end - 1;
1503	while ((filename > src) && (*filename != '/'))
1504		filename --;
1505	if ((*filename == '/') && (filename < filename_end - 1))
1506		filename ++;
1507	/* Adjust filename_end so that filename + insert fits in 99 chars. */
1508	suffix_length -= insert_length;
1509	if (filename_end > filename + suffix_length)
1510		filename_end = filename + suffix_length;
1511	/* Calculate max size for "suffix" section (#3 above). */
1512	suffix_length -= filename_end - filename;
1513
1514	/* Step 2: Locate the "prefix" section of the dirname, including
1515	 * trailing '/'. */
1516	prefix = src;
1517	prefix_end = prefix + 155;
1518	if (prefix_end > filename)
1519		prefix_end = filename;
1520	while (prefix_end > prefix && *prefix_end != '/')
1521		prefix_end--;
1522	if ((prefix_end < filename) && (*prefix_end == '/'))
1523		prefix_end++;
1524
1525	/* Step 3: Locate the "suffix" section of the dirname,
1526	 * including trailing '/'. */
1527	suffix = prefix_end;
1528	suffix_end = suffix + suffix_length; /* Enforce limit. */
1529	if (suffix_end > filename)
1530		suffix_end = filename;
1531	if (suffix_end < suffix)
1532		suffix_end = suffix;
1533	while (suffix_end > suffix && *suffix_end != '/')
1534		suffix_end--;
1535	if ((suffix_end < filename) && (*suffix_end == '/'))
1536		suffix_end++;
1537
1538	/* Step 4: Build the new name. */
1539	/* The OpenBSD strlcpy function is safer, but less portable. */
1540	/* Rather than maintain two versions, just use the strncpy version. */
1541	p = dest;
1542	if (prefix_end > prefix) {
1543		strncpy(p, prefix, prefix_end - prefix);
1544		p += prefix_end - prefix;
1545	}
1546	if (suffix_end > suffix) {
1547		strncpy(p, suffix, suffix_end - suffix);
1548		p += suffix_end - suffix;
1549	}
1550	if (insert != NULL) {
1551		/* Note: assume insert does not have leading or trailing '/' */
1552		strcpy(p, insert);
1553		p += strlen(insert);
1554		*p++ = '/';
1555	}
1556	strncpy(p, filename, filename_end - filename);
1557	p += filename_end - filename;
1558	if (need_slash)
1559		*p++ = '/';
1560	*p = '\0';
1561
1562	return (dest);
1563}
1564
1565/*
1566 * The ustar header for the pax extended attributes must have a
1567 * reasonable name:  SUSv3 requires 'dirname'/PaxHeader.'pid'/'filename'
1568 * where 'pid' is the PID of the archiving process.  Unfortunately,
1569 * that makes testing a pain since the output varies for each run,
1570 * so I'm sticking with the simpler 'dirname'/PaxHeader/'filename'
1571 * for now.  (Someday, I'll make this settable.  Then I can use the
1572 * SUS recommendation as default and test harnesses can override it
1573 * to get predictable results.)
1574 *
1575 * Joerg Schilling has argued that this is unnecessary because, in
1576 * practice, if the pax extended attributes get extracted as regular
1577 * files, no one is going to bother reading those attributes to
1578 * manually restore them.  Based on this, 'star' uses
1579 * /tmp/PaxHeader/'basename' as the ustar header name.  This is a
1580 * tempting argument, in part because it's simpler than the SUSv3
1581 * recommendation, but I'm not entirely convinced.  I'm also
1582 * uncomfortable with the fact that "/tmp" is a Unix-ism.
1583 *
1584 * The following routine leverages build_ustar_entry_name() above and
1585 * so is simpler than you might think.  It just needs to provide the
1586 * additional path element and handle a few pathological cases).
1587 */
1588static char *
1589build_pax_attribute_name(char *dest, const char *src)
1590{
1591	char buff[64];
1592	const char *p;
1593
1594	/* Handle the null filename case. */
1595	if (src == NULL || *src == '\0') {
1596		strcpy(dest, "PaxHeader/blank");
1597		return (dest);
1598	}
1599
1600	/* Prune final '/' and other unwanted final elements. */
1601	p = src + strlen(src);
1602	for (;;) {
1603		/* Ends in "/", remove the '/' */
1604		if (p > src && p[-1] == '/') {
1605			--p;
1606			continue;
1607		}
1608		/* Ends in "/.", remove the '.' */
1609		if (p > src + 1 && p[-1] == '.'
1610		    && p[-2] == '/') {
1611			--p;
1612			continue;
1613		}
1614		break;
1615	}
1616
1617	/* Pathological case: After above, there was nothing left.
1618	 * This includes "/." "/./." "/.//./." etc. */
1619	if (p == src) {
1620		strcpy(dest, "/PaxHeader/rootdir");
1621		return (dest);
1622	}
1623
1624	/* Convert unadorned "." into a suitable filename. */
1625	if (*src == '.' && p == src + 1) {
1626		strcpy(dest, "PaxHeader/currentdir");
1627		return (dest);
1628	}
1629
1630	/*
1631	 * TODO: Push this string into the 'pax' structure to avoid
1632	 * recomputing it every time.  That will also open the door
1633	 * to having clients override it.
1634	 */
1635#if HAVE_GETPID && 0  /* Disable this for now; see above comment. */
1636	sprintf(buff, "PaxHeader.%d", getpid());
1637#else
1638	/* If the platform can't fetch the pid, don't include it. */
1639	strcpy(buff, "PaxHeader");
1640#endif
1641	/* General case: build a ustar-compatible name adding
1642	 * "/PaxHeader/". */
1643	build_ustar_entry_name(dest, src, p - src, buff);
1644
1645	return (dest);
1646}
1647
1648/*
1649 * GNU PAX Format 1.0 requires the special name, which pattern is:
1650 * <dir>/GNUSparseFile.<pid>/<original file name>
1651 *
1652 * This function is used for only Sparse file, a file type of which
1653 * is regular file.
1654 */
1655static char *
1656build_gnu_sparse_name(char *dest, const char *src)
1657{
1658	char buff[64];
1659	const char *p;
1660
1661	/* Handle the null filename case. */
1662	if (src == NULL || *src == '\0') {
1663		strcpy(dest, "GNUSparseFile/blank");
1664		return (dest);
1665	}
1666
1667	/* Prune final '/' and other unwanted final elements. */
1668	p = src + strlen(src);
1669	for (;;) {
1670		/* Ends in "/", remove the '/' */
1671		if (p > src && p[-1] == '/') {
1672			--p;
1673			continue;
1674		}
1675		/* Ends in "/.", remove the '.' */
1676		if (p > src + 1 && p[-1] == '.'
1677		    && p[-2] == '/') {
1678			--p;
1679			continue;
1680		}
1681		break;
1682	}
1683
1684#if HAVE_GETPID && 0  /* Disable this as pax attribute name. */
1685	sprintf(buff, "GNUSparseFile.%d", getpid());
1686#else
1687	/* If the platform can't fetch the pid, don't include it. */
1688	strcpy(buff, "GNUSparseFile");
1689#endif
1690	/* General case: build a ustar-compatible name adding
1691	 * "/GNUSparseFile/". */
1692	build_ustar_entry_name(dest, src, p - src, buff);
1693
1694	return (dest);
1695}
1696
1697/* Write two null blocks for the end of archive */
1698static int
1699archive_write_pax_close(struct archive_write *a)
1700{
1701	return (__archive_write_nulls(a, 512 * 2));
1702}
1703
1704static int
1705archive_write_pax_free(struct archive_write *a)
1706{
1707	struct pax *pax;
1708
1709	pax = (struct pax *)a->format_data;
1710	if (pax == NULL)
1711		return (ARCHIVE_OK);
1712
1713	archive_string_free(&pax->pax_header);
1714	archive_string_free(&pax->sparse_map);
1715	archive_string_free(&pax->l_url_encoded_name);
1716	sparse_list_clear(pax);
1717	free(pax);
1718	a->format_data = NULL;
1719	return (ARCHIVE_OK);
1720}
1721
1722static int
1723archive_write_pax_finish_entry(struct archive_write *a)
1724{
1725	struct pax *pax;
1726	uint64_t remaining;
1727	int ret;
1728
1729	pax = (struct pax *)a->format_data;
1730	remaining = pax->entry_bytes_remaining;
1731	if (remaining == 0) {
1732		while (pax->sparse_list) {
1733			struct sparse_block *sb;
1734			if (!pax->sparse_list->is_hole)
1735				remaining += pax->sparse_list->remaining;
1736			sb = pax->sparse_list->next;
1737			free(pax->sparse_list);
1738			pax->sparse_list = sb;
1739		}
1740	}
1741	ret = __archive_write_nulls(a, (size_t)(remaining + pax->entry_padding));
1742	pax->entry_bytes_remaining = pax->entry_padding = 0;
1743	return (ret);
1744}
1745
1746static ssize_t
1747archive_write_pax_data(struct archive_write *a, const void *buff, size_t s)
1748{
1749	struct pax *pax;
1750	size_t ws;
1751	size_t total;
1752	int ret;
1753
1754	pax = (struct pax *)a->format_data;
1755
1756	/*
1757	 * According to GNU PAX format 1.0, write a sparse map
1758	 * before the body.
1759	 */
1760	if (archive_strlen(&(pax->sparse_map))) {
1761		ret = __archive_write_output(a, pax->sparse_map.s,
1762		    archive_strlen(&(pax->sparse_map)));
1763		if (ret != ARCHIVE_OK)
1764			return (ret);
1765		ret = __archive_write_nulls(a, pax->sparse_map_padding);
1766		if (ret != ARCHIVE_OK)
1767			return (ret);
1768		archive_string_empty(&(pax->sparse_map));
1769	}
1770
1771	total = 0;
1772	while (total < s) {
1773		const unsigned char *p;
1774
1775		while (pax->sparse_list != NULL &&
1776		    pax->sparse_list->remaining == 0) {
1777			struct sparse_block *sb = pax->sparse_list->next;
1778			free(pax->sparse_list);
1779			pax->sparse_list = sb;
1780		}
1781
1782		if (pax->sparse_list == NULL)
1783			return (total);
1784
1785		p = ((const unsigned char *)buff) + total;
1786		ws = s - total;
1787		if (ws > pax->sparse_list->remaining)
1788			ws = (size_t)pax->sparse_list->remaining;
1789
1790		if (pax->sparse_list->is_hole) {
1791			/* Current block is hole thus we do not write
1792			 * the body. */
1793			pax->sparse_list->remaining -= ws;
1794			total += ws;
1795			continue;
1796		}
1797
1798		ret = __archive_write_output(a, p, ws);
1799		pax->sparse_list->remaining -= ws;
1800		total += ws;
1801		if (ret != ARCHIVE_OK)
1802			return (ret);
1803	}
1804	return (total);
1805}
1806
1807static int
1808has_non_ASCII(const char *_p)
1809{
1810	const unsigned char *p = (const unsigned char *)_p;
1811
1812	if (p == NULL)
1813		return (1);
1814	while (*p != '\0' && *p < 128)
1815		p++;
1816	return (*p != '\0');
1817}
1818
1819/*
1820 * Used by extended attribute support; encodes the name
1821 * so that there will be no '=' characters in the result.
1822 */
1823static char *
1824url_encode(const char *in)
1825{
1826	const char *s;
1827	char *d;
1828	int out_len = 0;
1829	char *out;
1830
1831	for (s = in; *s != '\0'; s++) {
1832		if (*s < 33 || *s > 126 || *s == '%' || *s == '=')
1833			out_len += 3;
1834		else
1835			out_len++;
1836	}
1837
1838	out = (char *)malloc(out_len + 1);
1839	if (out == NULL)
1840		return (NULL);
1841
1842	for (s = in, d = out; *s != '\0'; s++) {
1843		/* encode any non-printable ASCII character or '%' or '=' */
1844		if (*s < 33 || *s > 126 || *s == '%' || *s == '=') {
1845			/* URL encoding is '%' followed by two hex digits */
1846			*d++ = '%';
1847			*d++ = "0123456789ABCDEF"[0x0f & (*s >> 4)];
1848			*d++ = "0123456789ABCDEF"[0x0f & *s];
1849		} else {
1850			*d++ = *s;
1851		}
1852	}
1853	*d = '\0';
1854	return (out);
1855}
1856
1857/*
1858 * Encode a sequence of bytes into a C string using base-64 encoding.
1859 *
1860 * Returns a null-terminated C string allocated with malloc(); caller
1861 * is responsible for freeing the result.
1862 */
1863static char *
1864base64_encode(const char *s, size_t len)
1865{
1866	static const char digits[64] =
1867	    { 'A','B','C','D','E','F','G','H','I','J','K','L','M','N','O',
1868	      'P','Q','R','S','T','U','V','W','X','Y','Z','a','b','c','d',
1869	      'e','f','g','h','i','j','k','l','m','n','o','p','q','r','s',
1870	      't','u','v','w','x','y','z','0','1','2','3','4','5','6','7',
1871	      '8','9','+','/' };
1872	int v;
1873	char *d, *out;
1874
1875	/* 3 bytes becomes 4 chars, but round up and allow for trailing NUL */
1876	out = (char *)malloc((len * 4 + 2) / 3 + 1);
1877	if (out == NULL)
1878		return (NULL);
1879	d = out;
1880
1881	/* Convert each group of 3 bytes into 4 characters. */
1882	while (len >= 3) {
1883		v = (((int)s[0] << 16) & 0xff0000)
1884		    | (((int)s[1] << 8) & 0xff00)
1885		    | (((int)s[2]) & 0x00ff);
1886		s += 3;
1887		len -= 3;
1888		*d++ = digits[(v >> 18) & 0x3f];
1889		*d++ = digits[(v >> 12) & 0x3f];
1890		*d++ = digits[(v >> 6) & 0x3f];
1891		*d++ = digits[(v) & 0x3f];
1892	}
1893	/* Handle final group of 1 byte (2 chars) or 2 bytes (3 chars). */
1894	switch (len) {
1895	case 0: break;
1896	case 1:
1897		v = (((int)s[0] << 16) & 0xff0000);
1898		*d++ = digits[(v >> 18) & 0x3f];
1899		*d++ = digits[(v >> 12) & 0x3f];
1900		break;
1901	case 2:
1902		v = (((int)s[0] << 16) & 0xff0000)
1903		    | (((int)s[1] << 8) & 0xff00);
1904		*d++ = digits[(v >> 18) & 0x3f];
1905		*d++ = digits[(v >> 12) & 0x3f];
1906		*d++ = digits[(v >> 6) & 0x3f];
1907		break;
1908	}
1909	/* Add trailing NUL character so output is a valid C string. */
1910	*d = '\0';
1911	return (out);
1912}
1913
1914static void
1915sparse_list_clear(struct pax *pax)
1916{
1917	while (pax->sparse_list != NULL) {
1918		struct sparse_block *sb = pax->sparse_list;
1919		pax->sparse_list = sb->next;
1920		free(sb);
1921	}
1922	pax->sparse_tail = NULL;
1923}
1924
1925static int
1926_sparse_list_add_block(struct pax *pax, int64_t offset, int64_t length,
1927    int is_hole)
1928{
1929	struct sparse_block *sb;
1930
1931	sb = (struct sparse_block *)malloc(sizeof(*sb));
1932	if (sb == NULL)
1933		return (ARCHIVE_FATAL);
1934	sb->next = NULL;
1935	sb->is_hole = is_hole;
1936	sb->offset = offset;
1937	sb->remaining = length;
1938	if (pax->sparse_list == NULL || pax->sparse_tail == NULL)
1939		pax->sparse_list = pax->sparse_tail = sb;
1940	else {
1941		pax->sparse_tail->next = sb;
1942		pax->sparse_tail = sb;
1943	}
1944	return (ARCHIVE_OK);
1945}
1946
1947static int
1948sparse_list_add(struct pax *pax, int64_t offset, int64_t length)
1949{
1950	int64_t last_offset;
1951	int r;
1952
1953	if (pax->sparse_tail == NULL)
1954		last_offset = 0;
1955	else {
1956		last_offset = pax->sparse_tail->offset +
1957		    pax->sparse_tail->remaining;
1958	}
1959	if (last_offset < offset) {
1960		/* Add a hole block. */
1961		r = _sparse_list_add_block(pax, last_offset,
1962		    offset - last_offset, 1);
1963		if (r != ARCHIVE_OK)
1964			return (r);
1965	}
1966	/* Add data block. */
1967	return (_sparse_list_add_block(pax, offset, length, 0));
1968}
1969
1970