CLOAKING.EXE

DOS Protected Mode Services (DPMS) is a set of extended DOS memory management services to allow DPMS-enabled DOS drivers to load and execute in extended memory and protected mode.

Not being a DOS extender by itself, DPMS is a minimal set of extended DOS memory management services to allow slightly modified DOS resident system extensions ( RSX) such as device drivers or TSRs (as so called ''DPMS clients'') to relocate themselves into extended memory and run in 16-bit or 32-bit protected mode while leaving only a tiny stub in conventional memory as an interface to communicate with the conventional DOS environment. The DPMS clients do so through DPMS services provided by a previously loaded ''DPMS server''.
The necessary size of the remaining stub depends on the type of driver, but often can be reduced to a few hundred bytes for just the header even for complex drivers.

By executing the driver in extended memory and freeing up conventional memory, DPMS not only allows very large drivers to load and take advantage of the available memory, but also to leave more memory available for normal DOS drivers to load or non-extended DOS applications to execute within the space constraints of the conventional memory area. This will also help increase the amount of free system resources under Windows. Providing unified interfaces for the software to allocate and use memory in protected mode without having to tunnel all requests through real mode DOS, DPMS at the same time can help improve system performance as well.

DPMS

DPMS was originally developed by Novell's Digital Research GmbH, Germany, in 1992. It is compatible with any DOS and can coexist with memory managers and DOS extenders such as DPMI, VCPI, etc. The DPMS API is reentrant and compatible with multitaskers such as the DR-DOS multitasker or DESQview. By providing a built-in DPMS VxD-driver, it is also compatible with Windows 3.x and Windows 9x.

The DPMS server must be loaded after the memory managers (and before the drivers using it), either as a "DPMSXXX0" device driver per DEVICE statement in CONFIG.SYS (preferred method), or later as a TSR. For debug purposes (for example in conjunction with Microsoft's WDEB386.EXE), SDK-versions of EMM386.EXE 3.00 can alternatively provide DPMS services via through a built-in DPMS.SYS module, then running at ring 1 instead of ring 0, as with the stand-alone version of DPMS.EXE. The option allows debugging under older NuMega SoftICE versions.

Depending on circumstances the server will occupy between about 700 to 1400 bytes of conventional memory by itself and cannot be loaded into UMBs.
The DPMS server will require at least a 286 machine to run, but since DPMS-enabled software can be designed in a way so that it continues to execute in conventional memory if DPMS services are not available, the software does not need to give up compatibility with systems not providing DPMS services, either because DPMS is not loaded or not available (for example on pre-286 processors). On 386 CPUs (and higher), the DPMS server will not only provide a set of 16-bit, but also a set of 32-bit services. Even on these machines, DPMS can be forced to load only its 16-bit services using the  option.

DPMS will allocate memory either through VCPI or XMS, depending on what kind of memory is available. VCPI will typically call down to XMS as well. Newer versions of DPMS can be forced to use one of these interfaces using the option. In some versions, it is possible to specify the maximum amount of extended memory to be allocated with .

DPMS registering services can be disabled or re-enabled at any time after load using the or command, however, this will only affect new drivers loaded, not those already running and using DPMS.

There are basically three revisions of the DPMS specification, DPMS beta, DPMS 1.0 (original Novell DOS 7 shipment) and DPMS 1.1 (since March 1994 update). The 1.0 specification continued to support the beta specification as well, whereas the 1.1 (and higher) implementation does not.

DPMS saw its debut in beta versions of DR DOS "Panther" in October 1992, which, besides others, came with DPMS-enabled versions of the Super PC-Kwik disk cache, Addstor's SuperStor disk compression, and DEBUG as "stealth" protected mode system debugger. While DPMS was already called "DOS Protected Mode Services" at this time, the DPMS.EXE/DPMS.SYS 0.10 driver would still display "DOS Protected Mode Server" startup messages. The PCMCIA card services CS in PalmDOS were DPMS-enabled as well. Later retail products such as Novell DOS 7 and Personal NetWare 1.0 in December 1993 also came with many DPMS-enabled drivers such as the file deletion tracking component DELWATCH 2.00, the adaptive disk cache NWCACHE 1.00, NWCDEX 1.00, a CD-ROM redirector extension, the peer-to-peer networking server SERVER 1.20, and STACKER 3.12, the disk compression component. DPMS was also provided by Caldera OpenDOS 7.01, DR-DOS 7.02 and 7.03, which, at least in some releases, added DPMS-enabled issues of DRFAT32 (a FAT32 redirector extension), LONGNAME (VFAT long filename support) and VDISK (virtual RAM disk). DR-DOS 7.03 contains the latest version of DPMS 1.44.

DPMS was also provided by IBM's PC DOS 7.0 and PC DOS 2000, which came with an older version of Novell's DPMS server and a DPMS-enabled version of Stacker 4.02 bundled.

Stac Electronics also produced a DPMS-enabled stand-alone version of Stacker 4.

PC-Kwik Corporation's Super PC-Kwik 6.xx for DOS and their Power Pak 4.0 for Windows also included the DPMS-enabled disk cache SUPERPCK in 1994.

Some third-party DOS driver suites such as the Eicon Diva or High Soft Tech GmbH (HST) Saphir CAPI ISDN drivers or PCMCIA/PCCard driver stacks such as Award's CardWare 2.5 (or higher) are known to support DPMS as well. After Phoenix's acquisition of Award, their PCMCIA drivers 6.0 (and higher) have been sold off to UniCore. CardWare 6.0 and 7.0 were available through APSoft, Socket Services (SSxxxxxx.EXE), Card Services (PCCS.EXE), PC Enable (PCENABLE.EXE), and card handlers (PCDISK.EXE, PCSRAM.EXE, PCATA.EXE, and PCFLASH.EXE) could use DPMS. Through LXE's integration of the stack into their ruggedized DOS PCs, DPMS also found its way into the Datalight ROM-DOS suite.

In 1999, Funk Software introduced a DPMS-enabled version of their remote control software Proxy Host, allowing PHOST to occupy only 9 KB of conventional memory.
The Remote Dial-in Client software REMOTE for the 833 Remote Access Server by Perle Systems could take advantage of DPMS for the same purpose at least since 2002. SciTech Software's Kendall Bennett investigated the possibility to add DPMS support to their DOS driver suite around 2000 as well, but this was never published.

Bret Johnson developed DPMS-enabled Print Screen to file (PRTSCR) and USB drivers for DOS.

CLOAKING

In 1993, Helix Software Company's memory manager NETROOM 3 introduced a feature very similar to Novell's DPMS: CLOAKING was used to relocate Helix's and third-party drivers into extended memory and run them at ring 0. Providing its functions as an extension to the real-mode EMS and XMS interface, its protected mode services are available under INT 2Ch.
A CLOAKING developer's kit was available which included a NuMega SoftICE debugger. Cloaked driver or TSR software hooking interrupts had to leave a small 11-byte stub in conventional memory which would invoke the CLOAKING server to pass execution to the protected mode portion of the driver software.

CLOAKING includes support for seamless operation under Windows 3.x and Windows 95, providing compatible INT 2Ch services to protected mode drivers via a Windows VxD, as well as seamless debugging through Windows start-up using SoftICE. This ability to transition between protected mode host environments is also the subject of a patent.

CLOAKING integrates into and works with existing virtual memory control programs, without switching descriptor tables or resetting the control registers. This allows for faster interrupt processing, according to Helix's documentation.

In contrast to Novell's DPMS, Helix's CLOAKING driver can be loaded high, but it does not run on 286 machines, though it does support 16-bit services and program structure on a 386. Also, CLOAKING 2.01 has been found to be incompatible with the DR-DOS multitasker ().

If no DPMS server is present when CLOAKING.EXE loads, CLOAKING will, by default, also provide a cloaked DPMS server at a mere 100 bytes increase of its DOS memory footprint. However, it can also coexist with a DPMS server loaded before CLOAKING. The loading of its built-in DPMS server can be suppressed using the parameter. DPMS-enabled drivers will work with both DPMS or CLOAKING, but not vice versa.

In NETROOM v3.04, the Supplemental Disk distribution dated 10 February 1995 included the password-protected resource file NR.ZIP (679,271 KB) as an undocumented file; DPMSCLK.EXE (13,904 KB), "Cloaked DPMS Server v3.03". The file does not reveal support for any options or parameters when queried using the standard help option,  . This file is ''not'' unzipped by the NETROOM 3 SETUP.EXE program and does not install. There is no hint of the file's existence in the NETROOM 3 software manual or any of the on-disk program documentation and human-readable files. This final version of NETROOM as released basically ignored DPMS.

Helix licensed a version of Award Software's BIOS and developed cloaked system and video BIOSes which executed entirely in protected mode, reducing their real-mode memory footprint down to 8 KB (instead of 96 KB) and used these as run-time BIOS in conjunction with their NETROOM memory manager.

As part of their Multimedia Cloaking product, Helix provided cloaked versions of Logitech's MOUSE 6.33 driver, Microsoft's MSCDEX, and a home-grown disk cache to replace Microsoft's SmartDrive drivers.

There was also a product named Multimedia Stacker consisting of Stac's DPMS-enabled Stacker 4.01 with Helix's above suite of cloaked DOS utilities.

The Logitech DOS mouse driver since MouseWare 6.50 was enabled to take advantage of CLOAKING as well, thereby reducing the mouse driver's memory footprint visible to DOS applications from 27 KB to 1 KB.

CLOAKING was also licensed to Symantec for their utility suite, to Corel for their CD Creator and Corel SCSI products, and to SMC Networks for their Ethernet drivers.

Novell's DPMS utility may not be used to temporarily disable DPMS with a command if those DPMS services are provided by CLOAKING instead of DPMS itself, because Helix's implementation will erroneously not only disallow new drivers to register with DPMS, but completely switch off DPMS services even for already loaded drivers, leading to a system crash.

NIOS

In 1993, Novell had announced plans to convert their resident workstation management utilities as well as their DOS network driver stacks (shells, redirectors and requestors) to use DPMS, however, only the Personal NetWare server component was modified to actually take advantage of it.

Announced in 1993, Novell introduced a new 32-bit DOS/Windows NetWare client (Client 32) based on ODI32/ NIOS in 1996, replacing the former 16-bit client based on ODI/ VLM. The NIOS (NetWare I/O Subsystem) client for DOS and Windows used techniques very similar to DPMS or Cloaking to relocate and run the code of the loaded NLMs (NetWare Loadable Modules) in protected mode and extended memory in order to reduce the conventional memory footprint of the network stack down to about 2 to 5 KB.

NIOS neither required nor used DPMS or Cloaking directly, and it did not provide a generic interface which could be used by non-NLM modules, however, it was certainly inspired by the DPMS technology and it can coexist with both of them.

While Novell's Personal NetWare was published unmodified as part of the DR-DOS suite by its newer owners Caldera, Lineo and DeviceLogics up to 2018, Personal NetWare had been abandoned since 1995 within Novell itself. This led to the situation that Novell never published a driver to support the Personal NetWare protocol under the newer 32-bit ODI32/NIOS stack, so that users of Personal NetWare, who could take advantage of the PNW server module's DPMS capabilities already, were bound to continue to use the memory-consuming ODI/VLM 16-bit client with its protocol driver.

See also

* DOS Protected Mode Interface (DPMI)
* Virtual Control Program Interface (VCPI)
* Extended Virtual Control Program Interface (XVCPI)

Notes

References

Further reading

*

External links

*
* {{cite book , title=PC DOS 7 Technical Update , chapter=Appendix E. DOS Protected Mode Services , pages=313–324 , id=Document Number GG24-4459-00 , date=February 1995 , edition=1 , publisher= IBM Corporation, International Technical Support Organization, Boca Raton Center , location=Boca Raton, FL, USA , url=http://www.eie.polyu.edu.hk/~enyhchan/DOS%207%20manual.pdf , access-date=2018-09-17 , url-status=live , archive-url=https://web.archive.org/web/20180918012220/http://www.eie.polyu.edu.hk/~enyhchan/DOS%207%20manual.pdf , archive-date=2018-09-18

DOS memory management
DOS extenders
DOS technology