Knowledge Center Contents Previous Next |
ls_rfcontrol()
Controls the behavior of remote file operations.
DESCRIPTION
This routine performs operations on files located on remote hosts.
ls_rfcontrol() controls the behavior of remote file operations. Possible commands are:
RF_CMD_MAXHOSTS
Allows the caller to specify the number of connected hosts. When a remote file operation is being serviced at a host for the first time, a connection is made to the Remote Execution Server's (RES) file server process on the remote host. If the number of connections reaches RF_MAXHOSTS defined in lsf.h, the least recently used connection which does not have any files open on that host is broken. The RF_CMD_MAXHOSTS command allows you to change the maximum number of connections. The new maximum is specified in arg.
RF_CMD_TERMINATE
Terminates the connection with the RES's file server process on host arg. arg is a pointer to the remote host name cast to int.
Either the RES must be running at the remote host to service any remote file operation or rcp() must be available.
ls_initrex() must be called before calling any remote file operation.
This remote file operation makes use of a Remote File Server on the remote host. When this RFS shuts down, its status will be reported to its client. The client should ignore this status.
SYNOPSIS
#include <sys/types.h> #include <unistd.h> #include <sys/stat.h> #include <fcntl.h> #include <limits.h> #include <lsf/lsf.h> int ls_rfcontrol(int command, int arg)PARAMETERS
command
arg
A pointer to the remote host name cast to int.
RETURN VALUES
integer:0
The function was successful.
integer:-1
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs
ls_ropen()
ls_rread()
ls_rwrite()
ls_rlseek()
ls_rclose()
ls_rstat()
ls_rfstat()
ls_rgetmnthost()
ls_initrex()
Equivalent line command
none
Files
none:
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |