SRTMEM System memory request F$SRTMEM

# HG changeset patch # User roug # Date 1026372373 0 # Node ID 90283636fb1d2c1157c984d26b43d3b4e1ffb999 # Parent 473b9aec582888a2d2fdde9a1cfed65e006dbc16 Received the missing pages from Michael Jackson, University of Newcastle diff -r 473b9aec5828 -r 90283636fb1d docs/os9sysprog/os9sysprog.docbook --- 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 @@ $8 = - Header Check. The one's compliment of the vertical parity - (exclusive OR) of the previous eight bytes + Header Check. The one's compliment of (the vertical parity + (exclusive OR) of) the previous eight bytes @@ -1753,6 +1753,12 @@ 32 Volume name: last char has sign bit set + + DD.OPT + $3F + 32 + Option area + @@ -6437,7 +6443,7 @@ -SRTMEM System memory request F$SRTMEM +SRTMEM System memory request F$SRTM @@ -6446,7 +6452,7 @@ ASSEMBLER CALL: - OS9 F$SRTMEM + OS9 F$SRTM MACHINE CODE: @@ -6454,26 +6460,30 @@ INPUT: - - - - OUTPUT: - - - - ERROR OUTPUT: - (CC) = C bit set. -(B) = Appropriate error code. - - - - - + (U) = Beginning address of memory to return. +(D) = Number of bytes to return. + + + OUTPUT: + None. + + + ERROR OUTPUT: + (CC) = C bit set. +(B) = Appropriate error code. + + + + + +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. + NOTE: THIS IS A PRIVILEGED SYSTEM MODE SERVICE REQUEST -VMODULE Validate module F$VMODUL +VMOD Verify module F$VMOD @@ -6482,7 +6492,7 @@ ASSEMBLER CALL: - OS9 F$VMODUL + OS9 F$VMOD MACHINE CODE: @@ -6490,20 +6500,26 @@ INPUT: - - - - OUTPUT: - - - - ERROR OUTPUT: - (CC) = C bit set. -(B) = Appropriate error code. - - - - + (X) = Address of module to verify + + + OUTPUT: + (U) = Address of module directory entry + + + ERROR OUTPUT: + (CC) = C bit set. +(B) = Appropriate error code. + + + + +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. NOTE: THIS IS A PRIVILEGED SYSTEM MODE SERVICE REQUEST @@ -6870,7 +6886,7 @@ OUTPUT: - (B) = New path number. + (A) = New path number. ERROR OUTPUT: @@ -7726,7 +7742,7 @@ -WRITE Write Data to File or Device I$WRITE +WRITE Write data to file or device I$WRITE @@ -7743,36 +7759,35 @@ INPUT: - (A) = Path number. -(X ) = Address of buffer. -(Y) = Maximum number of bytes to write - - - OUTPUT: - (Y) = Actual number of bytes written. - - - ERROR OUTPUT: - (CC) = C bit set. -(B) = Appropriate error code. - - - - - -DESCRIPTION: - -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. - -Data is written to the tile or device without processing or + (X) = Address of data to write. +(Y) = Number of bytes to write. +(A) = Path number. + + + OUTPUT: + (Y) = Number of bytes actually written. + + + ERROR OUTPUT: + (CC) = C bit set. +(B) = Appropriate error code. + + + + + +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. + +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. -WRITELINE Write Line of Text with Editing I$WRLN +WRITELN Write line of text with editing I$WRLN @@ -7781,7 +7796,7 @@ ASSEMBLER CALL: - OS9 I$WRLN + OS9 I$WRLN MACHINE CODE: @@ -7789,34 +7804,30 @@ INPUT: - (A) = Path number. -(X ) = Address of buffer. -(Y) = Maximum number of bytes to write - - - OUTPUT: - (Y) = Actual number of bytes written - - - ERROR OUTPUT: - (CC) = C bit set. -(B) = Appropriate error code. - - - - - -I$WRLN is similar to I$Write except it writes data until a -carriage return character or (Y) bytes are encountered. Line editing + (X) = Address of data to write. +(Y) = Maximum number of bytes to write. +(A) = Path number. + + + OUTPUT: + (Y) = Actual number of bytes written. + + + ERROR OUTPUT: + (CC) = C bit set. +(B) = Appropriate error code. + + + + + +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. -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. +For more information about line editing, see section 7.1.