NAME

       ch-tar2dir - Unpack an image tarball into a directory

SYNOPSIS

          $ ch-tar2dir TARBALL DIR

DESCRIPTION

       WARNING:
          This script is deprecated in favor of ch-convert. It will be removed in the next release.

       Extract  the  tarball TARBALL into a subdirectory of DIR.  TARBALL must contain a Linux filesystem image,
       e.g. as created by ch-builder2tar, and be compressed with gzip or xz. If TARBALL has  no  extension,  try
       appending .tar.gz and .tar.xz.

       Inside DIR, a subdirectory will be created whose name corresponds to the name of the tarball with .tar.gz
       or  other  suffix  removed. If such a directory exists already and appears to be a Charliecloud container
       image, it is removed and replaced. If the existing directory doesn’t appear to be a container image,  the
       script aborts with an error.

       Additional arguments:

          --help print help and exit

          --version
                 print version and exit

       WARNING:
          Placing  DIR  on  a shared file system can cause significant metadata load on the file system servers.
          This can result in poor performance for you and all your colleagues who  use  the  same  file  system.
          Please consult your site admin for a suitable location.

EXAMPLE

          $ ls -lh /var/tmp
          total 57M
          -rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz
          $ ch-tar2dir /var/tmp/hello.tar.gz /var/tmp
          creating new image /var/tmp/hello
          /var/tmp/hello unpacked ok
          $ ls -lh /var/tmp
          total 57M
          drwxr-x--- 22 reidpr reidpr 4.0K Feb 13 16:29 hello
          -rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz

REPORTING BUGS

       If  Charliecloud  was  obtained  from  your  Linux  distribution,  use  your distribution’s bug reporting
       procedures.

       Otherwise, report bugs to: https://github.com/hpc/charliecloud/issues

SEE ALSO

       charliecloud(7)

       Full documentation at: <https://hpc.github.io/charliecloud>

COPYRIGHT

       2014–2021, Triad National Security, LLC

0.26                                          2022-01-30 10:06 UTC                                 CH-TAR2DIR(1)