From fa080de7afc95aa1c19a6e6fc0e0708ced2eadc4 Mon Sep 17 00:00:00 2001
From: Joseph Hunkeler <jhunkeler@gmail.com>
Date: Wed, 8 Jul 2015 20:46:52 -0400
Subject: Initial commit

---
 pkg/system/doc/rewind.hlp | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pkg/system/doc/rewind.hlp

(limited to 'pkg/system/doc/rewind.hlp')

diff --git a/pkg/system/doc/rewind.hlp b/pkg/system/doc/rewind.hlp
new file mode 100644
index 00000000..0519f81c
--- /dev/null
+++ b/pkg/system/doc/rewind.hlp
@@ -0,0 +1,36 @@
+.help rewind Apr92 system
+.ih
+NAME
+rewind -- rewind a previously allocated device
+.ih
+USAGE
+rewind device
+.ih
+PARAMETERS
+.ls device
+The device to be rewound.
+.le
+.ls initcache = yes
+Initialize the magtape device position cache for the device.  This causes
+the magtape i/o system to "forget" what it thinks it knows about things
+like the number of files on the tape, the amount of tape used, and so on.
+.le
+.ih
+DESCRIPTION
+\fIRewind\fR rewinds the specified device, which is most likely
+a magnetic tape, and which has been previously allocated to the user.
+
+By default \fIrewind\fR will initialize the device position cache.  When
+changing tapes, one should always either rewind or deallocate and reallocate
+the device, to force the magtape system to recompute the number of files
+on the tape and to ensure that the tape is left in a defined position.
+.ih
+EXAMPLES
+
+1. Rewind logical tape drive a.
+
+	cl> rewind mta
+.ih
+SEE ALSO
+allocate, deallocate, devstatus
+.endhelp
-- 
cgit 

