.\" Man page generated from reStructuredText.
.
.TH "CH-TAR2DIR" "1" "2018-12-14 19:09 Coordinated Universal Time" "" "Charliecloud"
.SH NAME
ch-tar2dir \- Unpack an image tarball into a directory
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-tar2dir TARBALL DIR
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Extract the tarball \fBTARBALL\fP into a subdirectory of \fBDIR\fP\&.
\fBTARBALL\fP must contain a Linux filesystem image, e.g. as created by
\fBch\-docker2tar\fP\&.
.sp
Inside \fBDIR\fP, a subdirectory will be created whose name corresponds to
the name of the tarball with the \fB\&.tar.gz\fP 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.
.sp
Additional arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-\-help\fP
print help and exit
.TP
.B \fB\-\-verbose\fP
be more verbose
.TP
.B \fB\-\-version\fP
print version and exit
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBWARNING:\fP
.INDENT 0.0
.INDENT 3.5
Placing \fBDIR\fP 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.
.UNINDENT
.UNINDENT
.SH EXAMPLE
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ 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
.ft P
.fi
.UNINDENT
.UNINDENT
.SH REPORTING BUGS
.sp
If Charliecloud was obtained from your Linux distribution, use your
distribution’s bug reporting procedures.
.sp
Otherwise, report bugs to: <\fI\%https://github.com/hpc/charliecloud/issues\fP>
.SH SEE ALSO
.sp
charliecloud(1)
.sp
Full documentation at: <\fI\%https://hpc.github.io/charliecloud\fP>
.SH AUTHOR
Reid Priedhorsky, Tim Randles, and others
.SH COPYRIGHT
2014–2018, Los Alamos National Security, LLC
.\" Generated by docutils manpage writer.
.