1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH MKBOOTMEDIA 1M "Sep 23, 2009"
   7 .SH NAME
   8 mkbootmedia \- create bootable Solaris ISO image
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/bin/mkbootmedia\fR \fB-v\fR [\fB-l\fR \fIlabel\fR] \fImedia-root\fR \fIiso\fR
  13 .fi
  14 
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBmkbootmedia\fR utility takes \fImedia-root\fR (the root of an on-disk
  19 Solaris install media) as input and creates a bootable Solaris ISO image in the
  20 file \fIiso\fR, using \fBmkisofs(8)\fR. The file can then be burned onto a
  21 CD/DVD with utilities such as \fBcdrw\fR(1) or \fBcdrecord(1)\fR. (Neither
  22 \fBmkisofs(8)\fR nor \fBcdrecord(1)\fR are SunOS man pages.)
  23 .LP
  24 Caution -
  25 .sp
  26 .RS 2
  27 The directory tree \fImedia-root\fR must contain the file
  28 \fBboot/grub/stage2_eltorito\fR, which will be written to the media boot
  29 sectors. This file will be modified with some boot information, thus it must be
  30 writable. If necessary, first save a copy prior to running this utility.
  31 .RE
  32 .SH OPTIONS
  33 .sp
  34 .LP
  35 The following options are supported:
  36 .sp
  37 .ne 2
  38 .na
  39 \fB\fB-l\fR \fIlabel\fR\fR
  40 .ad
  41 .sp .6
  42 .RS 4n
  43 Sets \fIlabel\fR as the label/volume name of the ISO image.
  44 .RE
  45 
  46 .sp
  47 .ne 2
  48 .na
  49 \fB\fB-v\fR\fR
  50 .ad
  51 .sp .6
  52 .RS 4n
  53 Verbose. Multiple \fB-v\fR options increase verbosity.
  54 .RE
  55 
  56 .SH OPERANDS
  57 .sp
  58 .LP
  59 The following operands are supported:
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fImedia-root\fR\fR
  64 .ad
  65 .sp .6
  66 .RS 4n
  67 Top-level directory of an on-disk Solaris install media.
  68 .RE
  69 
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fIiso\fR\fR
  74 .ad
  75 .sp .6
  76 .RS 4n
  77 Name of the output file which will contain the resulting ISO image.
  78 .RE
  79 
  80 .SH EXAMPLES
  81 .LP
  82 \fBExample 1 \fRCreating an ISO Image and Burning a CD/DVD
  83 .sp
  84 .LP
  85 The following commands create an ISO image from the content of \fBs10u1\fR and
  86 burn the image to a CD/DVD.
  87 
  88 .sp
  89 .in +2
  90 .nf
  91 # \fB/usr/bin/mkbootmedia s10u1 s10u1.iso\fR
  92 # \fB/usr/bin/cdrw -i s10u1.iso\fR
  93 .fi
  94 .in -2
  95 .sp
  96 
  97 .SH ATTRIBUTES
  98 .sp
  99 .LP
 100 See \fBattributes\fR(5) for descriptions of the following attributes:
 101 .sp
 102 
 103 .sp
 104 .TS
 105 box;
 106 c | c
 107 l | l .
 108 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 109 _
 110 Interface Stability     Committed
 111 .TE
 112 
 113 .SH SEE ALSO
 114 .sp
 115 .LP
 116 \fBcdrw\fR(1), \fBattributes\fR(5)
 117 .sp
 118 .LP
 119 \fBmkisofs(8)\fR, (\fB/usr/share/man/man8/mkisofs.8\fR), in the
 120 \fBSUNWfsman\fR package (not a SunOS man page)