INSTALL(8)              COMMAND REFERENCE              INSTALL(8)



NAME
     install - install files from distribution media

SYNOPSIS
     /usr/lib/install [ -tar ] [  source [  text ] ]

DESCRIPTION
     Install reads files from source and copies them to their
     named destination files.  The destination for each file is
     determined from the name as it is on the source relative to
     the current working directory.

     Source defaults to /dev/rdf but may be any file.  If source
     is flexible disk, diskette or /dev/rdf, install(8) will load
     the files from the diskette drive.  If it is cart,
     cartridge, /dev/tc or /dev/ntc the files will be read from
     the cartridge tape unit.  Any other source is assumed to be
     a file on the system.

     Text defaults to diskette and is used in the cpio(1) prompt
     if source is distributed on more than one diskette, tape or
     cartridge.

     Files on source. are assumed to be in cpio(1) format.  If
     the -tar option is given, then the files are assumed to be
     in tar(1) format and tar(1) will be used in lieu of cpio(1).

     Install is usually called by a shell script called INSTALL
     found on source by running the software installation option
     of /etc/sysadmin(8). Sysadmin(8) will extract the file
     INSTALL from source and execute it.

     After the files are read from source, if a file called
     INSTALL.READ is found in the current directory, it will be
     copied to the screen via more(1).  INSTALL.READ is typically
     used to describe what has been installed and/or to give
     further instructions about finishing the installation of a
     particular package.

     If a file called INSTALL.EXEC is found in the source , then
     it will be executed after the files are read from the
     source. INSTALL.EXEC is typically used to create file links,
     to move the files found on source to a different directory
     and/or to verify that required files are present, to cause
     makedev(8) to create special entries in /dev or any other
     tasks required by the software being installed.

OPTIONS
     -tar Use tar(1) instead of cpio(1) to extract files from
          source.





Printed 4/6/89                                                  1

INSTALL(8)              COMMAND REFERENCE              INSTALL(8)



EXAMPLES
     A typical INSTALL script on source could be

          #!/bin/sh
          cd /
          /usr/lib/install cartridge "tape cartridge"

FILES
     INSTALL.READ   Information to be read before installing
                    files.

     INSTALL.EXEC   Optional program on source to be executed
                    after files have been extracted from source.

SEE ALSO
     cpio(1), more(1), and tar(1).







































Printed 4/6/89                                                  2

%%index%%
na:312,99;
sy:411,363;
de:774,3436;
op:4210,230;
ex:4824,255;
fi:5079,341;
se:5420,178;
%%index%%000000000121