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 PKG2DU 1M "Sep 23, 2009"
   7 .SH NAME
   8 pkg2du \- convert driver packages to Driver Update format
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/bin/pkg2du\fR [\fB-f\fR] [\fB-v\fR] [\fB-d\fR \fIdir\fR] [\fB-o\fR \fIiso\fR] [\fB-l\fR \fIlabel\fR]
  13      [\fB-r\fR \fIrelease\fR] \fIpkg\fR [\fIpkg\fR ...]
  14 .fi
  15 
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fB/usr/bin/pkg2du\fR utility takes one or more packages as input and
  20 converts them to Driver Update (DU) format. If the \fB-d\fR option is
  21 specified, the resulting DU directory tree is placed in the directory
  22 \fIdir\fR. If the \fB-o\fR option is specified, a Solaris ISO image of the DU
  23 directory tree is written in the file \fIiso\fR. The ISO image can be burned
  24 onto CD/DVD using \fBcdrw\fR(1) or \fBcdrecord(1)\fR (not a SunOS man page) and
  25 used during Solaris installation.
  26 .sp
  27 .LP
  28 At least one of the \fB-d\fR and \fB-o\fR options must be specified. If both
  29 are specified, then both an ISO image and a directory tree are generated.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The following options are supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-d\fR \fIdir\fR\fR
  38 .ad
  39 .sp .6
  40 .RS 4n
  41 Directory where the DU directory should be created.
  42 .RE
  43 
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-o\fR \fIiso\fR\fR
  48 .ad
  49 .sp .6
  50 .RS 4n
  51 Create a Solaris ISO image of the DU directory.
  52 .RE
  53 
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-f\fR\fR
  58 .ad
  59 .sp .6
  60 .RS 4n
  61 If \fB\fIdir\fR/DU\fR or \fIiso\fR exists, remove it without asking first.
  62 .RE
  63 
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB-l\fR \fIlabel\fR\fR
  68 .ad
  69 .sp .6
  70 .RS 4n
  71 Label/volume name of the ISO image (if \fB-o\fR option is specified).
  72 .RE
  73 
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-r\fR \fIrelease\fR\fR
  78 .ad
  79 .sp .6
  80 .RS 4n
  81 Solaris release number to use. It takes the form of the return from \fBuname\fR
  82 \fB-r\fR command, for example, \fB5.10\fR. If unspecified, the release number
  83 of the currently running Solaris is used.
  84 .RE
  85 
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB-v\fR\fR
  90 .ad
  91 .sp .6
  92 .RS 4n
  93 Verbose. Multiple \fB-v\fR options increase verbosity.
  94 .RE
  95 
  96 .SH OPERANDS
  97 .sp
  98 .LP
  99 The following operands are supported:
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fIpkg\fR [\fIpkg\fR...]\fR
 104 .ad
 105 .sp .6
 106 .RS 4n
 107 One or more packages to be converted to DU format.
 108 .RE
 109 
 110 .SH EXAMPLES
 111 .LP
 112 \fBExample 1 \fRCreating a DU CD/DVD
 113 .sp
 114 .LP
 115 The following commands create a DU CD or DVD containing packages \fBSUNWfoo\fR
 116 and \fBSUNWbar\fR.
 117 
 118 .sp
 119 .in +2
 120 .nf
 121 # \fB/usr/bin/pkg2du -r 5.10 -o my.iso SUNWfoo SUNWbar\fR
 122 # \fB/usr/bin/cdrw -i my.iso\fR
 123 .fi
 124 .in -2
 125 .sp
 126 
 127 .SH ATTRIBUTES
 128 .sp
 129 .LP
 130 See \fBattributes\fR(5) for descriptions of the following attributes:
 131 .sp
 132 
 133 .sp
 134 .TS
 135 box;
 136 c | c
 137 l | l .
 138 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 139 _
 140 Interface Stability     Committed
 141 .TE
 142 
 143 .SH SEE ALSO
 144 .sp
 145 .LP
 146 \fBcdrw\fR(1), \fBmkbootmedia\fR(1M), \fBattributes\fR(5)
 147 .sp
 148 .LP
 149 \fBmkisofs(8)\fR, (\fB/usr/share/man/man8/mkisofs.8\fR), in the
 150 \fBSUNWfsman\fR package (not a SunOS man page)