
klnfile(1)                   Khoros                    klnfile(1)

PROGRAM
     klnfile - A utility for making/removing links in the khoros
     environment.

SYNTAX
     klnfile

     -source        input source file

     [-toolbox]     Toolbox name

     [-remove]      Make/Remove link

     [-V]           Gives the version for klnfile

     [-U]           Gives the usage for klnfile

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     klnfile is a program for creating and removing symbolic
     links in the khoros distributed source environment.  This
     program calls a csh shell script "klnfile_csh" that performs
     the making and removing of links in the srcmach directories.
     The C driver accepts a source file, which may be a filename
     or a relative or fullpath to a filename.  If only a filename
     or a relative path to a file is provided, the C driver
     expands the filename or relative path to a full path, and
     passes the full path to the csh script.

     The program can be used to create or remove links by speci-
     fying a logical "0" or "FALSE" (default) to make the link or
     a "1" or "TRUE" to remove the link.  This argument is
     optional and has a default of "FALSE".

     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.

     Note that if only one machine is specified in the
     default_mach file, and it is the current machine, then no
     symbolic links are required.

REQUIRED ARGUMENTS
     -source
            type: string
            desc: input source file

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

     -remove
            type: boolean
            desc: Make/Remove link
            default: false

EXAMPLES
     klnfile -source myfile.c -toolbox medic_toolbox

     This will link the file "myfile.c" to the other srcmach
     directories specified in the mach file for the
     medic_toolbox.

     klnfile -source myfile.c -remove 1

     This will remove the link for the file "myfile.c" to the
     other srcmach directories specified in the default mach
     file. Since no toolbox is specified then myfile.c must be
     associated with KHOROS_HOME.

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

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

Khoros                    Release: 1.0                          1

