# man -s 5 solaris8
Reformatting page.  Please Wait... done

Standards, Environments, and Macros                   solaris8(5)

NAME
     solaris8 - Solaris 8 branded zone

DESCRIPTION
     The  solaris8  brand  uses  the  branded   zones   framework
     described  in  brands(5) to enable Solaris 8 binary applica-
     tions to run unmodified on a machine with the latest Solaris
     Operating System kernel.

     The solaris8 brand includes the tools necessary to install a
     Solaris  8  system  image  into a non-global zone. The brand
     supports the execution of 32-bit and 64-bit Solaris 8 appli-
     cations on SPARC machines running the latest Solaris operat-
     ing system.

  Configuration and Administration
     The solaris8 brand supports the whole root  non-global  zone
     model.  All of the required Solaris 8 software and any addi-
     tional packages are installed into the private file  systems
     of the zone.

     The zonecfg(1M) utility is  used  to  configure  a  solaris8
     branded  zone.  Once a branded zone has been installed, that
     zone's brand cannot be changed or removed.  The  zoneadm(1M)
     utility is used to report the zone's brand type and adminis-
     ter the zone. The zlogin(1) utility is used to log in to the
     zone.

     The solaris8 brand installer supports  installing  the  zone
     from an image of an installed Solaris 8 system.  This can be
     a full flash_archive(4), cpio(1) or pax(1) "xustar" archive.
     The cpio archive can be compressed with gzip(1) or bzip2(1).
     The image can also be a level 0 ufsdump(1M), or  a  path  to
     the  top-level  of a Solaris 8 system's root directory tree.
     The zone cannot be installed from standard Solaris 8 distri-
     bution media.  The zoneadm brand-specific subcommands accept
     the following arguments:

     install [-a archive] [-d path] [-p] [-s] [-u] [-v]
         Install the specified Solaris 8 system  image  into  the
         zone.  Either the -u or -p option is required and either
         the -a or -d option is required.

         -a archive
             The path to a flash_archive(4), cpio(1),  or  pax(1)
             "xustar"  archive,  or  a level 0 ufsdump(1M), of an
             installed Solaris 8 system.  Cpio  archives  may  be
             compressed using gzip(1) or bzip2(1).

         -d path
             The path to  the  root  directory  of  an  installed

SunOS 5.11            Last change: 07/09/28                     1

Standards, Environments, and Macros                   solaris8(5)

             Solaris 8 system.

         -p
             Preserve the system configuration  after  installing
             the zone.

         -s
             Install silently.

         -u
             Run sys-unconfig(1M) on the  zone  after  installing
             it.

         -v
             Verbose output from the install process.

  Application Support
     The solaris8 zone only supports user-level Solaris 8  appli-
     cations.  You cannot use Solaris 8 device drivers, Solaris 8
     kernel modules, or Solaris 10-only  file  systems,  such  as
     zfs(1M)  delegated  datasets,  from  inside a solaris8 zone.
     However, you can add fs resources in zonecfg with type=zfs.

     Native  Solaris  debugging  tools  such   as   DTrace   (see
     dtrace(1M))  can be applied to Solaris 8 processes executing
     inside the zone, but the tools themselves must be running in
     the global zone.

  Zone Migration
     During the process of installing the  zone  a  "physical  to
     virtual"  conversion  is  automatically  performed.  After a
     solaris8 branded zone is migrated to a new host,  this  pro-
     cess should be repeated to ensure that the zone is optimized
     to run on the new  host.   The  first  time  that  the  zone
     attempts  to boot on the new host it will detect this situa-
     tion and the zone will not boot until the following  command
     is run:

     /usr/lib/brand/solaris8/s8_p2v zonename

ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:

SunOS 5.11            Last change: 07/09/28                     2

Standards, Environments, and Macros                   solaris8(5)

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWs8brandr, SUNWs8brandu  |
    |_____________________________|_____________________________|
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|

SEE ALSO
     brands(5), zones(5),  zoneadm(1M),  zonecfg(1M),  zlogin(1),
     cpio(1),     flarcreate(1M),    flash_archive(4),    pax(1),
     ufsdump(1M), gzip(1), bzip2(1), dtrace(1M), zfs(1M),

SunOS 5.11            Last change: 07/09/28                     3