
kdinstall(1)                 Khoros                  kdinstall(1)

PROGRAM
     kdinstall - A utility for de-installing existing routines
     from khoros.

SYNTAX
     kdinstall

     -name          program name

     -dest          Destination path

     [-toolbox]     input toolbox name

     [-force]       Force option

     [-V]           Gives the version for kdinstall

     [-U]           Gives the usage for kdinstall

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called kdinstall.ans
                    or file1

     [-a [file1]]   Uses kdinstall.ans or file1 as the answer
                    file

DESCRIPTION
     kdinstall is a routine for de-installing existing routines
     from the khoros environment.  Note that this routine does
     not remove files from the src tree directories.  The driver
     program "kdinstall" calls a shell script to do the work.
     This command can be executed from anywhere, PROVIDED a valid
     config file exists int the current directory.  The routine
     should be run from the khoros source directory where the
     current config file resides.  The routine to de-install can
     consist of a pane file (*.pane), a prog file (*.prog), a
     main.c file, an l*.c file, and a main.h file. Provision is
     made for an optional library include file.  The routine will
     prompt for a path to this file.  These files will be copied
     from the khoros source area to the current directory.  The
     paths to each source file must be provided to the kdinstall
     routine.  This is accomplished by using the config file
     (*.conf) for the routine to de-install.  Therefore, the rou-
     tine MUST be able to access a config file (*.conf).  The
     config file must contain valid paths to all the files asso-
     ciated with the program to de-install.

     The routine requires that a destination path (normally a
     directory established by the user in their work area) be
     supplied where the files can be copied to.

     There are four arguments to kdinstall.  Two of the arguments
     are required; -name and -dest, while the other two arguments
     are optional.

     The -name argument specifies the name of the program to de-
     install.  This should simply be the name of the program
     without any file type extensions.  For example, a valid name
     would be 'vadd'.

     The -dest argument specifies a path to a destination loca-
     tion.  If the destiation directory does not exist, the pro-
     gram will prompt the user to create the directory.

     The -toolbox argument specifies which toolbox this routine
     will be installed in. Note, if the -toolbox argument is not
     used, then kinstall assumes that the routine is to be
     installed in KHOROS_HOME. Kinstall uses a mach file to
     determine where the top of the source is. This mach file is
     located in $TOOLBOX_NAME/repos/config/src_conf and is called
     ToolboxName_mf.

     The mach file specifies the information required by all of
     the khoros tools concerning the particular toolbox environ-
     ment, specific machine names, srcmach directories,
     TOOLBOX_NAME src location for each machine, and the top of
     the src directory for the local machine.  Note that if mul-
     tiple machines are used, then there should exist a mach file
     for each machine( i.e. ToolboxName_mf.joe.edu).  This is
     necessary since each machine may have a different path for
     the top of src, and the khoros tools require specific paths
     when linking files from one directory to another across dif-
     ferent machines with disk partitions mounted at different
     points.

     For information on on toolboxes and mach files, see the
     Khoros Manual Vol. 2, Chapters 1 and 9.  Additionally, the
     programmer may also wish to use the existing default mach
     file as an example located in
     $KHOROS_HOME/repos/config/src_conf called default_mach.

     The -force argument will allow the user to bypass the file
     overwrite prompts if the files already exist in the destina-
     tion directory.

     Kdinstall will prompt for the inclusion of a path to a
     library include file, which will be de-installed if a path
     is provided.

REQUIRED ARGUMENTS
     -name  type: string
            desc: program name

     -dest  type: string
            desc: Destination path

OPTIONAL ARGUMENTS
     -toolbox
            type: string
            desc: input toolbox name
            default:

     -force type: boolean
            desc: Force option
            default: false

EXAMPLES
     kdinstall -name vadd -dest /research/work -force 1

     De-install the program "vadd" from the locations specified
     in the config file (*.conf) to the destination directory
     specified.  The config file is assumed to exist in the
     current directory.  Since no -toolbox argument was speci-
     fied, the default mach file will be used to identify the
     location of the src tree. That is the routine must exist in
     KHOROS_HOME/src.  The force option is set to true, which
     bypasses the overwrite confirmation.

     kdinstall -name vnew -dest /research/work -toolbox
     medic_toolbox

     De-install the program "vnew" from the locations specified
     in the config file (*.conf) to the destination directory
     specified.  The config file is assumed to exist in the
     current directory.  Kdinstall will use the mach file
     $MEDIC_TOOLBOX/repos/config/src_conf/medic_toolbox_mf.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3) ghostwriter(1),
     intro(1), ghostreader(1), ghostcheck(1) ksrcconf(1), kmak-
     eall(1)

RESTRICTIONS
COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

