usr/src/man/man1m/pkgask.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 1998, 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 PKGASK 1M "Apr 6, 2005"
   7 .SH NAME
   8 pkgask \- stores answers to a request script
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBpkgask\fR [\fB-d\fR \fIdevice\fR] [\fB-R\fR \fIroot_path\fR] \fB-r\fR \fIresponse\fR \fIpkginst\fR...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBpkgask\fR allows the administrator to store answers to an interactive
  19 package (one with a \fBrequest\fR script, that is, a user-created file that
  20 must be named \fBrequest\fR). Invoking this command generates a response file
  21 that is then used as input at installation time. The use of this response file
  22 prevents any interaction from occurring during installation since the file
  23 already contains all of the information the package needs.
  24 .SH OPTIONS
  25 .sp
  26 .LP
  27 The following options are supported
  28 .sp
  29 .ne 2
  30 .na
  31 \fB\fB-d\fR\fI device\fR\fR
  32 .ad
  33 .RS 16n
  34 Run the request script for a package on \fIdevice\fR. \fIdevice\fR can be a
  35 directory pathname or the identifiers for tape, floppy disk or removable disk
  36 (for example, \fB/var/tmp\fR, \fB/dev/diskette\fR, and \fB/dev/dsk/c1d0s0\fR).
  37 The default device is the installation spool directory.
  38 .RE
  39
  40 .sp
  41 .ne 2
  42 .na
  43 \fB\fB-R\fR\fI root_path\fR\fR
  44 .ad
  45 .RS 16n
  46 Define the full path name of a directory to use as the \fIroot_path\fR. All
  47 files, including package system information files, are relocated to a directory
  48 tree starting in the specified \fIroot_path\fR.
  49 .LP
  50 Note -
  51 .sp
  52 .RS 2
  53 The root file system of any non-global zones must not be referenced with the
  54 \fB-R\fR option. Doing so might damage the global zone's file system, might
  55 compromise the security of the global zone, and might damage the non-global
  56 zone's file system. See \fBzones\fR(5).
  57 .RE
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-r\fR\fI response\fR\fR
  64 .ad
  65 .RS 16n
  66 Identify a file or directory which should be created to contain the responses
  67 to interaction with the package. The name must be a full pathname. The file, or
  68 directory of files, can later be used as input to the \fBpkgadd\fR(1M) command.
  69 .RE
  70
  71 .SH OPERANDS
  72 .sp
  73 .LP
  74 The following operands are supported:
  75 .sp
  76 .ne 2
  77 .na
  78 \fB\fIpkginst\fR\fR
  79 .ad
  80 .RS 11n
  81 Specify the package instance, or list of instances for which \fBrequest\fR
  82 scripts will be created. The token \fBall\fR may be used to refer to all
  83 packages available on the source medium.
  84 .RE
  85
  86 .SH EXIT STATUS
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB0\fR\fR
  91 .ad
  92 .RS 6n
  93 Successful completion.
  94 .RE
  95
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fB>0\fR\fR
 100 .ad
 101 .RS 6n
 102 An error occurred.
 103 .RE
 104
 105 .SH SEE ALSO
 106 .sp
 107 .LP
 108 \fBpkginfo\fR(1), \fBpkgmk\fR(1), \fBpkgparam\fR(1), \fBpkgproto\fR(1),
 109 \fBpkgtrans\fR(1), \fBinstallf\fR(1M), \fBpkgadd\fR(1M), \fBpkgchk\fR(1M),
 110 \fBpkgrm\fR(1M), \fBremovef\fR(1M), \fBadmin\fR(4),\fBattributes\fR(5)
 111 .sp
 112 .LP
 113 \fI\fR
 114 .SH NOTES
 115 .sp
 116 .LP
 117 The \fB-r\fR option can be used to indicate a directory name as well as a
 118 filename. The directory name is used to create numerous response files, each
 119 sharing the name of the package with which it should be associated. This would
 120 be used, for example, when you will be adding multiple interactive packages
 121 with one invocation of \fBpkgadd\fR(1M). Each package would need a response
 122 file. To create multiple response files with the same name as the package
 123 instance, name the directory in which the files should be created and supply
 124 multiple instance names with the \fBpkgask\fR command. When installing the
 125 packages, you will be able to identify this directory to the \fBpkgadd\fR(1M)
 126 command.
 127 .sp
 128 .LP
 129 If the default \fBadmin\fR file is too restrictive, the administration file may
 130 need to be modified to allow for total non-interaction during a package
 131 installation. See\fBadmin\fR(4) for details.