table of contents
CH-TAR2DIR(1) | Charliecloud | CH-TAR2DIR(1) |
NAME¶
ch-tar2dir - Unpack an image tarball into a directorySYNOPSIS¶
$ ch-tar2dir TARBALL DIR
DESCRIPTION¶
Extract the tarball TARBALL into a subdirectory of DIR. TARBALL must contain a Linux filesystem image, e.g. as created by ch-docker2tar.Inside DIR, a subdirectory will be created whose name corresponds to the name of the tarball with the .tar.gz 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
- --verbose
- be more verbose
- --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(1)Full documentation at: <https://hpc.github.io/charliecloud>
AUTHOR¶
Reid Priedhorsky, Tim Randles, and othersCOPYRIGHT¶
2014–2018, Los Alamos National Security, LLC2018-12-14 19:09 Coordinated Universal Time |