summaryrefslogtreecommitdiff
path: root/usr/src/man/man5/lx.5
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man5/lx.5')
-rw-r--r--usr/src/man/man5/lx.5113
1 files changed, 0 insertions, 113 deletions
diff --git a/usr/src/man/man5/lx.5 b/usr/src/man/man5/lx.5
deleted file mode 100644
index 9ad903a396..0000000000
--- a/usr/src/man/man5/lx.5
+++ /dev/null
@@ -1,113 +0,0 @@
-.\"
-.\" This file and its contents are supplied under the terms of the
-.\" Common Development and Distribution License ("CDDL"), version 1.0.
-.\" You may only use this file in accordance with the terms of version
-.\" 1.0 of the CDDL.
-.\"
-.\" A full copy of the text of the CDDL should have accompanied this
-.\" source. A copy of the CDDL is also available via the Internet at
-.\" http://www.illumos.org/license/CDDL.
-.\"
-.\"
-.\" Copyright 2016, Joyent, Inc.
-.\"
-.Dd February 5, 2106
-.Dt LX 5
-.Os
-.Sh NAME
-.Nm lx
-.Nd zone brand for running a GNU/Linux user-level environment
-.Sh DESCRIPTION
-The
-.Em lx
-brand
-uses the
-.Xr brands 5
-framework to provide an environment for running binary applications built
-for GNU/Linux.
-User-level code, including an entire Linux distribution, can run inside the
-zone.
-Both 32-bit and 64-bit applications are supported.
-The majority of Linux system calls are provided, along with emulation for a
-variety of Linux file systems, such as
-.Em proc ,
-.Em cgroup
-and
-.Em sysfs .
-.Pp
-The
-.Em /proc
-file system within the zone is a subset of a full Linux
-.Em /proc .
-Most kernel-level tuning applied to
-.Em /proc
-is unavailable or ignored.
-Some tuning can be performed, but only to reduce the overall limits that have
-been specified on the zone's configuration.
-That is, within the zone there is no way to increase the resource limits set on
-the zone itself.
-.Pp
-The zone must be installed using a clone of a
-.Xr zfs 1m
-dataset which contains an image of the software to be run in the zone.
-.Pp
-Example:
-.Dl zoneadm -z myzone install -x nodataset -t debian7
-.Pp
-Applications provided by the base SunOS operating system are also available
-within the zone under the
-.Em /native
-mount point.
-This allows the use of various native tools such as
-.Xr dtrace 1m ,
-.Xr mdb 1 ,
-or the
-.Xr proc 1
-tools on GNU/Linux applications.
-However, not every native tool will work properly within an
-.Em lx
-zone.
-.Sh CONFIGURATION
-The
-.Em kernel-version
-attribute can be included in the zone's
-.Xr zonecfg 1m
-settings as a way to specify the Linux version that the zone is emulating.
-For example, the value could be
-.Em 3.13.0 .
-.Sh LIMITATIONS
-The brand only supports the exclusive IP stack zone configuration.
-.Pp
-Most modern GNU/Linux application software runs on
-.Em lx ,
-but because there are some system calls or file systems which are not currently
-implemented, it's possible that an application won't run.
-This does not preclude the application running in the future as the
-.Em lx
-brand adds new capabilities.
-.Pp
-Because there is only the single SunOS kernel running on the system, there
-is no support for any Linux kernel-level modules.
-That is, there is no support for add-on drivers or any other modules that are
-part of the Linux kernel itself.
-If that is required, a full virtual machine should be used instead of an
-.Em lx
-branded zone.
-.Pp
-Any core files produced within the zone are in the native SunOS format.
-.Pp
-As with any zone, the normal security mechanisms and privileges apply.
-Thus, certain operations (for example, changing the system time), will not be
-allowed unless the zone has been configured with the appropriate additional
-privileges.
-.Sh SEE ALSO
-.Xr mdb 1 ,
-.Xr proc 1 ,
-.Xr dtrace 1m ,
-.Xr zfs 1m ,
-.Xr zoneadm 1m ,
-.Xr zonecfg 1m ,
-.Xr brands 5 ,
-.Xr privileges 5 ,
-.Xr resource_controls 5 ,
-.Xr zones 5