1CH-TAR2DIR(1)                    Charliecloud                    CH-TAR2DIR(1)
2
3
4

NAME

6       ch-tar2dir - Unpack an image tarball into a directory
7

SYNOPSIS

9          $ ch-tar2dir TARBALL DIR
10

DESCRIPTION

12       WARNING:
13          This script is deprecated in favor of ch-convert. It will be removed
14          in the next release.
15
16       Extract the tarball TARBALL into a subdirectory of DIR.   TARBALL  must
17       contain  a  Linux  filesystem image, e.g. as created by ch-builder2tar,
18       and be compressed with gzip or xz. If TARBALL has no extension, try ap‐
19       pending .tar.gz and .tar.xz.
20
21       Inside  DIR,  a  subdirectory will be created whose name corresponds to
22       the name of the tarball with .tar.gz or other suffix removed. If such a
23       directory exists already and appears to be a Charliecloud container im‐
24       age, it is removed and replaced. If the existing directory doesn’t  ap‐
25       pear to be a container image, the script aborts with an error.
26
27       Additional arguments:
28
29          --help print help and exit
30
31          --version
32                 print version and exit
33
34       WARNING:
35          Placing  DIR  on a shared file system can cause significant metadata
36          load on the file system servers. This can result in poor performance
37          for you and all your colleagues who use the same file system. Please
38          consult your site admin for a suitable location.
39

EXAMPLE

41          $ ls -lh /var/tmp
42          total 57M
43          -rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz
44          $ ch-tar2dir /var/tmp/hello.tar.gz /var/tmp
45          creating new image /var/tmp/hello
46          /var/tmp/hello unpacked ok
47          $ ls -lh /var/tmp
48          total 57M
49          drwxr-x--- 22 reidpr reidpr 4.0K Feb 13 16:29 hello
50          -rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz
51

REPORTING BUGS

53       If Charliecloud was obtained from your  Linux  distribution,  use  your
54       distribution’s bug reporting procedures.
55
56       Otherwise, report bugs to: https://github.com/hpc/charliecloud/issues
57

SEE ALSO

59       charliecloud(7)
60
61       Full documentation at: <https://hpc.github.io/charliecloud>
62

64       2014–2021, Triad National Security, LLC
65
66
67
68
690.26                         2022-07-20 00:00 UTC                CH-TAR2DIR(1)
Impressum