Both sides previous revisionPrevious revisionNext revision | Previous revision |
howto:dosemu [2020/12/17 21:24] – [Install DOS Utils] mlong | howto:dosemu [2024/05/25 19:20] (current) – [Install DOS Utils] update download links to use https instead of ftp, mention possible rename of x00.sys to x00.exe digital man |
---|
| |
:!: | :!: |
DOSEMU has been discontinued for more than a decade. However, it is the only viable solution for most distributions to run DOS doors, and is supported in Synchronet. | DOSEMU has been discontinued for more than a decade. However, it is the only viable solution for most distributions to run DOS doors, and is supported in Synchronet. However, there is [[howto:dosemu2|a guide]] to installing DOSEMU2. There is also [[https://gitlab.synchro.net/main/sbbs/-/issues/433|a Synchronet issue]] with some suggestions on how to get DOSEMU2 working with Synchronet. |
| |
| |
For other distributions, you will need to first install and configure dosemu, and then install FreeDOS (or your DOS of choice) and set it up to work with dosemu. Ensure that you can at least get to a DOS prompt through standalone DOSEMU before even trying to use it with Synchronet. | For other distributions, you will need to first install and configure dosemu, and then install FreeDOS (or your DOS of choice) and set it up to work with dosemu. Ensure that you can at least get to a DOS prompt through standalone DOSEMU before even trying to use it with Synchronet. |
| |
==== Edit SBBS.INI ==== | ==== Edit sbbs.ini ==== |
| |
Modify sbbs.ini to set ''UseDOSemu = true''. You can also modify the ''DOSemuPath'' and ''DOSemuConfPath'' if you need something other than the defaults. However, normally, the Synchronet-provided ''dosemu.conf'' will be in your ''[[dir:ctrl]]'' dir and dosemu.bin will be in your system bin. | Modify the ''[BBS]'' section of your ''[[dir:ctrl]]/sbbs.ini'' to set/add ''UseDOSemu = true''. |
| |
| You can also modify the ''DOSemuPath'' and ''DOSemuConfPath'' values if you need something other than the defaults. However, normally, the Synchronet-provided ''dosemu.conf'' will be in your Synchronet ''[[dir:ctrl]]'' dir and ''dosemu.bin'' will be in your system ''bin'' directory, so the default values should work fine. |
| |
==== Install DOS Utils ==== | ==== Install DOS Utils ==== |
| |
Make a ''dosutils'' directory, preferably in your ''[[dir::exec]]'' dir but you can also put it in your ''[[dir::xtrn]]'' dir. (Note: if you put in your ''[[dir::xtrn]]'' dir, you can use it for external editors. | Make a ''dosutils'' directory, preferably in your ''[[dir::exec]]'' dir but you can also put it in your ''[[dir::xtrn]]'' dir. (Note: if you put in your ''[[dir::xtrn]]'' dir, you can use it for external editors). |
| |
Inside the ''dosutils'' directory, you'll need a FOSSIL driver (''x00.exe'' works well, but you can also use ''bnu.com'', etc.). | Inside the ''dosutils'' directory, you'll need a FOSSIL driver (''x00.exe'' works well, but you can also use ''bnu.com'', etc.). |
| |
| If you aren't sure what to use, go with [[https://vert.synchro.net/files/main/comm/x00150.zip|X00]]. You may need to rename ''x00.sys'' to ''x00.exe'' if you use this archive. |
| Alternatively, you can use [[https://vert.synchro.net/files/main/comm/bnu189h.zip|BNU]] instead. |
| |
You may also need ''share.com'' if it is not found in your dosemu drive. | You may also need ''share.com'' if it is not found in your dosemu drive. |
==== Modify external.bat ==== | ==== Modify external.bat ==== |
| |
The ''external.bat'' file found in your ''[[dir:exec]]'' dir is the template used to build the batch file which executes each external program. Inside this file is where you will place your call to your FOSSIL driver, under the :NOEMU section, like this: | The ''external.bat'' file found in your ''[[dir:exec]]'' dir is the template used to build the batch file which executes each external program. Inside this file is where you will place your call to your FOSSIL driver, within the '':NOEMU'' section, like this: |
| <file> |
''IF "$RUNTYPE" == "FOSSIL" x00.exe eliminate >NUL'' | IF "$RUNTYPE" == "FOSSIL" x00.exe eliminate >NUL |
| </file> |
And you will also have share: | And you will also have share: |
| |
''@share >NUL'' | <file> |
| @share >NUL |
| </file> |
| |
==== Setup External Programs ==== | ==== Setup External Programs ==== |
==== Drive Letters ==== | ==== Drive Letters ==== |
| |
The rest of these instructions assume that you are using the default remapped drive letters and haven't changed them around in ''emusetup.bat'' or ''external.bat''. The default drive letters are: | Assuming you are using the default remapped drive letters and haven't changed them around in ''emusetup.bat'' or ''external.bat'', they are: |
| |
* D: - The Synchronet node directory, where the dropfile should probably be put. In door configurations, specify this drive (D:\) as the path to the dropfile. | * D: - The Synchronet node directory, where the dropfile should probably be put. In door configurations, specify this drive (D:\) as the path to the dropfile. |
Dropfile Dir: Place in Node Directory | Dropfile Dir: Place in Node Directory |
| |
==== Per-Program Files ==== | ==== Per-Program Configuration Files ==== |
| |
You can override the default system files used by placing a customized version in the external program's startup directory. Files that can be overridden in this manner are: | You can override the default system files used by placing a customized version in the external program's startup directory. Files that can be overridden in this manner are: |
| |
** external.bat ** used instead of ''[dir:exec]]/external.bat'' | ** external.bat ** used instead of ''[[dir:exec]]/external.bat'' |
| |
** dosemu.conf ** used instead of configured dosemu.conf | ** dosemu.conf ** used instead of configured dosemu.conf |
| |
** dosemu.ini ** used instead of ''[dir:exec]]/dosemu.ini'' | ** dosemu.ini ** used instead of ''[[dir:exec]]/dosemu.ini'' |
| |
==== Alternate DOS ==== | ==== Alternate DOS ==== |
| |
* [[http://www.icequake.net/bbs/syncmods/emusetup.bat|emusetup.bat]] | * [[http://www.icequake.net/bbs/syncmods/emusetup.bat|emusetup.bat]] |
* [[http://www.icequake.net/bbs/syncmods/dosutils.tar.gz|A collection of essential DOS BBS utils, such as ANSI drivers and FOSSIL drivers]] | * [[https://web.archive.org/web/20191007163940/http://www.icequake.net/bbs/syncmods/dosutils.tar.gz|A collection of essential DOS BBS utils, such as ANSI drivers and FOSSIL drivers]] |
| |
| |
* [[:howto:door:index|Install Doors]] | * [[:howto:door:index|Install Doors]] |
* [[:howto:|How-To Pages]] | * [[:howto:|How-To Pages]] |
| * [[https://web.archive.org/web/20191007163940/http://www.icequake.net/bbs/syncmods/|Ryan Underwood's original Synchronet-DOSEMU patch]] |
* [[http://synchro.net/docs/linux-dosemu-howto.txt|DOSEMU Synchronet DOORS HOWTO by Michael Capp circa 2003]] (does not use the methods described on this page) | * [[http://synchro.net/docs/linux-dosemu-howto.txt|DOSEMU Synchronet DOORS HOWTO by Michael Capp circa 2003]] (does not use the methods described on this page) |
| |
{{tag>linux doors dosemu}} | {{tag>linux doors dosemu}} |
| |