Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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