Bell 32V development

Work on file usr/man/man4/hs.4

Co-Authored-By: John Reiser <jfr@research.uucp>
Synthesized-from: 32v

diff --git a/usr/man/man4/hs.4 b/usr/man/man4/hs.4
new file mode 100644 (file)
index 0000000..ad53700
--- /dev/null
+++ b/usr/man/man4/hs.4
@@ -0,0 +1,41 @@
+.TH HS 4 
+.SH NAME
+hs \- RH11/RS03-RS04 fixed-head disk file
+.SH DESCRIPTION
+The files
+.I "hs0 ... hs7"
+refer to
+RJS03 disk drives 0 through 7.
+The files
+.I "hs8 ... hs15"
+refer to
+RJS04 disk drives 0 through 7.
+The RJS03 drives are each 1024 blocks long and
+the RJS04 drives are 2048 blocks long.
+.PP
+The
+.I hs
+files
+access the disk via the system's normal
+buffering mechanism
+and may be read and written without regard to
+physical disk records.
+There is also a `raw' inteface
+which provides for direct transmission between the disk
+and the user's read or write buffer.
+A single read or write call results in exactly one I/O operation
+and therefore raw I/O is considerably more efficient when
+many words are transmitted.
+The names of the raw HS files begin with
+.IR rhs .
+The same minor device considerations
+hold for the raw interface as for the normal interface.
+.PP
+In raw I/O the buffer must begin on a word boundary,
+and counts should be a multiple of 512 bytes
+(a disk block).
+Likewise
+.I lseek
+calls should specify a multiple of 512 bytes.
+.SH FILES
+/dev/hs?, /dev/rhs?