[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
lsrcp
remotely copies files using LSF
SYNOPSIS
lsrcp
[-a
] source_file target_file
lsrcp
[-h | -V
]DESCRIPTION
Remotely copies files using LSF.
lsrcp
is an LSF-enabled remote copy program that transfers a single file between hosts in an LSF cluster.lsrcp
uses RES on an LSF host to transfer files. If LSF is not installed on a host or if RES is not running thenlsrcp
usesrcp
to copy the file.To use
lsrcp
, you must have read access to the file being copied.Both the source and target file must be owned by the user who issues the command.
lsrcp
usesrcp
to copy a source file to a target file owned by another user.See
rcp(1)
and LIMITATIONS below for details.OPTIONS
-a
Appends source_file to target_file.
source_file target_file
Specify an existing file on a local or remote host that you want to copy, and a file to which you want to copy the source file.
File format is as follows:
[[user_name@][host_name]
:
][path/]file_nameuser_name
Login name to be used for accessing files on the remote host. If user_name is not specified, the name of the user who issued the command is used.
host_name
Name of the remote host on which the file resides. If host_name is not specified, the local host, the host from which the command was issued is used.
path
Absolute path name or a path name relative to the login directory of the user. Shell file name expansion is not supported on either the local or remote hosts. Only single files can be copied from one host to another.
Use "\" to transfer files from a Windows host to another Windows host. For example:
c:\share>
lsrcp file1 hostA:c:\temp\file2
Use "/" to transfer files from a UNIX host to a UNIX host. For example:
%
lsrcp file1 hostD:/home/usr2/test/file2
Always use "/" to transfer files from a UNIX host to a Windows host, or from a Windows host to a UNIX host. This is because the operating system interprets "\" and
lsrcp
will open the wrong files.For example, to transfer a file from UNIX to a Windows host:
%
lsrcp file1 hostA:/c:/temp/file2
For example, to transfer a file from Windows to a UNIX host:
c:\share>
lsrcp file1 hostD:/home/usr2/test/file2
file_name
Name of source file. File name expansion is not supported.
-h
Prints command usage to
stderr
and exits.-V
Prints LSF release version to
stderr
and exits.EXAMPLES
%
lsrcp myfile @hostC:/home/usr/dir1/otherfile
Copies file
myfile
from the local host to fileotherfile
onhostC
.%
lsrcp user1@hostA:/home/myfile user1@hostB:otherfile
Copies the file
myfile
fromhostA
to fileotherfile
onhostB
.
%
lsrcp -a user1@hostD:/home/myfile /dir1/otherfile
Appends the file
myfile
onhostD
to the fileotherfile
on the local host.
%
lsrcp /tmp/myfile user1@hostF:~/otherfile
Copies the file
myfile
from the local host to fileotherfile
onhostF
inuser1
's home directory.DIAGNOSTICS
lsrcp
attempts to copy source_file to target_file using RES. If RES is down or fails to copy the source_file,lsrcp
will use eitherrsh
or the shell command specified by LSF_RSH inlsf.conf
when the-a
option is specified. When-a
is not specified,lsrcp
will usercp
.LIMITATIONS
File transfer using
lscrp
is not supported in the following contexts:
- If LSF account mapping is used;
lsrcp
fails when running under a different user account- On LSF client hosts. LSF client hosts do not run RES, so
lsrcp
cannot contact RES on the submission host- Third party copies.
lsrcp
does not support third party copies, when neither source nor target file are on the local host. In such a casercp
orrsh
(or the shell command specified by LSF_RSH inlsf.conf
) will be used. If the target_file exists,lsrcp
preserves the modes; otherwise,lsrcp
uses the source_file modes modified with theumask
(seeumask(2)
) of the source host.You can do the following:
rcp
on UNIX. Iflsrcp
cannot contact RES on the submission host, it attempts to usercp
to copy the file. You must set up the/etc/hosts.equiv
orHOME/.rhosts
file in order to usercp
. See thercp
(1),rsh
(1),ssh
(1) manual pages for more information on using thercp
,rsh
, andssh
commands.- You can replace
lsrcp
with your own file transfer mechanism as long as it supports the same syntax aslsrcp
. This might be done to take advantage of a faster interconnection network, or to overcome limitations with the existinglsrcp
.sbatchd
looks for thelsrcp
executable in the LSF_BINDIR directory as specified incshrc.lsf
,profile.lsf
, orlsf.conf
.SEE ALSO
rsh
(1),rcp
(1),lsfintro
(1),res
(8)[ Top ]
[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
Date Modified: February 24, 2004
Platform Computing: www.platform.com
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.