.\" Man page generated from reStructuredText.
.
.TH "CH-BUILDER2TAR" "1" "2020-12-20 14:44 Coordinated Universal Time" "0.21" "Charliecloud"
.SH NAME
ch-builder2tar \- Flatten a builder image into a Charliecloud image tarball
.
.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\-builder2tar [\-b BUILDER] [\-\-nocompress] IMAGE OUTDIR
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Flatten the builder image tagged \fBIMAGE\fP into a Charliecloud tarball in
directory \fBOUTDIR\fP\&.
.sp
The builder\-specified environment (e.g., \fBENV\fP statements) is placed in
a file in the tarball at \fB$IMAGE/ch/environment\fP, in a form suitable for
\fBch\-run \-\-set\-env\fP\&.
.sp
See \fBch\-build(1)\fP for details on specifying the builder.
.sp
Additional arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-b\fP, \fB\-\-builder BUILDER\fP
Use specified builder; if not given, use \fB$CH_BUILDER\fP or default.
.TP
.B \fB\-\-nocompress\fP
Do not compress tarball.
.TP
.B \fB\-\-help\fP
Print help and exit.
.TP
.B \fB\-\-version\fP
Print version and exit.
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLE
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-builder2tar hello /var/tmp
57M /var/tmp/hello.tar.gz
$ ls \-lh /var/tmp
\-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(7)
.sp
Full documentation at: <\fI\%https://hpc.github.io/charliecloud\fP>
.SH COPYRIGHT
2014–2020, Triad National Security, LLC
.\" Generated by docutils manpage writer.
.