rtc(1) CLIX rtc(1)
NAME
rtc - Controls remote tape drive
SYNOPSIS
rtc -a [-X|-T] [-s system] [-r rewdev] [-n norewdev] [-t timeout]
controldev
rtc -d controldev
FLAGS
-a Allocates a tape drive on the remote system. The tape drive
remains allocated until either a timeout occurs (see the -t
flag), or the command is used with the -d flag.
-d Deallocates a tape drive on a remote machine.
-n norewdev Specifies the tape drive norewdev on system as the non-
rewindable tape device.
-r rewdev Specifies the tape drive rewdev on system as the rewindable
tape device.
-s system Specifies the remote system where the tape drive resides.
-t timeout Sets the idle time allowed to timeout minutes. If the tape
is idle for timeout minutes, it is deallocated following a
warning, which is displayed on the system console. The
default timeout is five minutes.
-T Specifies a TCP/IP network. A TCP/IP network cannot be used
if connecting to a VMS system.
-X Specifies an XNS network (the default).
controldev Specifies a local device, which can be either rt0.ctl or
rt1.ctl.
If an allocate flag is not present, the corresponding environment
variables are used if set:
$RTCSYSTEM
Specifies the remote system (-s flag).
$RTCREWIND
Specifies the rewind device (-r flag).
$RTCNOREWIND
Specifies the non-rewindable device (-n flag).
2/94 - Intergraph Corporation 1
rtc(1) CLIX rtc(1)
$RTCTIMEOUT
Specifies the idle timeout (-t flag).
DESCRIPTION
The rtc command allows a tape drive on another machine to be used as if it
resides on the local machine.
The -a flag allows the use of a tape drive on a remote machine. Once
allocated, the remote tape drive remains allocated until a timeout occurs
or the -d flag is invoked. If the tape drive is being used when the -d
flag is invoked, an error is displayed. The controldev parameter is the
name of a tape control device (such as /dev/rmt/rt0.ctl) that controls the
functions of other tape devices in the same group.
Since the remote tape driver that rtc uses, rtc, is a STREAMS driver, the
driver must be kept open for the network connection to be preserved.
After issuing an allocate command, rtc forks a child process that remains
in the background before returning to the user. If this process is killed
or the user logs out, the remote tape drive will automatically be
deallocated when the current process using the tape drive exits.
The -d flag will cleanly close the connection to the remote host and send
a signal to the process that was executed by the -a flag.
The rtc command also looks in a series of .rtcrc files to determine the
proper action if a flag to the allocate command is not present. Given
controldev, rtc looks for a line that begins with the name controldev.
The line that begins with controldev should be followed by a remote system
name, separated by spaces or tabs. The rtc command continues looking for
a line that begins with that remote system name. The line should contain
a list of flags in the following order:
rewdev [norewdev [timeout]]
The following is a sample file:
/dev/rmt/rt0.ctl ipro1
ipro1 /dev/rmt/mt6 /dev/rmt/mt6n 10
The files are checked in the following order:
.rtcrc
$HOME/.rtcrc
/etc/.rtcrc
EXAMPLES
1. The following allocates the /dev/rmt/mt6 tape drive on machine ipro1:
2 Intergraph Corporation - 2/94
rtc(1) CLIX rtc(1)
rtc -a -s ipro1 -r /dev/rmt/mt6 -n /dev/rmt/mt6n -t 10 /dev/rmt/rt0.ctl
2. The following allocates the /dev/rmt/mt6 tape drive on CLIX machine
sys31, using tape control device /dev/rmt/rt0.ctl, and operating over
the TCP/IP network:
rtc -a -T -s sys31 -r /dev/rmt/mt6 -n /dev/rmt/mt6n -t 10 /dev/rmt/rt0.ctl
3. Once allocated, the tape drive can be read to or written from, as
shown in the following example:
cpio -ivmud < /dev/rmt/rto
FILES
/dev/rmt/rtx
Rewindable rtc device.
/dev/rmt/rtxn
Non-rewindable rtc device.
/dev/rmt/rtx.ctl
Control device (used only by rtc).
RELATED INFORMATION
Commands: cpio(1), mt(1), tar(1), rtc_s(8)
Functions: rtc_allocate(3)
Files: rtc(7), tc(7)
2/94 - Intergraph Corporation 3