summaryrefslogtreecommitdiff
path: root/usr/src/man/man1m/chroot.1m
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1m/chroot.1m')
-rw-r--r--usr/src/man/man1m/chroot.1m133
1 files changed, 0 insertions, 133 deletions
diff --git a/usr/src/man/man1m/chroot.1m b/usr/src/man/man1m/chroot.1m
deleted file mode 100644
index 1c58398f24..0000000000
--- a/usr/src/man/man1m/chroot.1m
+++ /dev/null
@@ -1,133 +0,0 @@
-'\" te
-.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
-.\" Copyright 1989 AT&T
-.\"
-.\" The contents of this file are subject to the terms of the
-.\" Common Development and Distribution License (the "License").
-.\" You may not use this file except in compliance with the License.
-.\"
-.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
-.\" or http://www.opensolaris.org/os/licensing.
-.\" See the License for the specific language governing permissions
-.\" and limitations under the License.
-.\"
-.\" When distributing Covered Code, include this CDDL HEADER in each
-.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
-.\" If applicable, add the following below this CDDL HEADER, with the
-.\" fields enclosed by brackets "[]" replaced with your own identifying
-.\" information: Portions Copyright [yyyy] [name of copyright owner]
-.\"
-.\" Portions Copyright 2021 OmniOS Community Edition (OmniOSce) Association.
-.\"
-.Dd March 18, 2021
-.Dt CHROOT 1M
-.Os
-.Sh NAME
-.Nm chroot
-.Nd change root directory for a command
-.Sh SYNOPSIS
-.Nm
-.Ar newroot
-.Ar command
-.Sh DESCRIPTION
-The
-.Nm
-utility causes
-.Ar command
-to be executed relative to
-.Ar newroot .
-The meaning of any initial slash
-.Pq /
-in the path names is changed to
-.Ar newroot
-for
-.Ar command
-and any of its child processes.
-Upon execution, the initial working directory is
-.Ar newroot .
-.Pp
-Notice that redirecting the output of
-.Ar command
-to a file, such as in:
-.Pp
-.D1 Nm chroot Ar newroot Ar command Sy > Pa xyz
-.Pp
-will create the file
-.Pa xyz
-relative to the original root of
-.Ar command ,
-not the new one.
-.Pp
-The new root path name is always relative to the current root.
-Even if a
-.Nm
-is currently in effect, the
-.Ar newroot
-argument is relative to the current root of the running process.
-.Pp
-This command can be run only by the super-user.
-.Sh EXIT STATUS
-The exit status of
-.Nm
-is the exit status of
-.Ar command .
-.Sh OPERANDS
-The following operands are supported:
-.Bl -tag -width Ar
-.It Ar newroot
-The new root directory.
-.It Ar command
-The command to be executed relative to
-.Ar newroot .
-.El
-.Sh EXAMPLES
-.Sy Example 1
-Using the
-.Nm
-Utility
-.Pp
-The
-.Nm
-utility provides an easy way to extract
-.Sy tar
-files
-.Pq see Xr tar 1
-written with absolute filenames to a different location.
-It is necessary to copy the shared libraries used by
-.Sy tar
-.Pq see Xr ldd 1
-to the
-.Ar newroot
-filesystem.
-.Bd -literal -offset indent
-example# mkdir -p /tmp/lib /tmp/usr/lib
-example# cd /lib && cp ld.so.1 \e
- libavl.so.1 libc.so.1 libcmdutils.so.1 libcustr.so.1 \e
- libm.so.2 libmd.so.1 libmp.so.2 libnsl.so.1 \e
- libnvpair.so.1 libsec.so.1 libsecdb.so.1 libtsol.so.2 \e
- libuutil.so.1 /tmp/lib/
-example# cp /usr/lib/libidmap.so.1 /tmp/usr/lib/
-example# cp /usr/bin/tar /tmp
-example# dd if=/dev/rmt/0 | chroot /tmp tar xvf -
-.Ed
-.Sh SEE ALSO
-.Xr cd 1 ,
-.Xr ldd 1 ,
-.Xr tar 1 ,
-.Xr chroot 2 ,
-.Xr ttyname 3C ,
-.Xr attributes 5
-.Sh NOTES
-Exercise extreme caution when referencing device files in the new root file
-system.
-.Pp
-References by routines such as
-.Xr ttyname 3C
-to
-.Dv stdin ,
-.Dv stdout ,
-and
-.Dv stderr
-will find that the device associated with the file descriptor is unknown after
-.Nm
-is run.