1CH-TAR2DIR(1) Charliecloud CH-TAR2DIR(1)
2
3
4
6 ch-tar2dir - Unpack an image tarball into a directory
7
9 $ ch-tar2dir TARBALL DIR
10
12 Extract the tarball TARBALL into a subdirectory of DIR. TARBALL must
13 contain a Linux filesystem image, e.g. as created by ch-builder2tar,
14 and be compressed with gzip or xz. If TARBALL has no extension, try
15 appending .tar.gz and .tar.xz.
16
17 Inside DIR, a subdirectory will be created whose name corresponds to
18 the name of the tarball with .tar.gz or other suffix removed. If such a
19 directory exists already and appears to be a Charliecloud container
20 image, it is removed and replaced. If the existing directory doesn’t
21 appear to be a container image, the script aborts with an error.
22
23 Additional arguments:
24
25 --help print help and exit
26
27 --version
28 print version and exit
29
30 WARNING:
31 Placing DIR on a shared file system can cause significant metadata
32 load on the file system servers. This can result in poor performance
33 for you and all your colleagues who use the same file system. Please
34 consult your site admin for a suitable location.
35
37 $ ls -lh /var/tmp
38 total 57M
39 -rw-r----- 1 reidpr reidpr 57M Feb 13 16:14 hello.tar.gz
40 $ ch-tar2dir /var/tmp/hello.tar.gz /var/tmp
41 creating new image /var/tmp/hello
42 /var/tmp/hello unpacked ok
43 $ ls -lh /var/tmp
44 total 57M
45 drwxr-x--- 22 reidpr reidpr 4.0K Feb 13 16:29 hello
46 -rw-r----- 1 reidpr reidpr 57M Feb 13 16:14 hello.tar.gz
47
49 If Charliecloud was obtained from your Linux distribution, use your
50 distribution’s bug reporting procedures.
51
52 Otherwise, report bugs to: <https://github.com/hpc/charliecloud/issues>
53
55 charliecloud(7)
56
57 Full documentation at: <https://hpc.github.io/charliecloud>
58
60 2014–2020, Triad National Security, LLC
61
62
63
64
650.22 2021-03-08 00:00 Coordinated Universal Time CH-TAR2DIR(1)