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 specifying 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 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.

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.