busybox: update to 1.23.2
[tomato.git] / release / src / router / busybox / archival / cpio.c
blob454648d6824bef6c3374e26cd369a00cfdcb21bf
1 /* vi: set sw=4 ts=4: */
2 /*
3 * Mini cpio implementation for busybox
5 * Copyright (C) 2001 by Glenn McGrath
7 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
9 * Limitations:
10 * Doesn't check CRC's
11 * Only supports new ASCII and CRC formats
13 #include "libbb.h"
14 #include "bb_archive.h"
16 //config:config CPIO
17 //config: bool "cpio"
18 //config: default y
19 //config: help
20 //config: cpio is an archival utility program used to create, modify, and
21 //config: extract contents from archives.
22 //config: cpio has 110 bytes of overheads for every stored file.
23 //config:
24 //config: This implementation of cpio can extract cpio archives created in the
25 //config: "newc" or "crc" format, it cannot create or modify them.
26 //config:
27 //config: Unless you have a specific application which requires cpio, you
28 //config: should probably say N here.
29 //config:
30 //config:config FEATURE_CPIO_O
31 //config: bool "Support for archive creation"
32 //config: default y
33 //config: depends on CPIO
34 //config: help
35 //config: This implementation of cpio can create cpio archives in the "newc"
36 //config: format only.
37 //config:
38 //config:config FEATURE_CPIO_P
39 //config: bool "Support for passthrough mode"
40 //config: default y
41 //config: depends on FEATURE_CPIO_O
42 //config: help
43 //config: Passthrough mode. Rarely used.
45 //applet:IF_CPIO(APPLET(cpio, BB_DIR_BIN, BB_SUID_DROP))
46 //kbuild:lib-$(CONFIG_CPIO) += cpio.o
48 //usage:#define cpio_trivial_usage
49 //usage: "[-dmvu] [-F FILE]" IF_FEATURE_CPIO_O(" [-H newc]")
50 //usage: " [-ti"IF_FEATURE_CPIO_O("o")"]" IF_FEATURE_CPIO_P(" [-p DIR]")
51 //usage: " [EXTR_FILE]..."
52 //usage:#define cpio_full_usage "\n\n"
53 //usage: "Extract or list files from a cpio archive"
54 //usage: IF_FEATURE_CPIO_O(", or"
55 //usage: "\ncreate an archive" IF_FEATURE_CPIO_P(" (-o) or copy files (-p)")
56 //usage: " using file list on stdin"
57 //usage: )
58 //usage: "\n"
59 //usage: "\nMain operation mode:"
60 //usage: "\n -t List"
61 //usage: "\n -i Extract EXTR_FILEs (or all)"
62 //usage: IF_FEATURE_CPIO_O(
63 //usage: "\n -o Create (requires -H newc)"
64 //usage: )
65 //usage: IF_FEATURE_CPIO_P(
66 //usage: "\n -p DIR Copy files to DIR"
67 //usage: )
68 //usage: "\nOptions:"
69 //usage: "\n -d Make leading directories"
70 //usage: "\n -m Preserve mtime"
71 //usage: "\n -v Verbose"
72 //usage: "\n -u Overwrite"
73 //usage: "\n -F FILE Input (-t,-i,-p) or output (-o) file"
74 //usage: IF_FEATURE_CPIO_O(
75 //usage: "\n -H newc Archive format"
76 //usage: )
78 /* GNU cpio 2.9 --help (abridged):
80 Modes:
81 -t, --list List the archive
82 -i, --extract Extract files from an archive
83 -o, --create Create the archive
84 -p, --pass-through Copy-pass mode
86 Options valid in any mode:
87 --block-size=SIZE I/O block size = SIZE * 512 bytes
88 -B I/O block size = 5120 bytes
89 -c Use the old portable (ASCII) archive format
90 -C, --io-size=NUMBER I/O block size in bytes
91 -f, --nonmatching Only copy files that do not match given pattern
92 -F, --file=FILE Use FILE instead of standard input or output
93 -H, --format=FORMAT Use given archive FORMAT
94 -M, --message=STRING Print STRING when the end of a volume of the
95 backup media is reached
96 -n, --numeric-uid-gid If -v, show numeric UID and GID
97 --quiet Do not print the number of blocks copied
98 --rsh-command=COMMAND Use remote COMMAND instead of rsh
99 -v, --verbose Verbosely list the files processed
100 -V, --dot Print a "." for each file processed
101 -W, --warning=FLAG Control warning display: 'none','truncate','all';
102 multiple options accumulate
104 Options valid only in --extract mode:
105 -b, --swap Swap both halfwords of words and bytes of
106 halfwords in the data (equivalent to -sS)
107 -r, --rename Interactively rename files
108 -s, --swap-bytes Swap the bytes of each halfword in the files
109 -S, --swap-halfwords Swap the halfwords of each word (4 bytes)
110 --to-stdout Extract files to standard output
111 -E, --pattern-file=FILE Read additional patterns specifying filenames to
112 extract or list from FILE
113 --only-verify-crc Verify CRC's, don't actually extract the files
115 Options valid only in --create mode:
116 -A, --append Append to an existing archive
117 -O FILE File to use instead of standard output
119 Options valid only in --pass-through mode:
120 -l, --link Link files instead of copying them, when possible
122 Options valid in --extract and --create modes:
123 --absolute-filenames Do not strip file system prefix components from
124 the file names
125 --no-absolute-filenames Create all files relative to the current dir
127 Options valid in --create and --pass-through modes:
128 -0, --null A list of filenames is terminated by a NUL
129 -a, --reset-access-time Reset the access times of files after reading them
130 -I FILE File to use instead of standard input
131 -L, --dereference Dereference symbolic links (copy the files
132 that they point to instead of copying the links)
133 -R, --owner=[USER][:.][GROUP] Set owner of created files
135 Options valid in --extract and --pass-through modes:
136 -d, --make-directories Create leading directories where needed
137 -m, --preserve-modification-time Retain mtime when creating files
138 --no-preserve-owner Do not change the ownership of the files
139 --sparse Write files with blocks of zeros as sparse files
140 -u, --unconditional Replace all files unconditionally
143 enum {
144 OPT_EXTRACT = (1 << 0),
145 OPT_TEST = (1 << 1),
146 OPT_NUL_TERMINATED = (1 << 2),
147 OPT_UNCONDITIONAL = (1 << 3),
148 OPT_VERBOSE = (1 << 4),
149 OPT_CREATE_LEADING_DIR = (1 << 5),
150 OPT_PRESERVE_MTIME = (1 << 6),
151 OPT_DEREF = (1 << 7),
152 OPT_FILE = (1 << 8),
153 OPTBIT_FILE = 8,
154 IF_FEATURE_CPIO_O(OPTBIT_CREATE ,)
155 IF_FEATURE_CPIO_O(OPTBIT_FORMAT ,)
156 IF_FEATURE_CPIO_P(OPTBIT_PASSTHROUGH,)
157 IF_LONG_OPTS( OPTBIT_QUIET ,)
158 IF_LONG_OPTS( OPTBIT_2STDOUT ,)
159 OPT_CREATE = IF_FEATURE_CPIO_O((1 << OPTBIT_CREATE )) + 0,
160 OPT_FORMAT = IF_FEATURE_CPIO_O((1 << OPTBIT_FORMAT )) + 0,
161 OPT_PASSTHROUGH = IF_FEATURE_CPIO_P((1 << OPTBIT_PASSTHROUGH)) + 0,
162 OPT_QUIET = IF_LONG_OPTS( (1 << OPTBIT_QUIET )) + 0,
163 OPT_2STDOUT = IF_LONG_OPTS( (1 << OPTBIT_2STDOUT )) + 0,
166 #define OPTION_STR "it0uvdmLF:"
168 #if ENABLE_FEATURE_CPIO_O
169 static off_t cpio_pad4(off_t size)
171 int i;
173 i = (- size) & 3;
174 size += i;
175 while (--i >= 0)
176 bb_putchar('\0');
177 return size;
180 /* Return value will become exit code.
181 * It's ok to exit instead of return. */
182 static NOINLINE int cpio_o(void)
184 static const char trailer[] ALIGN1 = "TRAILER!!!";
185 struct name_s {
186 struct name_s *next;
187 char name[1];
189 struct inodes_s {
190 struct inodes_s *next;
191 struct name_s *names;
192 struct stat st;
195 struct inodes_s *links = NULL;
196 off_t bytes = 0; /* output bytes count */
198 while (1) {
199 const char *name;
200 char *line;
201 struct stat st;
203 line = (option_mask32 & OPT_NUL_TERMINATED)
204 ? bb_get_chunk_from_file(stdin, NULL)
205 : xmalloc_fgetline(stdin);
207 if (line) {
208 /* Strip leading "./[./]..." from the filename */
209 name = line;
210 while (name[0] == '.' && name[1] == '/') {
211 while (*++name == '/')
212 continue;
214 if (!*name) { /* line is empty */
215 free(line);
216 continue;
218 if ((option_mask32 & OPT_DEREF)
219 ? stat(name, &st)
220 : lstat(name, &st)
222 abort_cpio_o:
223 bb_simple_perror_msg_and_die(name);
226 if (!(S_ISLNK(st.st_mode) || S_ISREG(st.st_mode)))
227 st.st_size = 0; /* paranoia */
229 /* Store hardlinks for later processing, dont output them */
230 if (!S_ISDIR(st.st_mode) && st.st_nlink > 1) {
231 struct name_s *n;
232 struct inodes_s *l;
234 /* Do we have this hardlink remembered? */
235 l = links;
236 while (1) {
237 if (l == NULL) {
238 /* Not found: add new item to "links" list */
239 l = xzalloc(sizeof(*l));
240 l->st = st;
241 l->next = links;
242 links = l;
243 break;
245 if (l->st.st_ino == st.st_ino) {
246 /* found */
247 break;
249 l = l->next;
251 /* Add new name to "l->names" list */
252 n = xmalloc(sizeof(*n) + strlen(name));
253 strcpy(n->name, name);
254 n->next = l->names;
255 l->names = n;
257 free(line);
258 continue;
261 } else { /* line == NULL: EOF */
262 next_link:
263 if (links) {
264 /* Output hardlink's data */
265 st = links->st;
266 name = links->names->name;
267 links->names = links->names->next;
268 /* GNU cpio is reported to emit file data
269 * only for the last instance. Mimic that. */
270 if (links->names == NULL)
271 links = links->next;
272 else
273 st.st_size = 0;
274 /* NB: we leak links->names and/or links,
275 * this is intended (we exit soon anyway) */
276 } else {
277 /* If no (more) hardlinks to output,
278 * output "trailer" entry */
279 name = trailer;
280 /* st.st_size == 0 is a must, but for uniformity
281 * in the output, we zero out everything */
282 memset(&st, 0, sizeof(st));
283 /* st.st_nlink = 1; - GNU cpio does this */
287 bytes += printf("070701"
288 "%08X%08X%08X%08X%08X%08X%08X"
289 "%08X%08X%08X%08X" /* GNU cpio uses uppercase hex */
290 /* strlen+1: */ "%08X"
291 /* chksum: */ "00000000" /* (only for "070702" files) */
292 /* name,NUL: */ "%s%c",
293 (unsigned)(uint32_t) st.st_ino,
294 (unsigned)(uint32_t) st.st_mode,
295 (unsigned)(uint32_t) st.st_uid,
296 (unsigned)(uint32_t) st.st_gid,
297 (unsigned)(uint32_t) st.st_nlink,
298 (unsigned)(uint32_t) st.st_mtime,
299 (unsigned)(uint32_t) st.st_size,
300 (unsigned)(uint32_t) major(st.st_dev),
301 (unsigned)(uint32_t) minor(st.st_dev),
302 (unsigned)(uint32_t) major(st.st_rdev),
303 (unsigned)(uint32_t) minor(st.st_rdev),
304 (unsigned)(strlen(name) + 1),
305 name, '\0');
306 bytes = cpio_pad4(bytes);
308 if (st.st_size) {
309 if (S_ISLNK(st.st_mode)) {
310 char *lpath = xmalloc_readlink_or_warn(name);
311 if (!lpath)
312 goto abort_cpio_o;
313 bytes += printf("%s", lpath);
314 free(lpath);
315 } else { /* S_ISREG */
316 int fd = xopen(name, O_RDONLY);
317 fflush_all();
318 /* We must abort if file got shorter too! */
319 bb_copyfd_exact_size(fd, STDOUT_FILENO, st.st_size);
320 bytes += st.st_size;
321 close(fd);
323 bytes = cpio_pad4(bytes);
326 if (!line) {
327 if (name != trailer)
328 goto next_link;
329 /* TODO: GNU cpio pads trailer to 512 bytes, do we want that? */
330 return EXIT_SUCCESS;
333 free(line);
334 } /* end of "while (1)" */
336 #endif
338 int cpio_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
339 int cpio_main(int argc UNUSED_PARAM, char **argv)
341 archive_handle_t *archive_handle;
342 char *cpio_filename;
343 IF_FEATURE_CPIO_O(const char *cpio_fmt = "";)
344 unsigned opt;
346 #if ENABLE_LONG_OPTS
347 applet_long_options =
348 "extract\0" No_argument "i"
349 "list\0" No_argument "t"
350 #if ENABLE_FEATURE_CPIO_O
351 "create\0" No_argument "o"
352 "format\0" Required_argument "H"
353 #if ENABLE_FEATURE_CPIO_P
354 "pass-through\0" No_argument "p"
355 #endif
356 #endif
357 "verbose\0" No_argument "v"
358 "quiet\0" No_argument "\xff"
359 "to-stdout\0" No_argument "\xfe"
361 #endif
363 archive_handle = init_handle();
364 /* archive_handle->src_fd = STDIN_FILENO; - done by init_handle */
365 archive_handle->ah_flags = ARCHIVE_EXTRACT_NEWER;
367 /* As of now we do not enforce this: */
368 /* -i,-t,-o,-p are mutually exclusive */
369 /* -u,-d,-m make sense only with -i or -p */
370 /* -L makes sense only with -o or -p */
372 #if !ENABLE_FEATURE_CPIO_O
373 opt = getopt32(argv, OPTION_STR, &cpio_filename);
374 argv += optind;
375 if (opt & OPT_FILE) { /* -F */
376 xmove_fd(xopen(cpio_filename, O_RDONLY), STDIN_FILENO);
378 #else
379 opt = getopt32(argv, OPTION_STR "oH:" IF_FEATURE_CPIO_P("p"), &cpio_filename, &cpio_fmt);
380 argv += optind;
381 if ((opt & (OPT_FILE|OPT_CREATE)) == OPT_FILE) { /* -F without -o */
382 xmove_fd(xopen(cpio_filename, O_RDONLY), STDIN_FILENO);
384 if (opt & OPT_PASSTHROUGH) {
385 pid_t pid;
386 struct fd_pair pp;
388 if (argv[0] == NULL)
389 bb_show_usage();
390 if (opt & OPT_CREATE_LEADING_DIR)
391 mkdir(argv[0], 0777);
392 /* Crude existence check:
393 * close(xopen(argv[0], O_RDONLY | O_DIRECTORY));
394 * We can also xopen, fstat, IS_DIR, later fchdir.
395 * This would check for existence earlier and cleaner.
396 * As it stands now, if we fail xchdir later,
397 * child dies on EPIPE, unless it caught
398 * a diffrerent problem earlier.
399 * This is good enough for now.
401 #if !BB_MMU
402 pp.rd = 3;
403 pp.wr = 4;
404 if (!re_execed) {
405 close(3);
406 close(4);
407 xpiped_pair(pp);
409 #else
410 xpiped_pair(pp);
411 #endif
412 pid = fork_or_rexec(argv - optind);
413 if (pid == 0) { /* child */
414 close(pp.rd);
415 xmove_fd(pp.wr, STDOUT_FILENO);
416 goto dump;
418 /* parent */
419 USE_FOR_NOMMU(argv[-optind][0] &= 0x7f); /* undo fork_or_rexec() damage */
420 xchdir(*argv++);
421 close(pp.wr);
422 xmove_fd(pp.rd, STDIN_FILENO);
423 //opt &= ~OPT_PASSTHROUGH;
424 opt |= OPT_EXTRACT;
425 goto skip;
427 /* -o */
428 if (opt & OPT_CREATE) {
429 if (cpio_fmt[0] != 'n') /* we _require_ "-H newc" */
430 bb_show_usage();
431 if (opt & OPT_FILE) {
432 xmove_fd(xopen(cpio_filename, O_WRONLY | O_CREAT | O_TRUNC), STDOUT_FILENO);
434 dump:
435 return cpio_o();
437 skip:
438 #endif
440 /* One of either extract or test options must be given */
441 if ((opt & (OPT_TEST | OPT_EXTRACT)) == 0) {
442 bb_show_usage();
445 if (opt & OPT_TEST) {
446 /* if both extract and test options are given, ignore extract option */
447 opt &= ~OPT_EXTRACT;
448 archive_handle->action_header = header_list;
450 if (opt & OPT_EXTRACT) {
451 archive_handle->action_data = data_extract_all;
452 if (opt & OPT_2STDOUT)
453 archive_handle->action_data = data_extract_to_stdout;
455 if (opt & OPT_UNCONDITIONAL) {
456 archive_handle->ah_flags |= ARCHIVE_UNLINK_OLD;
457 archive_handle->ah_flags &= ~ARCHIVE_EXTRACT_NEWER;
459 if (opt & OPT_VERBOSE) {
460 if (archive_handle->action_header == header_list) {
461 archive_handle->action_header = header_verbose_list;
462 } else {
463 archive_handle->action_header = header_list;
466 if (opt & OPT_CREATE_LEADING_DIR) {
467 archive_handle->ah_flags |= ARCHIVE_CREATE_LEADING_DIRS;
469 if (opt & OPT_PRESERVE_MTIME) {
470 archive_handle->ah_flags |= ARCHIVE_RESTORE_DATE;
473 while (*argv) {
474 archive_handle->filter = filter_accept_list;
475 llist_add_to(&archive_handle->accept, *argv);
476 argv++;
479 /* see get_header_cpio */
480 archive_handle->cpio__blocks = (off_t)-1;
481 while (get_header_cpio(archive_handle) == EXIT_SUCCESS)
482 continue;
484 if (archive_handle->cpio__blocks != (off_t)-1
485 && !(opt & OPT_QUIET)
487 fprintf(stderr, "%"OFF_FMT"u blocks\n", archive_handle->cpio__blocks);
490 return EXIT_SUCCESS;