.TH "parrot_namespace" 1 "" "CCTools 8.0.0 DEVELOPMENT" "Cooperative Computing Tools"

.SH NAME
.LP
\fBparrot_namespace\fP - run a command in a modified namespace.

.SH SYNOPSIS
.LP
\FC\fBparrot_cp [options] <command>\fP\FT

.SH DESCRIPTION
.LP

\FCparrot_namespace\FT detects whether it is already running under Parrot
and either forks a new mount namespace in the existing Parrot session or
simply executes \FCparrot_run\FT. For applications that only need to make
mount-related changes, \FCparrot_namespace\FT is a drop-in replacement
for \FCparrot_run\FT that automatically handles nested invocations.

.SH OPTIONS
.LP

.LP
.TP
.B \ -M, --mount /foo=/bar
.
Mount (redirect) \FC/foo\FT
to \FC/bar\FT (\FCPARROT_MOUNT_STRING\FT)
.TP
.B \ -m, --ftab-file <path>
.
Use \FC<file>\FT as a
mountlist (\FCPARROT_MOUNT_FILE\FT)
.TP
\fB-l\fP, \fB-\-ld-path\fP=\fI<path>\fP
.
Path to ld.so to use.
.TP
.B \ --parrot-path
.
Path to \FCparrot_run\FT (\FCPARROT_PATH\FT)
.TP
.B \ -v, --version
.
Show version number
.TP
.B \ -h, --help
.
Help: Show these options


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP

To run Parrot under Parrot with a modified mount environment,
use \FCparrot_namespace\FT

.fam C
.nf
.nh
.IP "" 8
% parrot_namespace -M /tmp=/tmp/job01 sh
% parrot_mount --unmount /tmp    # not allowed
.fi
.hy
.fam
.P

Now in the same shell, we can call \FCparrot_namespace\FT regardless
of whether we're already running under Parrot or not.

.fam C
.nf
.nh
.IP "" 8
% parrot_namespace -m mountfile foo
.fi
.hy
.fam
.P


.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP


.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBParrot User Manual\fP
.IP \(bu 4
\fBparrot_run(1)\fP \fBparrot_cp(1)\fP \fBparrot_getacl(1)\fP  \fBparrot_setacl(1)\fP  \fBparrot_mkalloc(1)\fP  \fBparrot_lsalloc(1)\fP  \fBparrot_locate(1)\fP  \fBparrot_timeout(1)\fP  \fBparrot_whoami(1)\fP  \fBparrot_mount(1)\fP  \fBparrot_md5(1)\fP  \fBparrot_package_create(1)\fP  \fBparrot_package_run(1)\fP  \fBchroot_package_run(1)\fP