
kcp(1)                       Khoros                        kcp(1)

PROGRAM
     kcp - Copy an image

SYNTAX
     kcp

     -i             input image

     -o             Output Image

     [-V]           Gives the version for kcp

     [-U]           Gives the usage for kcp

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     kcp copies an image. Existence of the Khoros transport is
     transparent. The transport control are all interpreted.  kcp
     is a utility routine for use primarily by cantata but can
     also be useful in scripts when the user wishes use a like
     syntax when copying data from one transport to another, or
     even from a different machine.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: Output Image

OPTIONAL ARGUMENTS
     none

EXAMPLES
     The following example is analogous to the unix "cp from to"
     command.

          % kcp -i input.image -o output.image

     This is an example that copies from a remote machine's
     /etc/motd into local shared memory.

          % kcp -i /etc/motd@poopsie.eece.unm.edu -o shm=20

     This copies "/etc/motd" from poopsie.eece.unm.edu into the
     local machine's shared memory segment with key 20.  If the
     key 20 doesn't exist it will be created since the O_CREAT
     command was used.

     This is an example that copies from a remote machine's
     /etc/motd into a differnet remote machine's shared memory.

          % kcp -i /etc/motd@poopsie.eece.unm.edu -o
     shm=20@shammo

     This copies "/etc/motd" from poopsie.eece.unm.edu into the
     "shammo" machine's shared memory segment with key 20.  If
     the key 20 doesn't exist it will be created since kcp is
     creates the output if does not exist.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), transports(3)

RESTRICTIONS
     many...  the transport mechanisms are fairly new and there-
     fore are probably still unstable.  It is best to read the
     transport(3) document to get a better understanding of what
     the different transport are and what it's all about.

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

Khoros                    Release: 1.0                          1

