
kmakeall(1)                  Khoros                   kmakeall(1)

PROGRAM
     kmakeall - Used to make source on a distributed computer
     system

SYNTAX
     kmakeall

     [-toolbox]     the toolbox name

     [-f]           full_path

     [-r]           relative_path

     [make options] options to be passed on to make

     [-U]           Gives the usage for kmakeall

     [-V]           Gives the version for kmakeall

DESCRIPTION
     kmakeall is a front end script tool to assist in the use of
     make on a distributed computer system.  Note, if you are not
     supporting multiple source trees, you will never use kmak-
     eall. By default, kmakeall will attempt to make source rela-
     tive to the present working directory.  The user can specify
     the FULL directory path name (-f) to the source, or the
     relative path name (-r) to $KHOROS_HOME/src or
     $TOOLBOX_NAME/src if the -toolbox option is specified.

     This program requires the use of a mach file to determine
     the paths to the srcmach trees.  A mach file should exist
     for each machine that is being used to develop code on.
     Mach files may also be created for different srcmach trees
     that the programmer may want to develop in.  The default
     mach file and templates are located in
     $KHOROS_HOME/repos/config/src_mach. If the -toolbox option
     is specifed, then kmakeall will look in
     $TOOLBOX_NAME/repos/config/src_mach for a "ToolboxName_mf"
     file.

     For information on how to set up a mach file, see the Khoros
     Manual Vol. 2, Ch. 9.  Additionally, the programmer may also
     wish to use the existing default mach file as an example.

     Kmakeall, after getting the defined make objects and
     options, attempts to call rsh to each machine and call make
     in the appropriate srcmach directory.

     Since kmakeall uses rsh and .rhosts files are not allowed to
     be left on machines overnight, kmakeall copies
     $KHOROS_USER/.rhosts.bk to $KHOROS_USER/.rhosts before cal-
     ling rsh and then removes the .rhosts file before exiting.
     Since the rshs' are put in the background, kmakeall needs to
     sleep for about a minute to allow rshs' to be connected
     before removing the .rhosts file.

OPTIONAL ARGUMENTS
     -toolbox
            type: string
            desc: name of the Toolbox

     -r     type: string
            desc: relative_path from $KHOROS_HOME/src to the
            directory to make

     -f     type: string
            desc: full_path to the directory to make

EXAMPLES
     Here is an example of making and installing vadd on all
     machines:

               cd $KHOROS_HOME/src/vipl/arith_binary/vadd
               kmakeall install

               OR

               kmakeall -f $KHOROS_HOME/src/vipl/arith_binary/vadd install

     Here is an example of making and installing all of source
     for the toolbox medic_toolbox

               cd $TOOLBOX_NAME/src
               kmakeall -toolbox medic_toolbox install

               OR

               kmakeall -f $TOOLBOX_NAME/src -toolbox medic_toolbox install

     If kmakeall is to be used just after a call to ksrcconf,
     make sure that depend is added before install:

               kmakeall -f $KHOROS_HOME/src depend install

SEE ALSO
     klndir(1), intro(1), make(1) vipl(3)

RESTRICTIONS
     Complex make defines cannot be used on the command line.
     For example, adding "CFLAGS=-g -DDEBUG" will not catch it as
     being one string, as it is needed to be.

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

Khoros                    Release: 1.0                          1

