
ksrcconf(1)                  Khoros                   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 direc-
     tory.  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 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 toolboxes and mach files, see the Khoros
     Manual Vol. 2, Chapters 1 and 9.  Additionally, the program-
     mer 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 configura-
     tion.  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), kmak-
     eall(1), kinstall(1), ghostwriter(1), intro(1), ghos-
     treader(1), ghostcheck(1)

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

Khoros                    Release: 1.0                          1

