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), phantom(1), phantomd(1), kexec(1), verror(3), vgparms(3), vutils(3)

RESTRICTIONS
many... the transport mechanisms are fairly new and therefore are probably still unstable. It is best to read the vgparm(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.