CP/M-86 Timeline - Revision history

Commodore Amiga: /* Replaced functions */ Clarified function 49

2023-03-18T12:45:54Z

Replaced functions: Clarified function 49

← Older revision		Revision as of 12:45, 18 March 2023
Line 222:		Line 222:
	* Function 7, Auxiliary Input Status, replaces Get I/O Byte.		* Function 7, Auxiliary Input Status, replaces Get I/O Byte.
	* Function 8, Auxiliary Output Status, replaces Set I/O Byte.		* Function 8, Auxiliary Output Status, replaces Set I/O Byte.
	* Function 49, Get/Set System System Variables ~~(renamed~~ from Get/Set System Control Block), ~~replaces Get SYSDAT address~~.		* Function 49, Get/Set System System Variables, replaces Get SYSDAT address in CP/M-86 1.1. Its behavior is slightly different from CP/M Plus Get/Set System Control Block as well, but it fulfills the same functionality.
	These function numbers were undefined on Concurrent CP/M.		These function numbers were undefined on Concurrent CP/M.

Commodore Amiga: /* CP/M-86 Plus 1.0 */ New function names

2023-03-18T12:43:49Z

CP/M-86 Plus 1.0: New function names

@@ Line 254: / Line 254: @@
 * Functions 13, 37, 49 no longer provide a return value. CP/M Plus would return an 8-bit value for function 37 and a 16-bit value for 49. Concurrent CP/M returned 8-bit values for 13, 37. No change of behavior took place compared to CP/M-86.
 * Compared to CP/M Plus, functions 27 and 31 now provide a return value in <code>ES</code>.
 == Answered questions ==

Commodore Amiga: /* Added functions */ Function 6 subfunction 0FDH

2023-03-18T12:18:25Z

Added functions: Function 6 subfunction 0FDH

← Older revision		Revision as of 12:18, 18 March 2023
Line 211:		Line 211:
	* New functions compared to all other versions: 116 (Set File Stamps), 172 (Auxiliary Block Input), 173 (Auxiliary Block Output) are new compared to all 3 versions.		* New functions compared to all other versions: 116 (Set File Stamps), 172 (Auxiliary Block Input), 173 (Auxiliary Block Output) are new compared to all 3 versions.
	* Functions new to CP/M Plus only: 51-58. These functions appeared in both CP/M-86 and Concurrent CP/M, typically relating to 8086 specific functionality.		* Functions new to CP/M Plus only: 51-58. These functions appeared in both CP/M-86 and Concurrent CP/M, typically relating to 8086 specific functionality.
	* Functions new to CP/M-86 1.1 only: 44-46, 48, 100-107, 152. These functions appeared in both CP/M Plus and Concurrent CP/M.		* Functions new to CP/M-86 1.1 only: 44-46, 48, 100-107, 152, as well as function 6 subfunction <code>0FDH</code>. These functions appeared in both CP/M Plus and Concurrent CP/M.
	* Functions included from CP/M Plus: 60, 99, 108-112. These are new to both CP/M-86 and Concurrent CP/M.		* Functions included from CP/M Plus: 60, 99, 108-112. These are new to both CP/M-86 and Concurrent CP/M.
	* Functions included from Concurrent CP/M: 141-143, 147, 154. These are new to both CP/M Plus and CP/M-86.		* Functions included from Concurrent CP/M: 141-143, 147, 154. These are new to both CP/M Plus and CP/M-86.

Commodore Amiga: /* CP/M-86 Plus 1.0 */ Register usage

2023-03-18T12:16:09Z

CP/M-86 Plus 1.0: Register usage

@@ Line 236: / Line 236: @@
 * Functions 38, 39, 41-43 existed on Concurrent CP/M but were only provided for compatibility on CP/M Plus. The documentation only mentions 39 existing on CP/M-86 Plus 1.0, but it returns 0 without doing anything.
 * Functions 128-140, 144-146, 148-151, 153, 155-164 existed on Concurrent CP/M only.
 == Answered questions ==

Commodore Amiga: /* CP/M-86 Plus 1.0 */ List functions that were added or removed

2023-03-18T11:40:24Z

CP/M-86 Plus 1.0: List functions that were added or removed

← Older revision		Revision as of 11:40, 18 March 2023
Line 202:		Line 202:

	To get an overview of the API evolution, we will compare the CP/M-86 Plus 1.0 BDOS API to three versions: the 8-bit CP/M Plus, the previous 16-bit single-tasking CP/M-86 1.1, as well as Concurrent CP/M 2.0.		To get an overview of the API evolution, we will compare the CP/M-86 Plus 1.0 BDOS API to three versions: the 8-bit CP/M Plus, the previous 16-bit single-tasking CP/M-86 1.1, as well as Concurrent CP/M 2.0.

			Just like other 8086-based systems, the BDOS is entered via the <code>int 224</code> instruction, with register <code>CL</code> containing the function number. The registers <code>DL</code>, <code>DX</code> and <code>DS:DX</code> contain the input parameter. The returned value is found in <code>AL</code>, <code>AX</code> or <code>ES:AX</code>, with <code>BX</code> containing a copy of <code>AX</code>. Some function return an error code in <code>CX</code>, similarly to the behavior of Concurrent CP/M.

			==== Added functions ====

			CP/M-86 Plus 1.0 alters the collection of functions compared to the 8-bit CP/M Plus, CP/M-86 1.1 and Concurrent CP/M. These alterations can be grouped according to whether they add new functionality without removing other functions, replace one function with another one, typically one with a similar scope, or remove some functionality altogether.

			* New functions compared to all other versions: 116 (Set File Stamps), 172 (Auxiliary Block Input), 173 (Auxiliary Block Output) are new compared to all 3 versions.
			* Functions new to CP/M Plus only: 51-58. These functions appeared in both CP/M-86 and Concurrent CP/M, typically relating to 8086 specific functionality.
			* Functions new to CP/M-86 1.1 only: 44-46, 48, 100-107, 152. These functions appeared in both CP/M Plus and Concurrent CP/M.
			* Functions included from CP/M Plus: 60, 99, 108-112. These are new to both CP/M-86 and Concurrent CP/M.
			* Functions included from Concurrent CP/M: 141-143, 147, 154. These are new to both CP/M Plus and CP/M-86.

			==== Replaced functions ====

			This section lists functions that will behave differently compared to either of the 3 other systems used in this comparison.

			Functions that are included from CP/M Plus, replacing the functions in CP/M-86 1.1:
			* Function 7, Auxiliary Input Status, replaces Get I/O Byte.
			* Function 8, Auxiliary Output Status, replaces Set I/O Byte.
			* Function 49, Get/Set System System Variables (renamed from Get/Set System Control Block), replaces Get SYSDAT address.
			These function numbers were undefined on Concurrent CP/M.

			The other functions are all inherited from CP/M-86 1.1:
			* Function 3 (Read Auxiliary Input), 4 (Write Auxiliary Output) replaced Raw Console Input and Raw Console Output from Concurrent CP/M. These numbers had identical functions on CP/M Plus.
			* Function 59 (Program Load) extends the function Load Overlay from CP/M Plus. This function was also present on Concurrent CP/M in its extended functionality.

			==== Removed functions ====

			Here we list functions that were removed compared to one of the 3 other systems with no functions replacing them. Some of these existed in a vestigial form that returned 0 without doing anything, for compatibility with multitasking systems.

			* Function 98 existed on CP/M Plus but it is not included in CP/M-86 Plus.
			* Functions 38, 39, 41-43 existed on Concurrent CP/M but were only provided for compatibility on CP/M Plus. The documentation only mentions 39 existing on CP/M-86 Plus 1.0, but it returns 0 without doing anything.
			* Functions 128-140, 144-146, 148-151, 153, 155-164 existed on Concurrent CP/M only.

	== Answered questions ==		== Answered questions ==

Commodore Amiga: /* API evolution */ CP/M-86 Plus, introduction (stub)

2023-03-18T10:46:04Z

API evolution: CP/M-86 Plus, introduction (stub)

← Older revision		Revision as of 10:46, 18 March 2023
Line 196:		Line 196:
	* Function 2 is renamed from Console Output to Virtual Console Output.		* Function 2 is renamed from Console Output to Virtual Console Output.
	* Function 163 is renamed from Return MP/M Version Number to Return CCP/M Version Number.		* Function 163 is renamed from Return MP/M Version Number to Return CCP/M Version Number.

			=== CP/M-86 Plus 1.0 ===

			Both the 8080 and 8086 versions of CP/M saw an update in 1983. The BDOS APIs of both of them incorporated some of the functionality of their multitasking counterparts, which is reflected in MP/M functions appearing in CP/M Plus and Concurrent CP/M functions appearing in CP/M-86 Plus. The BDOS kernel version also got updated, from 2.2 for the single-tasking versions and 3.0 for the multitasking versions, to 3.1 for both the 8-bit and 16-bit CP/M, however this version number was not generally reflected in the product version number.

			To get an overview of the API evolution, we will compare the CP/M-86 Plus 1.0 BDOS API to three versions: the 8-bit CP/M Plus, the previous 16-bit single-tasking CP/M-86 1.1, as well as Concurrent CP/M 2.0.

	== Answered questions ==		== Answered questions ==

Commodore Amiga: /* API evolution */ Added Concurrent CP/M-86 1.0 API

2023-03-12T11:18:21Z

API evolution: Added Concurrent CP/M-86 1.0 API

← Older revision		Revision as of 11:18, 12 March 2023
Line 189:		Line 189:
	** Function 11 is renamed from Get Console Status to Console Status.		** Function 11 is renamed from Get Console Status to Console Status.
	** Function 26 is renamed from Set DMA Address to Set DMA Offset.		** Function 26 is renamed from Set DMA Address to Set DMA Offset.

			=== Concurrent CP/M-86 1.0 ===

			Compared to MP/M-86 2.0, the only changes in the API are a few functions being renamed:
			* Function 1 is renamed from Console Input to Virtual Console Input.
			* Function 2 is renamed from Console Output to Virtual Console Output.
			* Function 163 is renamed from Return MP/M Version Number to Return CCP/M Version Number.

	== Answered questions ==		== Answered questions ==

Commodore Amiga: /* API evolution */ Clarified some of the function renamings

2023-03-12T11:13:10Z

API evolution: Clarified some of the function renamings

← Older revision		Revision as of 11:13, 12 March 2023
Line 134:		Line 134:
	* Function 58: Free all memory		* Function 58: Free all memory
	* Function 59: Program load		* Function 59: Program load

	~~The following function is renamed:~~
	* Function 26: Set DMA Offset, replacing Set DMA Address

	Other changes include:		Other changes include:
Line 142:		Line 139:
	* Function 6 (Direct Console I/O) accepts a new 8-bit parameter 0FEh for <code>DL</code> that checks for the console status.		* Function 6 (Direct Console I/O) accepts a new 8-bit parameter 0FEh for <code>DL</code> that checks for the console status.
	* The following functions that take an address parameter will use <code>DS:DX</code>: 9 (Print String), 10 (Read Console Buffer), 15 (Open File), 16 (Close File), 17 (Search for First), 19 (Delete File), 20 (Read Sequential), 21 (Write Sequential), 22 (Make File), 23 (Rename File), 30 (Set File Attributes), 33 (Read Random), 34 (Write Random), 35 (Compute File Size), 36 (Set Random Record), 40 (Write Random With Zero Fill).		* The following functions that take an address parameter will use <code>DS:DX</code>: 9 (Print String), 10 (Read Console Buffer), 15 (Open File), 16 (Close File), 17 (Search for First), 19 (Delete File), 20 (Read Sequential), 21 (Write Sequential), 22 (Make File), 23 (Rename File), 30 (Set File Attributes), 33 (Read Random), 34 (Write Random), 35 (Compute File Size), 36 (Set Random Record), 40 (Write Random With Zero Fill).
	* Function 26 (~~Set DMA Offset, replacing~~ Set DMA Address) takes a 16-bit parameter in <code>DX</code> to change only the offset part of the DMA address. The new function 51 (Set DMA Base) can be used to change the segment portion.		* Function 26 (Set DMA Address) takes a 16-bit parameter in <code>DX</code> to change only the offset part of the DMA address. The new function 51 (Set DMA Base) can be used to change the segment portion.
	* The following functions that return an address parameter will give the result in <code>ES:BX</code>: 27 (Get Addr(Alloc)), 31 (Get Addr(Disk Params)).		* The following functions that return an address parameter will give the result in <code>ES:BX</code>: 27 (Get Addr(Alloc)), 31 (Get Addr(Disk Params)).

Line 189:		Line 186:
	* Functions 15-23, 33, 34, 40 provide a 16-bit result instead of an 8-bit one.		* Functions 15-23, 33, 34, 40 provide a 16-bit result instead of an 8-bit one.
	* Functions 14, 35, 50 provide a 16-bit result instead of none.		* Functions 14, 35, 50 provide a 16-bit result instead of none.
			* Some functions are renamed:
			** Function 11 is renamed from Get Console Status to Console Status.
			** Function 26 is renamed from Set DMA Address to Set DMA Offset.

	== Answered questions ==		== Answered questions ==

Commodore Amiga: /* MP/M-86 2.0 */ Added function numbers that take or return a segment register

2023-03-12T10:54:48Z

MP/M-86 2.0: Added function numbers that take or return a segment register

← Older revision		Revision as of 10:54, 12 March 2023
Line 164:		Line 164:
	* The CP/M-86 functions 50-59 have been added.		* The CP/M-86 functions 50-59 have been added.
	* Function 128-140, 144-153, 157-164 provide an error code in <code>CX</code>.		* Function 128-140, 144-153, 157-164 provide an error code in <code>CX</code>.
	* Every function that took an address parameter (except function 26) now expects it in <code>DS:DX</code>.		* Every function that took an address parameter (except function 26) now expects it in <code>DS:DX</code>: 9, 10, 15-17, 19-23, 30, 33-36, 40-43, 100, 102-107, 129, 130, 134-140, 144, 149-152, 155, 157.
	* Every function that returned an address parameter now returns it in <code>ES:AX</code> and <code>ES:BX</code>.		* Every function that returned an address parameter now returns it in <code>ES:AX</code> and <code>ES:BX</code>: 27, 31, 154, 156.
	* Function 128 (previously called Absolute Memory Request) is now a duplicate of function 129.		* Function 128 (previously called Absolute Memory Request) is now a duplicate of function 129.
	* Function 143 only takes an 8-bit parameter instead of a 16-bit one (the high byte used to specify whether the memory of the subprocess should be released on termination).		* Function 143 only takes an 8-bit parameter instead of a 16-bit one (the high byte used to specify whether the memory of the subprocess should be released on termination).

Commodore Amiga: /* MP/M-86 2.0 */ Some fixes

2023-03-12T10:48:58Z

MP/M-86 2.0: Some fixes

← Older revision		Revision as of 10:48, 12 March 2023
Line 158:		Line 158:

	Compared to both:		Compared to both:
			* Function 0 provides an error code in <code>CX</code> on failure.
	* Function 47 provides a 16-bit result.		* Function 47 provides a 16-bit result.

	Compared to MP/M II:		Compared to MP/M II:
	* The CP/M-86 functions 50-59 have been added.		* The CP/M-86 functions 50-59 have been added.
	* ~~Functions~~ 128-140, 144-153, 157-164 provide an error code in <code>CX</code>.		* Function 128-140, 144-153, 157-164 provide an error code in <code>CX</code>.
	* Every function that took an address parameter (except function 26) now expects it in <code>DS:DX</code>.		* Every function that took an address parameter (except function 26) now expects it in <code>DS:DX</code>.
	* Every function that returned an address parameter now returns it in <code>ES:AX</code> and <code>ES:BX</code>.		* Every function that returned an address parameter now returns it in <code>ES:AX</code> and <code>ES:BX</code>.
Line 179:		Line 180:

	Compared to CP/M-86:		Compared to CP/M-86:
	* The MP/M II functions 38, 39, 41-48, 100-107, 128-164 have been added.		* The MP/M II functions 38, 39, 41-46, 48, 100-107, 128-164 have been added.
	* Functions 3 (Reader Input) and 4 (Punch Output) have been replaced by the MP/M II functions with the same numbers (Raw Console Input and Raw Console Output).		* Functions 3 (Reader Input) and 4 (Punch Output) have been replaced by the MP/M II functions with the same numbers (Raw Console Input and Raw Console Output).
	* Function 6 (Direct Console I/O) now has the 0FDh subfunction.		* Function 6 (Direct Console I/O) now has the 0FDh subfunction.
	* Functions 7 (Get I/O Byte) and 8 (Set I/O Byte) have been removed.		* Functions 7 (Get I/O Byte) and 8 (Set I/O Byte) have been removed.
			* Function 0 does not take an argument
	* Functions 53-57, 59 provide an error code in <code>CX</code>.		* Functions 53-57, 59 provide an error code in <code>CX</code>.
	* Functions 13, 28, 37 provide an 8-bit result (function 37 returned 0 on CP/M-86).		* Functions 13, 28, 37, 57 provide an 8-bit result (function 37 returned 0 on CP/M-86).
	* Functions 14-23, 33, 34, 40 provide a 16-bit result instead of an 8-bit one.		* Functions 15-23, 33, 34, 40 provide a 16-bit result instead of an 8-bit one.
	* Functions 35, 50 provide a 16-bit result instead of none.		* Functions 14, 35, 50 provide a 16-bit result instead of none.

	== Answered questions ==		== Answered questions ==