RMTOPS

Section: C Library Functions (3)
Updated: local
Index Return to Main Contents

NAME

rmtops - access tape drives on remote machines

SYNOPSIS

#include <rmt.h>
#include <sys/stat.h>   /* MUST come after <rmt.h> */

int isrmt (fd)
int fd;

int rmtaccess (file, mode)
char *file;
int mode;

int rmtclose (fd)
int fd;

int rmtcreat (file, mode)
char *file;
int mode;

int rmtdup (fd)
int fd;

int rmtfcntl (fd, cmd, arg)
int fd, cmd, arg;

int rmtfstat (fd, buf)
int fd;
struct stat *buf;

int rmtioctl (fd, request, argp)
int fd, request;
char *argp;

int rmtisatty (fd)
int fd;

long rmtlseek (fd, offset, whence)
int fd, whence;
long offset;

int rmtlstat (file, buf)
char *file;
struct stat *buf;

int rmtopen (file, flags [, mode])
char *file;
int flags, mode;

int rmtread (fd, buf, nbytes)
int fd, nbytes;
char *buf;

int rmtstat (file, buf)
char *file;
struct stat *buf;

int rmtwrite (fd, buf, nbytes)
int fd, nbytes;
char *buf;

DESCRIPTION

Rmtops provides a simple means of transparently accessing tape drives on remote machines over the ethernet, via rsh(1) and rmt(8). These routines are used like their corresponding system calls, but allow the user to open up a tape drive on a remote system on which he or she has an account and the appropriate remote permissions.

A remote tape drive file name has the form

: system[.user]:/dev/???

where system is the remote system, /dev/??? is the particular drive on the remote system (raw, blocked, rewinding, non-rewinding, etc.), and the optional user is the login name to be used on the remote system, if different from the current user's login name. This corresponds to the remote syntax used by rcp(1).

For transparency, the user should include the file <rmt.h>, which has the following defines in it:

#define access rmtaccess
#define close rmtclose
#define creat rmtcreat
#define dup rmtdup
#define fcntl rmtfcntl
#define fstat rmtfstat
#define ioctl rmtioctl
#define isatty rmtisatty
#define lseek rmtlseek
#define lstat rmtlstat
#define open rmtopen
#define read rmtread
#define stat rmtstat
#define write rmtwrite

This allows the programmer to use open, close, read, write, etc. in their normal fashion, with the rmtops routines taking care of differentiating between local and remote files. This file should be included before including the file <sys/stat.h>, since it redefines the identifier ``stat,'' which is used to declare objects of type struct stat.

The routines differentiate between local and remote file descriptors by adding a bias (currently 128) to the file descriptor of the pipe. The programmer, if he must know if a file is remote, should use the isrmt function.

FILES

/usr/lib/librmt.a: Contains the remote tape library. To include the library with a program, add the flag -lrmt to the cc(1) command line.

DIAGNOSTICS

Several of these routines will return -1 and set errno to EOPNOTSUPP, if they are given a remote file name or a file descriptor on an open remote file (e.g., rmtdup).

BUGS

See diagnostics above. It is to be hoped that true remote file systems will eventually appear, and eliminate the need for these routines.

There is no way to use remote tape drives with the stdio(3) package, short of recompiling it entirely to use these routines.

The rmt(8) protocol is not very capable. In particular, it relies on TCP/IP sockets for error free transmission, and does no data validation of its own.

The rmt program allows no more than 10K bytes to be transferred at one time. Anymore is truncated.

AUTHORS

Jeff Lee (gatech!jeff) wrote the original routines for accessing tape drives via rmt(8).

Fred Fish (unisoft!fnf) redid them into a general purpose library.

Arnold Robbins (gatech!arnold) added the ability to specify a user name on the remote system, the <rmt.h> include file, this man page, and cleaned up the library a little.

This document was created by man2html, using the manual pages.
Time: 06:37:11 GMT, December 12, 2024