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       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 ap‐
15       pending .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 im‐
20       age,  it is removed and replaced. If the existing directory doesn’t ap‐
21       pear 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

EXAMPLE

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

REPORTING BUGS

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

SEE ALSO

55       charliecloud(7)
56
57       Full documentation at: <https://hpc.github.io/charliecloud>
58
60       2014–2021, Triad National Security, LLC
61
62
63
64
650.25                         2021-09-20 00:00 UTC                CH-TAR2DIR(1)
Impressum