ksrcconf(1)

PROGRAM
ksrcconf - A utility for configuring source in the khoros environment.

SYNTAX

ksrcconf

[-source]
    input source directory [.]

[-toolbox]
    Toolbox name

[-V]
    Gives the version for ksrcconf

[-U]
    Gives the usage for ksrcconf

[-P]
    Prompts for command line options

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

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

DESCRIPTION
ksrcconf is a program for creating the symbolic linked source trees for $KHOROS_HOME/src or for any other source tree that has been set up (ie. a toolbox). Ksrcconf will create symbolic links relative to the specified directory for the source argument. The user can specify "." for the current directory, a relative path, or full path to a directory. The C driver will expand the path and pass a full path on to the ksrcconf_csh script file.

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.

REQUIRED ARGUMENTS
none

OPTIONAL ARGUMENTS

-source
    type: string
    desc: input source directory [.]
    default: null

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

EXAMPLES
ksrcconf

this will use the current directory [.] and the default_mach file corresponding to the host machine name to perform the source configuration. Since the -toolbox argument is not specified it is assumed ksrcconf is being executed in KHOROS_HOME

ksrcconf -source /research/work/mydir -toolbox medic_toolbox

this will use the directory specified and the medic_toolbox's mach file to perform the source configuration. NOTE: the programmer is responsible for correctly setting up the mach file with the correct paths for the machine that the programmer will be developing on.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3) klndir(1), kmakeall(1), kinstall(1), ghostwriter(1), intro(1), ghostreader(1), ghostcheck(1)

RESTRICTIONS

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