krmprog(1)

PROGRAM
krmprog - A utility for removing routines from the khoros environment.

SYNTAX

krmprog

-name
    program name

-conf
    input config file

[-toolbox]
    Toolbox name

[-V]
    Gives the version for krmprog

[-U]
    Gives the usage for krmprog

[-P]
    Prompts for command line options

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

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

DESCRIPTION
krmprog is a routine for removing routines from the khoros environment. The driver program "krmprog" calls a shell script to do the work. This command can be executed in the users work directory or in the directory above where the routine is located in src. The routine to be removed can consist of a pane file (*.pane), a prog file (*.prog), a main.c file, a l*.c file, and a *.h file. Provision is made for an optional library include file. The routine will prompt for a path for the destination of this file. These files will be removed from the khoros source area as specified by the paths in the config file (*.conf).

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

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

The -conf argument specifies where to access the files associated with a specific routine. To correctly remove a routine, the *.conf file must be filled out with the correct path information. This file should exist in the program source 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 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.

Krmprog will prompt the user to edit the subform file and delete the reference to the pane file in the subform. Krmprog will automatically put the user in the editor specified in their environment variable, or will default to use vi to edit the subform file.

Krmprog will prompt for the inclusion of a library include file, which will be installed in the path specified by the programmer.

REQUIRED ARGUMENTS

-name
    type: string
    desc: program name

-conf
    type: infile
    desc: input config file

OPTIONAL ARGUMENTS

-toolbox
    type: string
    desc: Toolbox name
    default: null

EXAMPLES
krmprog -name vadd -conf vadd.conf

Remove the program "vadd" from the locations specified in the config file (*.conf). The default mach file in $KHOROS_HOME/repos/config/src_conf will be used to identify the locations of the src tree(s). Since no -toolbox argument is specified, vadd must exist in KHOROS_HOME

krmprog -name vnew -conf vnew.conf -toolbox medic_toolbox

Remove the program "vnew" from the locations specified in the config file (*.conf). krmprog 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.