.\" Man page generated from reStructuredText.
.
.TH "CH-PULL2DIR" "1" "2020-12-20 14:44 Coordinated Universal Time" "0.21" "Charliecloud"
.SH NAME
ch-pull2dir \- Pull image from a Docker Hub and unpack into 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\-pull2dir IMAGE[:TAG] DIR
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Pull Docker image named \fBIMAGE[:TAG]\fP from Docker Hub and extract it
into a subdirectory of \fBDIR\fP\&. A temporary tarball is stored in
\fBDIR\fP\&.
.sp
Sudo privileges are required to run the \fBdocker pull\fP command.
.sp
This runs the following command sequence: \fBch\-pull2tar\fP,
\fBch\-tar2dir\fP\&. See warning in the documentation for \fBch\-tar2dir\fP\&.
.sp
Additional arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-\-help\fP
print help and exit
.TP
.B \fB\-\-version\fP
print version and exit
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-pull2dir alpine /var/tmp
Using default tag: latest
latest: Pulling from library/alpine
Digest: sha256:621c2f39f8133acb8e64023a94dbdf0d5ca81896102b9e57c0dc184cadaf5528
Status: Image is up to date for alpine:latest
\-rw\-r\-\-r\-\-. 1 charlie charlie 2.1M Oct  5 19:52 /var/tmp/alpine.tar.gz
creating new image /var/tmp/alpine
/var/tmp/alpine unpacked ok
removed \(aq/var/tmp/alpine.tar.gz\(aq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Same as above, except optional \fBTAG\fP is specified:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-pull2dir alpine:3.6 /var/tmp
3.6: Pulling from library/alpine
Digest: sha256:cc24af836d1377e092ecb4e8f0a4324c3b1aa2b5295c2239edcc7bbc86a9cbc6
Status: Image is up to date for alpine:3.6
\-rw\-r\-\-r\-\-. 1 charlie charlie 2.1M Oct  5 19:54 /var/tmp/alpine:3.6.tar.gz
creating new image /var/tmp/alpine:3.6
/var/tmp/alpine:3.6 unpacked ok
removed \(aq/var/tmp/alpine:3.6.tar.gz\(aq
.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.
.