admin(4) admin(4)
NAME
admin - installation defaults file
DESCRIPTION
admin is a generic name for an ASCII file that defines default instal-
lation actions by assigning values to installation parameters. For
example, it allows administrators to define how to proceed when the
package being installed already exits on the system.
/var/sadm/install/admin/default is the default admin file delivered
with Reliant UNIX. The default file is not writable, so to assign
values different from this file, create a new admin file. There are no
naming restrictions for admin files. Name the file when installing a
package with the -a option of pkgadd. If the -a option is not used,
the default admin file is used.
Each entry in the admin file is a line that establishes the value of a
parameter in the following form:
param=value
12 parameters can be defined in an admin file. A file is not required
to assign values to all 12 parameters. If a value is not assigned,
pkgadd asks the installer how to proceed.
The 12 parameters and their possible values are shown below except as
noted. They may be specified in any order. Any of these parameters can
be assigned the value ask, which means that if the situation occurs
the installer is notified and asked to supply instructions at that
time.
basedir Defines the base directory in which collectively relo-
catable objects should be installed. The following
specifications for value are supported:
dir The base directory is specified
directly. The value can contain the
parameter $PKGINST to specify a base
directory which is independent of the
program package concerned. dir must be
an absolute pathname, i.e. it must begin
with "/".
default The base directory for collectively
relocatable objects is retrieved (if
present) from the pkginfo(4) file of
the package to be installed.
ask (or empty) The base directory for collectively
relocatable objects is requested
interactively (if interaction is permit-
ted).
Page 1 Reliant UNIX 5.44 Printed 11/98
admin(4) admin(4)
Prerequisites for basedir becoming effective are gen-
erally
- the existence of freely relocatable objects
- the presetting of $BASEDIR variables in the
pkginfo(4) file with a non-zero standard value
mail Defines a list of users to whom mail should be sent
following installation of a package. If the list is
empty, no mail is sent. If the parameter is not present
in the admin file, the default value of root is used.
The ask value cannot be used with this parameter.
runlevel Indicates resolution if the run level is not correct
for the installation or removal of a package. The fol-
lowing specifications for value are supported:
nocheck Does not check for run level.
quit Aborts installation if run level is not
reached.
conflict Specifies what to do if an installation expects to
overwrite a previously installed file, thus creating a
conflict between packages. The following specifications
for value are supported:
nocheck Does not check for conflict; files in
conflict will be overwritten.
quit Aborts installation if conflict is
detected.
nochange Overrides installation of conflicting
files; they will not be installed.
setuid Checks for executables which will have setuid or setgid
bits enabled after installation. The following specifi-
cations for value are supported:
nocheck Does not check for setuid executables.
quit Aborts installation if setuid processes
are detected.
nochange Overrides installation of setuid
processes; processes will be installed
without setuid bits enabled.
Page 2 Reliant UNIX 5.44 Printed 11/98
admin(4) admin(4)
action Determines if action scripts provided by package
developers contain possible security impact. The fol-
lowing specifications for value are supported:
nocheck Ignores security impact of action
scripts.
quit Aborts installation if action scripts
may have a negative security impact.
partial Checks to see if a version of the package is already
partially installed on the system. The following
specifications for value are supported:
nocheck Does not check for a partially installed
package.
quit Aborts installation if a partially
installed package exists.
instance Determines how to handle installation if a previous
version of the package (including a partially installed
instance) already exists. The following specifications
for value are supported:
quit Exits without installing if an instance
of the package already exists (does not
overwrite existing packages).
overwrite Overwrites an existing package if only
one instance exists. If there is more
than one instance, but only one has the
same architecture, it overwrites that
instance. Otherwise, the installer is
prompted with existing instances and
asked which to overwrite.
unique Does not overwrite an existing instance
of a package. Instead, a new instance of
the package is created. The new instance
will be assigned the next available
instance identifier.
idepend Controls resolution if other packages depend on the one
to be installed. The following specifications for value
are supported:
nocheck Does not check package dependencies.
quit Aborts installation if package dependen-
cies are not met.
Page 3 Reliant UNIX 5.44 Printed 11/98
admin(4) admin(4)
rdepend Controls resolution if other packages depend on the one
to be removed. The following specifications for value
are supported:
nocheck Does not check package dependencies.
quit Aborts removal if package dependencies
are not met.
space Controls resolution if disk space requirements for
package are not met. The following specifications for
value are supported:
nocheck Does not check space requirements (ins-
tallation fails if it runs out of
space).
quit Aborts installation if space require-
ments are not met.
listfiles nocheck Processed files are not listed.
Otherwise yes.
NOTES
The value ask should not be defined in an admin file that will be used
for non-interactive installation (since by definition, there is no
installer interaction). Doing so causes installation to fail when
input is needed.
EXAMPLE
basedir=default
runlevel=quit
conflict=quit
setuid=quit
action=quit
partial=quit
instance=unique
idepend=quit
rdepend=quit
space=quit
listfiles=nocheck
SEE ALSO
pkginfo(4).
Page 4 Reliant UNIX 5.44 Printed 11/98