2 * Copyright (c) 2003-2007 Tim Kientzle
3 * Copyright (c) 2008 Joerg Sonnenberger
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 * IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 #include "archive_platform.h"
28 __FBSDID("$FreeBSD$");
42 #include "archive_entry.h"
43 #include "archive_private.h"
44 #include "archive_write_private.h"
49 struct archive_entry *entry;
53 /* Line buffer for uuencoded dump format */
58 struct archive_string work;
59 struct archive_string quoted_name;
62 static int archive_write_shar_close(struct archive_write *);
63 static int archive_write_shar_free(struct archive_write *);
64 static int archive_write_shar_header(struct archive_write *,
65 struct archive_entry *);
66 static ssize_t archive_write_shar_data_sed(struct archive_write *,
67 const void * buff, size_t);
68 static ssize_t archive_write_shar_data_uuencode(struct archive_write *,
69 const void * buff, size_t);
70 static int archive_write_shar_finish_entry(struct archive_write *);
73 * Copy the given string to the buffer, quoting all shell meta characters
77 shar_quote(struct archive_string *buf, const char *str, int in_shell)
79 static const char meta[] = "\n \t'`\";&<>()|*?{}[]\\$!#^~";
82 while (*str != '\0') {
83 if ((len = strcspn(str, meta)) != 0) {
84 archive_strncat(buf, str, len);
86 } else if (*str == '\n') {
88 archive_strcat(buf, "\"\n\"");
90 archive_strcat(buf, "\\n");
93 archive_strappend_char(buf, '\\');
94 archive_strappend_char(buf, *str);
101 * Set output format to 'shar' format.
104 archive_write_set_format_shar(struct archive *_a)
106 struct archive_write *a = (struct archive_write *)_a;
109 archive_check_magic(_a, ARCHIVE_WRITE_MAGIC,
110 ARCHIVE_STATE_NEW, "archive_write_set_format_shar");
112 /* If someone else was already registered, unregister them. */
113 if (a->format_free != NULL)
116 shar = (struct shar *)calloc(1, sizeof(*shar));
118 archive_set_error(&a->archive, ENOMEM, "Can't allocate shar data");
119 return (ARCHIVE_FATAL);
121 archive_string_init(&shar->work);
122 archive_string_init(&shar->quoted_name);
123 a->format_data = shar;
124 a->format_name = "shar";
125 a->format_write_header = archive_write_shar_header;
126 a->format_close = archive_write_shar_close;
127 a->format_free = archive_write_shar_free;
128 a->format_write_data = archive_write_shar_data_sed;
129 a->format_finish_entry = archive_write_shar_finish_entry;
130 a->archive.archive_format = ARCHIVE_FORMAT_SHAR_BASE;
131 a->archive.archive_format_name = "shar";
136 * An alternate 'shar' that uses uudecode instead of 'sed' to encode
137 * file contents and can therefore be used to archive binary files.
138 * In addition, this variant also attempts to restore ownership, file modes,
139 * and other extended file information.
142 archive_write_set_format_shar_dump(struct archive *_a)
144 struct archive_write *a = (struct archive_write *)_a;
147 archive_write_set_format_shar(&a->archive);
148 shar = (struct shar *)a->format_data;
150 a->format_write_data = archive_write_shar_data_uuencode;
151 a->archive.archive_format = ARCHIVE_FORMAT_SHAR_DUMP;
152 a->archive.archive_format_name = "shar dump";
157 archive_write_shar_header(struct archive_write *a, struct archive_entry *entry)
159 const char *linkname;
164 shar = (struct shar *)a->format_data;
165 if (!shar->wrote_header) {
166 archive_strcat(&shar->work, "#!/bin/sh\n");
167 archive_strcat(&shar->work, "# This is a shell archive\n");
168 shar->wrote_header = 1;
171 /* Save the entry for the closing. */
173 archive_entry_free(shar->entry);
174 shar->entry = archive_entry_clone(entry);
175 name = archive_entry_pathname(entry);
177 /* Handle some preparatory issues. */
178 switch(archive_entry_filetype(entry)) {
180 /* Only regular files have non-zero size. */
183 archive_entry_set_size(entry, 0);
184 /* Don't bother trying to recreate '.' */
185 if (strcmp(name, ".") == 0 || strcmp(name, "./") == 0)
191 /* All other file types have zero size in the archive. */
192 archive_entry_set_size(entry, 0);
195 archive_entry_set_size(entry, 0);
196 if (archive_entry_hardlink(entry) == NULL &&
197 archive_entry_symlink(entry) == NULL) {
198 archive_set_error(&a->archive, ARCHIVE_ERRNO_MISC,
199 "shar format cannot archive this");
200 return (ARCHIVE_WARN);
204 archive_string_empty(&shar->quoted_name);
205 shar_quote(&shar->quoted_name, name, 1);
207 /* Stock preparation for all file types. */
208 archive_string_sprintf(&shar->work, "echo x %s\n", shar->quoted_name.s);
210 if (archive_entry_filetype(entry) != AE_IFDIR) {
211 /* Try to create the dir. */
213 pp = strrchr(p, '/');
214 /* If there is a / character, try to create the dir. */
218 /* Try to avoid a lot of redundant mkdir commands. */
219 if (strcmp(p, ".") == 0) {
220 /* Don't try to "mkdir ." */
222 } else if (shar->last_dir == NULL) {
223 archive_strcat(&shar->work, "mkdir -p ");
224 shar_quote(&shar->work, p, 1);
225 archive_strcat(&shar->work,
226 " > /dev/null 2>&1\n");
228 } else if (strcmp(p, shar->last_dir) == 0) {
229 /* We've already created this exact dir. */
231 } else if (strlen(p) < strlen(shar->last_dir) &&
232 strncmp(p, shar->last_dir, strlen(p)) == 0) {
233 /* We've already created a subdir. */
236 archive_strcat(&shar->work, "mkdir -p ");
237 shar_quote(&shar->work, p, 1);
238 archive_strcat(&shar->work,
239 " > /dev/null 2>&1\n");
247 /* Handle file-type specific issues. */
249 if ((linkname = archive_entry_hardlink(entry)) != NULL) {
250 archive_strcat(&shar->work, "ln -f ");
251 shar_quote(&shar->work, linkname, 1);
252 archive_string_sprintf(&shar->work, " %s\n",
253 shar->quoted_name.s);
254 } else if ((linkname = archive_entry_symlink(entry)) != NULL) {
255 archive_strcat(&shar->work, "ln -fs ");
256 shar_quote(&shar->work, linkname, 1);
257 archive_string_sprintf(&shar->work, " %s\n",
258 shar->quoted_name.s);
260 switch(archive_entry_filetype(entry)) {
262 if (archive_entry_size(entry) == 0) {
263 /* More portable than "touch." */
264 archive_string_sprintf(&shar->work,
265 "test -e \"%s\" || :> \"%s\"\n",
266 shar->quoted_name.s, shar->quoted_name.s);
269 unsigned int mode = archive_entry_mode(entry) & 0777;
270 archive_string_sprintf(&shar->work,
271 "uudecode -p > %s << 'SHAR_END'\n",
272 shar->quoted_name.s);
273 archive_string_sprintf(&shar->work,
275 shar_quote(&shar->work, name, 0);
276 archive_strcat(&shar->work, "\n");
278 archive_string_sprintf(&shar->work,
279 "sed 's/^X//' > %s << 'SHAR_END'\n",
280 shar->quoted_name.s);
283 shar->end_of_line = 1;
288 archive_string_sprintf(&shar->work,
289 "mkdir -p %s > /dev/null 2>&1\n",
290 shar->quoted_name.s);
291 /* Record that we just created this directory. */
292 if (shar->last_dir != NULL)
293 free(shar->last_dir);
295 shar->last_dir = strdup(name);
296 /* Trim a trailing '/'. */
297 pp = strrchr(shar->last_dir, '/');
298 if (pp != NULL && pp[1] == '\0')
301 * TODO: Put dir name/mode on a list to be fixed
302 * up at end of archive.
306 archive_string_sprintf(&shar->work,
307 "mkfifo %s\n", shar->quoted_name.s);
310 archive_string_sprintf(&shar->work,
311 "mknod %s c %ju %ju\n", shar->quoted_name.s,
312 (uintmax_t)archive_entry_rdevmajor(entry),
313 (uintmax_t)archive_entry_rdevminor(entry));
316 archive_string_sprintf(&shar->work,
317 "mknod %s b %ju %ju\n", shar->quoted_name.s,
318 (uintmax_t)archive_entry_rdevmajor(entry),
319 (uintmax_t)archive_entry_rdevminor(entry));
322 return (ARCHIVE_WARN);
330 archive_write_shar_data_sed(struct archive_write *a, const void *buff, size_t n)
332 static const size_t ensured = 65533;
339 shar = (struct shar *)a->format_data;
340 if (!shar->has_data || n == 0)
343 src = (const char *)buff;
346 * ensure is the number of bytes in buffer before expanding the
347 * current character. Each operation writes the current character
348 * and optionally the start-of-new-line marker. This can happen
349 * twice before entering the loop, so make sure three additional
350 * bytes can be written.
352 if (archive_string_ensure(&shar->work, ensured + 3) == NULL) {
353 archive_set_error(&a->archive, ENOMEM, "Out of memory");
354 return (ARCHIVE_FATAL);
357 if (shar->work.length > ensured) {
358 ret = __archive_write_output(a, shar->work.s,
360 if (ret != ARCHIVE_OK)
361 return (ARCHIVE_FATAL);
362 archive_string_empty(&shar->work);
364 buf = shar->work.s + shar->work.length;
365 buf_end = shar->work.s + ensured;
367 if (shar->end_of_line) {
369 shar->end_of_line = 0;
373 if ((*buf++ = *src++) == '\n') {
375 shar->end_of_line = 1;
380 if (buf >= buf_end) {
381 shar->work.length = buf - shar->work.s;
382 ret = __archive_write_output(a, shar->work.s,
384 if (ret != ARCHIVE_OK)
385 return (ARCHIVE_FATAL);
386 archive_string_empty(&shar->work);
391 shar->work.length = buf - shar->work.s;
396 #define UUENC(c) (((c)!=0) ? ((c) & 077) + ' ': '`')
399 uuencode_group(const char _in[3], char out[4])
401 const unsigned char *in = (const unsigned char *)_in;
404 t = (in[0] << 16) | (in[1] << 8) | in[2];
405 out[0] = UUENC( 0x3f & (t >> 18) );
406 out[1] = UUENC( 0x3f & (t >> 12) );
407 out[2] = UUENC( 0x3f & (t >> 6) );
408 out[3] = UUENC( 0x3f & t );
412 _uuencode_line(struct archive_write *a, struct shar *shar, const char *inbuf, size_t len)
417 /* len <= 45 -> expanded to 60 + len byte + new line */
418 alloc_len = shar->work.length + 62;
419 if (archive_string_ensure(&shar->work, alloc_len) == NULL) {
420 archive_set_error(&a->archive, ENOMEM, "Out of memory");
421 return (ARCHIVE_FATAL);
424 buf = shar->work.s + shar->work.length;
427 uuencode_group(inbuf, buf);
434 tmp_buf[0] = inbuf[0];
438 tmp_buf[1] = inbuf[1];
440 uuencode_group(tmp_buf, buf);
444 if ((buf - shar->work.s) > (ptrdiff_t)(shar->work.length + 62)) {
445 archive_set_error(&a->archive,
446 ARCHIVE_ERRNO_MISC, "Buffer overflow");
447 return (ARCHIVE_FATAL);
449 shar->work.length = buf - shar->work.s;
453 #define uuencode_line(__a, __shar, __inbuf, __len) \
455 int r = _uuencode_line(__a, __shar, __inbuf, __len); \
456 if (r != ARCHIVE_OK) \
457 return (ARCHIVE_FATAL); \
461 archive_write_shar_data_uuencode(struct archive_write *a, const void *buff,
469 shar = (struct shar *)a->format_data;
472 src = (const char *)buff;
474 if (shar->outpos != 0) {
475 n = 45 - shar->outpos;
478 memcpy(shar->outbuff + shar->outpos, src, n);
479 if (shar->outpos + n < 45) {
483 uuencode_line(a, shar, shar->outbuff, 45);
491 uuencode_line(a, shar, src, 45);
495 if (shar->work.length < 65536)
497 ret = __archive_write_output(a, shar->work.s,
499 if (ret != ARCHIVE_OK)
500 return (ARCHIVE_FATAL);
501 archive_string_empty(&shar->work);
504 memcpy(shar->outbuff, src, n);
511 archive_write_shar_finish_entry(struct archive_write *a)
513 const char *g, *p, *u;
517 shar = (struct shar *)a->format_data;
518 if (shar->entry == NULL)
522 /* Finish uuencoded data. */
523 if (shar->has_data) {
524 if (shar->outpos > 0)
525 uuencode_line(a, shar, shar->outbuff,
527 archive_strcat(&shar->work, "`\nend\n");
528 archive_strcat(&shar->work, "SHAR_END\n");
530 /* Restore file mode, owner, flags. */
532 * TODO: Don't immediately restore mode for
533 * directories; defer that to end of script.
535 archive_string_sprintf(&shar->work, "chmod %o ",
536 (unsigned int)(archive_entry_mode(shar->entry) & 07777));
537 shar_quote(&shar->work, archive_entry_pathname(shar->entry), 1);
538 archive_strcat(&shar->work, "\n");
540 u = archive_entry_uname(shar->entry);
541 g = archive_entry_gname(shar->entry);
542 if (u != NULL || g != NULL) {
543 archive_strcat(&shar->work, "chown ");
545 shar_quote(&shar->work, u, 1);
547 archive_strcat(&shar->work, ":");
548 shar_quote(&shar->work, g, 1);
550 archive_strcat(&shar->work, " ");
551 shar_quote(&shar->work,
552 archive_entry_pathname(shar->entry), 1);
553 archive_strcat(&shar->work, "\n");
556 if ((p = archive_entry_fflags_text(shar->entry)) != NULL) {
557 archive_string_sprintf(&shar->work, "chflags %s ", p);
558 shar_quote(&shar->work,
559 archive_entry_pathname(shar->entry), 1);
560 archive_strcat(&shar->work, "\n");
563 /* TODO: restore ACLs */
566 if (shar->has_data) {
567 /* Finish sed-encoded data: ensure last line ends. */
568 if (!shar->end_of_line)
569 archive_strappend_char(&shar->work, '\n');
570 archive_strcat(&shar->work, "SHAR_END\n");
574 archive_entry_free(shar->entry);
577 if (shar->work.length < 65536)
580 ret = __archive_write_output(a, shar->work.s, shar->work.length);
581 if (ret != ARCHIVE_OK)
582 return (ARCHIVE_FATAL);
583 archive_string_empty(&shar->work);
589 archive_write_shar_close(struct archive_write *a)
595 * TODO: Accumulate list of directory names/modes and
596 * fix them all up at end-of-archive.
599 shar = (struct shar *)a->format_data;
602 * Only write the end-of-archive markers if the archive was
603 * actually started. This avoids problems if someone sets
604 * shar format, then sets another format (which would invoke
605 * shar_finish to free the format-specific data).
607 if (shar->wrote_header == 0)
610 archive_strcat(&shar->work, "exit\n");
612 ret = __archive_write_output(a, shar->work.s, shar->work.length);
613 if (ret != ARCHIVE_OK)
614 return (ARCHIVE_FATAL);
616 /* Shar output is never padded. */
617 archive_write_set_bytes_in_last_block(&a->archive, 1);
619 * TODO: shar should also suppress padding of
620 * uncompressed data within gzip/bzip2 streams.
627 archive_write_shar_free(struct archive_write *a)
631 shar = (struct shar *)a->format_data;
635 archive_entry_free(shar->entry);
636 free(shar->last_dir);
637 archive_string_free(&(shar->work));
638 archive_string_free(&(shar->quoted_name));
640 a->format_data = NULL;