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 routine MUST be able to access a config file (*.conf). The config file must contain valid paths to all the files associated 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 location. If the destiation directory does not exist, the program 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 environment, 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 multiple 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 different 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 destination 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 specified, 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), kmakeall(1)

RESTRICTIONS

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