IBM

ls_ropen

Opens a file on a remote host.

This routine performs operations on files located on remote hosts. This call corresponds to the UNIX open() system calls.

ls_ropen opens the named file located on the remote host. A remote file descriptor, rfd, is returned on success. You can use this descriptor in subsequent remote file calls as an argument.

Either the RES must be running at the remote host to service any remote file operation or rcp() 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.

#include <sys/types.h>
#include <unistd.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <limits.h>
#include <lsf/lsf.h>

int ls_ropen(char *host, char *path, int flags, int mode)

Parameters:
*host The host where the file to be opened is located.
*path The path name to the file to be opened.
flags Options for openning the file on the remote host.
mode File access permission related options.
Data Structures:
none
Define Statements:
none
Returns:
int: 0
Response is the same from its UNIX counterpart.

int:-1
Function failed.

Errors:
If the function fails, lserrno is set to indicate the error.
Equivalent line commands:
none
Files:
none
See also:
ls_rread

ls_rwrite

ls_rlseek

ls_rclose

ls_rstat

ls_rfstat

ls_rgetmnthost

ls_rfcontrol

ls_initrex



     
Date Modified: 16 Jul 2014

Terms of Use
Copyright © 1994-2014 International Business Machines Corp.
US Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.