Mercurial > hg > Members > kono > nitros9-code

changeset 166:90283636fb1d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Received the missing pages from Michael Jackson, University of Newcastle
author roug
date Thu, 11 Jul 2002 07:26:13 +0000
parents 473b9aec5828
children 51cb8573849f
files docs/os9sysprog/os9sysprog.docbook
diffstat 1 files changed, 98 insertions(+), 87 deletions(-) [+]
line wrap: on
line diff
--- a/docs/os9sysprog/os9sysprog.docbook	Thu Jul 11 03:32:56 2002 +0000
+++ b/docs/os9sysprog/os9sysprog.docbook	Thu Jul 11 07:26:13 2002 +0000
@@ -1052,8 +1052,8 @@
 
 <row>
 	<entry>$8 =</entry>
-	<entry>Header Check. The one's compliment of the vertical parity
-	(exclusive OR) of the previous eight bytes</entry>
+	<entry>Header Check. The one's compliment of (the vertical parity
+	(exclusive OR) of) the previous eight bytes</entry>
 </row>
 
 </tbody>
@@ -1753,6 +1753,12 @@
     <entry>32</entry>
     <entry>Volume name: last char has sign bit set</entry>
 </row>
+<row>
+    <entry>DD.OPT</entry>
+    <entry>$3F</entry>
+    <entry>32</entry>
+    <entry>Option area</entry>
+</row>
 </tbody>
 </tgroup>
 </informaltable>
@@ -6437,7 +6443,7 @@
 </sect1>
 
 <sect1>
-<title>SRTMEM System memory request F$SRTMEM</title>
+<title>SRTMEM System memory request F$SRTM</title>
 
 <informaltable frame="none">
 <tgroup cols="2">
@@ -6446,7 +6452,7 @@
 <tbody>
 <row>
 	<entry>ASSEMBLER CALL:</entry>
-	<entry>OS9  F$SRTMEM</entry>
+	<entry>OS9  F$SRTM</entry>
 </row>
 <row>
 	<entry>MACHINE CODE:</entry>
@@ -6454,26 +6460,30 @@
 </row>
 <row>
 	<entry>INPUT:</entry>
-	<entry></entry>
-</row>
-<row>
-	<entry>OUTPUT:</entry>
-	<entry></entry>
-</row>
-<row>
-	<entry>ERROR OUTPUT:</entry>
-	<entry><literallayout>(CC) = C bit set.
-(B) = Appropriate error code.</literallayout></entry>
-</row>
-</tbody>
-</tgroup>
-</informaltable>
-
+	<entry><literallayout>(U) = Beginning address of memory to return.
+(D) = Number of bytes to return.</literallayout></entry>
+</row>
+<row>
+	<entry>OUTPUT:</entry>
+	<entry>None.</entry>
+</row>
+<row>
+	<entry>ERROR OUTPUT:</entry>
+	<entry><literallayout>(CC) = C bit set.
+(B) = Appropriate error code.</literallayout></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>
+This system mode service request is used to deallocate a block of contigous 256 byte pages.
+The U register must point to an even page boundary.
+</para>
 <para>NOTE: THIS IS A PRIVILEGED SYSTEM MODE SERVICE REQUEST</para>
 </sect1>
 
 <sect1>
-<title>VMODULE Validate module F$VMODUL</title>
+<title>VMOD Verify module F$VMOD</title>
 
 <informaltable frame="none">
 <tgroup cols="2">
@@ -6482,7 +6492,7 @@
 <tbody>
 <row>
 	<entry>ASSEMBLER CALL:</entry>
-	<entry>OS9  F$VMODUL</entry>
+	<entry>OS9  F$VMOD</entry>
 </row>
 <row>
 	<entry>MACHINE CODE:</entry>
@@ -6490,20 +6500,26 @@
 </row>
 <row>
 	<entry>INPUT:</entry>
-	<entry></entry>
-</row>
-<row>
-	<entry>OUTPUT:</entry>
-	<entry></entry>
-</row>
-<row>
-	<entry>ERROR OUTPUT:</entry>
-	<entry><literallayout>(CC) = C bit set.
-(B) = Appropriate error code.</literallayout></entry>
-</row>
-</tbody>
-</tgroup>
-</informaltable>
+	<entry>(X) = Address of module to verify</entry>
+</row>
+<row>
+	<entry>OUTPUT:</entry>
+	<entry>(U) = Address of module directory entry</entry>
+</row>
+<row>
+	<entry>ERROR OUTPUT:</entry>
+	<entry><literallayout>(CC) = C bit set.
+(B) = Appropriate error code.</literallayout></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>This system mode service request checks the module header parity
+and CRC bytes of an OS-9 module. If these values are valid, then
+the module directory is searched for a module with the same name.
+If a module with the same name exists, the one with the highest
+revision level is retained in the module directory. Ties are
+broken in favor of the established module.</para>
 
 <para>NOTE: THIS IS A PRIVILEGED SYSTEM MODE SERVICE REQUEST</para>
 </sect1>
@@ -6870,7 +6886,7 @@
 </row>
 <row>
 	<entry>OUTPUT:</entry>
-	<entry>(B) = New path number.</entry>
+	<entry>(A) = New path number.</entry>
 </row>
 <row>
 	<entry>ERROR OUTPUT:</entry>
@@ -7726,7 +7742,7 @@
 </sect1>
 
 <sect1>
-<title>WRITE Write Data to File or Device I$WRITE</title>
+<title>WRITE Write data to file or device I$WRITE</title>
 
 <informaltable frame="none">
 <tgroup cols="2">
@@ -7743,36 +7759,35 @@
 </row>
 <row>
 	<entry>INPUT:</entry>
-	<entry><literallayout>(A) = Path number.
-(X ) = Address of buffer.
-(Y) = Maximum number of bytes to write</literallayout></entry>
-</row>
-<row>
-	<entry>OUTPUT:</entry>
-	<entry>(Y)  = Actual number of bytes written.</entry>
-</row>
-<row>
-	<entry>ERROR OUTPUT:</entry>
-	<entry><literallayout>(CC) = C bit set.
-(B) = Appropriate error code.</literallayout></entry>
-</row>
-</tbody>
-</tgroup>
-</informaltable>
-
-<para>DESCRIPTION:</para>
-
-<para>I$WRITE outputs bytes to a file or device associated with the path
-number specified. The path must have been opened or created in the
-write or update access modes.</para>
-
-<para>Data is written to the tile or device without processing or
+	<entry><literallayout>(X) = Address of data to write.
+(Y) = Number of bytes to write.
+(A) = Path number.</literallayout></entry>
+</row>
+<row>
+	<entry>OUTPUT:</entry>
+	<entry>(Y) = Number of bytes actually written.</entry>
+</row>
+<row>
+	<entry>ERROR OUTPUT:</entry>
+	<entry><literallayout>(CC) = C bit set.
+(B) = Appropriate error code.</literallayout></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+
+<para>WRITE outputs one or more bytes to a file or device associated
+with the path
+number specified. The path must have been OPENed or CREATEd in the
+WRITE or UPDATE access modes.</para>
+
+<para>Data is written to the file or device without processing or
 editing. If data is written past the present end-of-file, the file is
 automatically expanded.</para>
 </sect1>
 
 <sect1>
-<title>WRITELINE Write Line of Text with Editing I$WRLN</title>
+<title>WRITELN Write line of text with editing I$WRLN</title>
 
 <informaltable frame="none">
 <tgroup cols="2">
@@ -7781,7 +7796,7 @@
 <tbody>
 <row>
 	<entry>ASSEMBLER CALL:</entry>
-	<entry>OS9  I$WRLN</entry>
+	<entry>OS9 I$WRLN</entry>
 </row>
 <row>
 	<entry>MACHINE CODE:</entry>
@@ -7789,34 +7804,30 @@
 </row>
 <row>
 	<entry>INPUT:</entry>
-	<entry><literallayout>(A) = Path number.
-(X ) = Address of buffer.
-(Y) = Maximum number of bytes to write</literallayout></entry>
-</row>
-<row>
-	<entry>OUTPUT:</entry>
-	<entry>(Y)  = Actual number of bytes written</entry>
-</row>
-<row>
-	<entry>ERROR OUTPUT:</entry>
-	<entry><literallayout>(CC) = C bit set.
-(B) = Appropriate error code.</literallayout></entry>
-</row>
-</tbody>
-</tgroup>
-</informaltable>
-
-<para>I$WRLN is similar to I$Write except it writes data until a
-carriage return character or (Y) bytes are encountered. Line editing
+	<entry><literallayout>(X) = Address of data to write.
+(Y) = Maximum number of bytes to write.
+(A) = Path number.</literallayout></entry>
+</row>
+<row>
+	<entry>OUTPUT:</entry>
+	<entry>(Y) = Actual number of bytes written.</entry>
+</row>
+<row>
+	<entry>ERROR OUTPUT:</entry>
+	<entry><literallayout>(CC) = C bit set.
+(B) = Appropriate error code.</literallayout></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+
+<para>This system call is similar to WRITE except it writes data until a
+carriage return character is encountered. Line editing
 is also activated for character-oriented devices such as terminals,
 printers, etc. The line editing refers to auto line feed, null
 padding at end of line, etc.</para>
 
-<para>The number of bytes actually written (returned in Y) does not
-reflect any additional bytes that may have been added by file
-managers or device drivers for device control. For example, if SCF
-appends a line feed and nulls after carriage return characters, these
-extra bytes are not counted.</para>
+<para>For more information about line editing, see section 7.1.</para>
 
 </sect1>
 </chapter>