.\" Man page generated from reStructuredText.
.
.TH "CH-SSH" "1" "2018-12-14 19:09 Coordinated Universal Time" "" "Charliecloud"
.SH NAME
ch-ssh \- Run a remote command in a Charliecloud container
.
.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_RUN_ARGS="NEWROOT [ARG...]"
$ ch\-ssh [OPTION...] HOST CMD [ARG...]
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Runs command \fBCMD\fP in a Charliecloud container on remote host
\fBHOST\fP\&. Use the content of environment variable \fBCH_RUN_ARGS\fP as
the arguments to \fBch\-run\fP on the remote host.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
Words in \fBCH_RUN_ARGS\fP are delimited by spaces only; it is not shell
syntax.
.UNINDENT
.UNINDENT
.SH EXAMPLE
.sp
On host bar.example.com, run the command \fBecho hello\fP inside a
Charliecloud container using the unpacked image at \fB/data/foo\fP with
starting directory \fB/baz\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ hostname
foo
$ export CH_RUN_ARGS=\(aq\-\-cd /baz /data/foo\(aq
$ ch\-ssh bar.example.com \-\- hostname
bar
.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.
.