This is the `Frequently Asked Questions' (FAQ) / HOWTO document for dosemu,
(dosemu-HOWTO).  The most up-to-date version of the dosemu-HOWTO may
be found in dspsun.eas.asu.edu:/pub/dosemu.

Please read this document *to the very end*, before you post a question to a
newsgroup / Linux-MSDOS channel / the developers.  This will reduce the number
of redundant questions, and releases us all to more constructive work (like
improving dosemu).

This HOWTO is edited and maintained by:  Mike Deisher
Last update: February 17 1994, for dosemu 0.49pl4

Additions or corrections to the HOWTO should be directed to
deisher@dspsun.eas.asu.edu
========================================================================
CONTENTS

Section 1: The preliminaries
----------------------------
Q1.1	What's the newest version of dosemu and where can I get it?
Q1.2	Where can I follow the development?
Q1.3	What documentation is available for dosemu?


Section 2: Compiling and installing dosemu
------------------------------------------
Q2.1	What does "emu.c:349: parse error before `outfuntype'" mean?
Q2.2	What does "scan.o: Undefined symbol _yywrap" mean?
Q2.3	Can I use dosemu on a multi-user system?


Section 3: Hard disk setup
--------------------------
Q3.1	How do I use my hard disk with dosemu?
Q3.2	Can I use my stacked/double-spaced/super-stored disk?
Q3.3	I get an error message about my config.sys file but it looks fine.


Section 4: Serial ports and mice
--------------------------------
Q4.1	Where are the (microsoft compatible) mouse drivers?
Q4.2	Why doesn't the mouse driver work?
Q4.3	How do I use dosemu over the serial ports?


Section 5: dosemu and X-windows
---------------------------------------
Q5.1	Can I run dosemu in console mode while running X?
Q5.2	Is it possible to run dosemu in an xterm?


Section 6: Video
---------------------------------------
Q6.1	Exiting from dosemu gives me a screen full of garbage.
Q6.2	How do I get dosemu to work with my Trident/Actix/other video card?


Section 7: Problems and fixes
-----------------------------
Q7.1	Why does dosemu lock up after one keystroke?
Q7.2	Why does my ethernet driver lock-up dosemu?
Q7.3	Why are my keystrokes echoed ttwwiiccee??
Q7.4	Why does give "divide overflow" errors after running for more
        than 24-hours? 
Q7.5	Where did the debugging output go?


Section 8: Contributing to the dosemu project
---------------------------------------------
Q8.1	Who is responsible for dosemu?
Q8.2	I want to help.  Who should I contact?
========================================================================


Section 1:  The preliminaries
=============================

Q1.1	What's the newest version of dosemu and where can I get it?
-------------------------------------------------------------------
The newest version of dosemu is dosemu0.49pl3.3 and can be ftp'ed from the
following sites:

     dspsun.eas.asu.edu:/pub/dosemu/
     tsx-11.mit.edu:/pub/linux/ALPHA/dosemu/

(Be sure to get and apply all patches.)


Q1.2	Where can I follow the development?
-------------------------------------------
If you want to follow the development of dosemu, you should consider
subscribing to the MSDOS channel on Linux-activists.  To subscribe,
send mail to linux-activists-request@niksula.hut.fi.  Your mail HEADER
or FIRST LINE must contain the line:

			X-Mn-Admin: join MSDOS

To post to the list, send mail to linux-activists@niksula.hut.fi.
Your mail HEADER or FIRST LINE must contain the line:

			X-Mn-Key: MSDOS


Q1.3	What documentation is available for dosemu?
---------------------------------------------------
The dosemu manual (dosemu.texinfo) written by Robert Sanders has not
been updated in some time but is still a good source of information.
It is distributed with dosemu.

The "dosemu Novice's Altering Guide" or DANG is a road map to the
inner workings of dosemu.  It is designed for the adventurous, those
who wish to modify the source code themselves.  The DANG is maintained
by Alistair MacDonald (am20@unix.york.ac.uk) and is posted once in a
while to the MSDOS channel of Linux Activists.

The EMU success list (EMUsuccess.txt) is a list of all programs that
have been reported to work with dosemu.  It is posted once in a while
to the MSDOS channel of Linux Activists.  The most recent version can
be found on dspsun.eas.asu.edu:/pub/dosemu.

And then, of course, there is the dosemu FAQ/HOWTO.  But you already
know about that, don't you.  It is also posted once in a while to the
MSDOS channel of Linux Activists.  The most recent version can be
found on dspsun.eas.asu.edu:/pub/dosemu.

  
Section 2:  Compiling and installing dosemu
===========================================
Q2.1	What does ``emu.c:349: parse error before `outfuntype'\,'' mean?
------------------------------------------------------------------------
James B. MacLean (jmaclean@fox.nstn.ns.ca) reported (12/1/93) that   

A fix that works is:  Change the 'outfuntype c' parm in line 349 to
'int (*c())(int)', and try again. 

[Note:  "outfuntype" is defined in termcap.h.  You may have a bad or
 incomplete termcap.h (termcap.h is not part of dosemu).]


Q2.2	What does "scan.o: Undefined symbol _yywrap" mean?
----------------------------------------------------------
Alan David Modra (alan@spri.levels.unisa.edu.au) reported (2/16/94) that

Flex-2.4.6 generates code that requires linking in libfl.a
You need to add -lfl to the linker command line:

  gcc -o par scan.o parse.o -lfl

[Note:  edit parse/Makefile to incorporate this change]


Q2.3	Can I use dosemu on a multi-user system?
------------------------------------------------
Corey Sweeney (corey@amiganet.xnet.com) reported (12/8/93) that

If you running dosemu on a system in which more then one
person may want to run dosemu, then you may want to change the
directory of your hard drive image.  Currently in the /etc/dosemu/config
file there exists the line saying that the hard drive image is
"hdimage".  If you change this to "/etc/dosemu/hdimage" then people do
not have to worry about what directory they are in when they run
dosemu, and hdimage does not have to be moved each time you upgrade to
the next patch level.

If you do do this for multi-user dosemu, then you will want to make
the hdimage in /etc/dosemu read-only for everyone but the dosemu
administrator.

Note: you can use the new emufs.sys thing to mount a "public"
      directory and/or a "private" directory (a sub-directory in each
      person's home directory).


Section 3: Hard disk setup
==========================
Q3.1	How do I use my hard disk with dosemu?
----------------------------------------------

First, mount your dos hard disk partition as a Linux subdirectory.
For example, you could create a directory in Linux such as /dos (mkdir
-m 755 /dos) and add a line like

   /dev/hda1       /dos     msdos   umask=022

to your /etc/fstab.  (In this example, the hard disk is mounted
read-only.  You may want to mount it read/write by replacing "022"
with "000" and using the -m 777 option with mkdir) Now "mount /dos".
Now you can add a line like

  lredir d: linux\fs/dos

to the AUTOEXEC.BAT file in your hdimage (see the note on LREDIR
below).  

Tim Bird (Tim_R_Bird@Novell.COM) states that LREDIR users should

be careful when they use LREDIR in the autoexec, because COMMAND.COM
will continue parsing the autoexec.bat from the redirected drive as
the same file offset where it left off in the autoexec.bat on the
physical drive.  For this reason, it is safest to have the
autoexec.bat on the redirected drive and the physical drive
(diskimage) be the same.


Q3.2	Can I use my stacked/double-spaced/super-stored disk?
-------------------------------------------------------------

At this time, compressed drives cannot be accessed via the redirector
(lredir).  However, many people have had success by simply
uncommenting the

   disk { wholedisk "/dev/hda" }        # 1st partition on 1st disk

line in their dosemu config file.  A few others have had success using

   disk { partition "/dev/hda1" 1 }

Holger Schemel (q99492@pbhrzx.uni-paderborn.de) reported (2/10/94) that

Works even fine under DOSEMU with MS-DOS 6.0. If you have problems, then
you have to edit the file 'DBLSPACE.INI' manually and change the disk
letter to the letter your drive gets under DOSEMU.


Q3.3	I get an error message about my config.sys file but it looks fine.
--------------------------------------------------------------------------
Corey Sweeney (corey@amiganet.xnet.com) reported (12/8/93) that

Sometimes when loading config.sys you will get a error message
saying something like "error in line 6 of config.sys".  The problem
will go away if you add several carriage returns at the end of your
config.sys.



Section 4:  Serial ports and mice
=================================
Q4.1	Where are the (microsoft compatible) mouse drivers?
-----------------------------------------------------------
Tom Kimball (tk@pssparc2.oc.com) reported (11/24/93) that

Several people said to use a different mouse driver and suggested
some.  I found a couple that seem to work fine.

   oak.oakland.edu:/pub/msdos/mouse/mouse701.zip   (mscmouse)
   oak.oakland.edu:/pub/msdos/mouse/gmous102.zip   (gmouse)


Q4.2	Why doesn't the mouse driver work?
------------------------------------------
sdh@fishmonger.nouucp (Scott D. Heavner) reported (11/27/93) that

If you start the mouse driver and it just hangs (it might actually
take 30-60s), but if you are waiting longer than a minute for the
mouse driver to start, remove any "timer" lines in your config
file.


Q4.3	How do I use dosemu over the serial ports?
--------------------------------------------------
Corey Sweeney (corey@amiganet.xnet.com) reported (12/8/93) that

If you plan to be using dosemu over a serial line, telnet
session, or just don't want to use raw console mode, then you will
probably want to get to know the termcap file.  For those who don't
know, the termcap file is usually located in the /etc directory.
It contains the information on what sequences of characters to send
to your terminal, and what sequences of characters from your
terminal represent what keystrokes.  If when you hit F5, and it
does not work, it will usually be the fault of a incorrect termcap
entry.  (To learn more about termcaps look up the termcap man page.)

Now the information in the termcap relates to entries in the dosemu
code.  So after you put k5=\E[[E in your termcap, whenever
your terminal sends \E[[E, dosemu translates that and says
``he hit the k5 key!''.  Then it is up to dosemu to figure out what the
proper scancode for the k5 key is, and push that into the buffer in
some magical way.  To determine the scancode, it looks up in a little
table in termio.c.  In termio.c under the line which (currently) says

   #define FUNKEYS 20

There exist several lines following the form

   {NULL, "termcap code", scancode} /* name of key */

so when it says

   {NULL, "k5", 0x3f00} /* F5 */

it's saying that 0x3f00 is the scancode for F5, and that when the
person activates the k5 sequence (defined in the termcap) to stuff the
F5 scancode into the buffer.  

Now that's all fine and dandy for analyzing how dosemu does this,  but
you probably want to be able to do something with this new
information.  Well you can add functionality for the F11 and F12 keys
(and any other keys that you can find the scancode for).

All you have to do is add a line to the termio.c table that says:

   {NULL, "ka", 0x8500} /* F11 */

Then to actually get it to read the line you just put in, add one to
the FUNKEYS number.

   #define FUNKEYS = 21

Then add a ``ka'' entry to your termcap.  After that, every time you hit
the sequence stored in your termcap for ka, your dos program
recognizes an ``F11''.

! Warning:  Make sure that ka is not in use in your termcap.  If it is
            you are headed for trouble.

Note:  The scancode for F12 is 0x8600.


Section 5:  dosemu and X-windows
================================
Q5.1	Can I run dosemu in console mode while running X?
---------------------------------------------------------
Ronald Schalk (R.Schalk@uci.kun.nl) reported (1/17/94) that

Yes, no problem, just remember to use ctrl-alt-<Fn> to go to a Virtual
Console (VC), and you can run any Linux application (dosemu is a
linux-application).  I've got almost always WP5.1 in a dos session.

[Note:  Use alt-F7 to switch back to X from dosemu.] 
[Note:  Some people have reported problems when dosemu is started before X]


Q5.2	Is it possible to run dosemu in an xterm?
-------------------------------------------------
Evmorfopoulos Dimitris (devmorfo@mtu.edu) reported (12/10/93) that

It is possible to run dosemu under an xterm, but without any
graphics, and with no more than 128 characters.

H. Peter Anvin (hpa@hook.eecs.nwu.edu) adds (2/6/94)

no more than 128 characters... unless you use a special font.  Someone
has an IBM PC (CP 437) X font for use with ANSI-graphics on BBS's, as
well as a patch for Xterm that *might* include character translation
(for letters like Å, Ä, Ö for example...)


Section 6:  Video
=================
Q6.1	Exiting from dosemu gives me a screen full of garbage.
--------------------------------------------------------------
Keith A Grider (kgrider@magnus.acs.ohio-state.edu) reported (12/5/93) that

I have seen many postings concerning this with exit from X as well
as exiting from a graphic dos screen.  it seems to be prevalent
among ATI graphic card users as well as a few others.  The problem
is that the font information for the vga text screen is not being
saved.  The only way I have been able to fix it is to download the
vgalib-090.tar.gz file from sunsite.unc.edu.  It is (I believe) in
the pub/Linux/GCC directory.  You get a lot of stuff that is not
directly used to solve this problem, but in the fonts directory
that is created when you untar the file, there are 2 files of
interest, runx and restorefont.  Read the README file in this
directory.  Copy runx and restorefont to a directory in your path.
when runx is used, for example, it saves the font information in
tmp/fontdata.  I use a file called fix which consists of the line:

   restorefont -r /tmp/fontdata

so that it is easy to 'fix' a vt when I go there from X
(i.e. ctrl-alt-f2).  This should also work for dosemu.  I think the
XFree86 people know about the problem and are working on a solution
as this is a bit of a kluge.


Q6.2	How do I get dosemu to work with my Trident/Actix/other video card?
---------------------------------------------------------------------------
[The screen flickers violently, displays the video BIOS startup
message, and hangs.]

Andrew Tridgell (tridge@nimbus.anu.edu.au) reported (1/29/94) that 

I found with early versions it would work if I used:

   ports { 0x42 }

but that sometimes my machine would crash when it was cycling the
video bios in dosemu. This is because you're allowing the VGA bios to
re-program your clock, which severely stuffs with Linux.

This prompted me to write the readonly and masking patches for dosemu,
which I believe are still in the latest version. I now use:

   ports { readonly 0x42 }

and it boots dosemu more slowly, but more reliably.

Tim Shnaider (tims@kcbbs.gen.nz) also reported (1/18/94) that

One way of fixing this is to use the GETROM program to dump your video
bios to a file and edit the config file in the /etc/dosemu directory
There will be a few video lines.  Here is my video line

   video { vga console graphics chipset trident memsize 1024 vbios_file
   /etc/dosemu/vbios }

where vbios is the file generated by typing 

   getrom > vbios


Section 7:  Problems and fixes
==============================
Q7.1	Why does dosemu lock up after one keystroke?
----------------------------------------------------
(12/17/93)

You need to turn on the keyboard interrupt in the dosemu config file.
Add a line to the config file:

   keybint on


Q7.2	Why does my ethernet driver lock-up dosemu?
---------------------------------------------------
James B. MacLean (jmaclean@fox.nstn.ns.ca) reported (1/16/94) that

If you have Linux networking turned on for your card, it is not
accessible to DOSEMU at this time.  It is also true that the default
dosemu will not get interrupts from the kernel. That said, if you'd
like to give your NIC to dosemu for it to control, maybe for access to
Netware on the network through a NETX client, I do have a driver
(Silly Interrupt Generator) to put in the kernel that any program,
like dosemu can use to get at the interrupt for your NIC.  I use it in
DOSEMU to access a Novell Lite network.  Speed is not it's high point,
but it does seem to work :-).

Any interested parties should E-mail me (jmaclean@fox.nstn.ns.ca) and
I'll pass along some directions.


Q7.3	Why are my keystrokes echoed ttwwiiccee??
-------------------------------------------------
Nick Holloway (alfie@dcs.warwick.ac.uk) reported (2/22/94) that

After running dos after playing with some stty settings, I was getting
doubled key presses.  I can now reveal what the reason is!

It only happens when dos is run on the console with 'istrip' set.  This is
(I think) because the raw scancodes are mutilated by the 'istrip',
so that key release events look like key press events.

So, the input processing needs to be turned off when using the scan
codes on a console (it wouldn't be a good idea to do it for tty lines).


Q7.4	Why does give "divide overflow" errors after running for more
        than 24-hours? 
---------------------------------------------------------------------
(1/17/94)

This is a known bug.  It will (hopefully) be fixed in an upcoming
release.  For now, you can simply exit dosemu and start it again.


Q7.5	Where did the debugging output go?
------------------------------------------

As of dosemu0.49pl4, stderr is automatically redirected to /dev/null.
Try "dos -D+a 2>debug" to turn on debugging information and redirect
it to the file "debug".


Section 8:  Contributing to the dosemu project
==============================================
Q8.1	Who is responsible for dosemu?
--------------------------------------
(2/17/94)

Dosemu is built upon the work of Matthias Lautner and Robert Sanders.
James B. MacLean (jmaclean@fox.nstn.ns.ca) is responsible for
organizing the latest releases of dosemu.

                       History of dosemu

          Version    Date                Person           
         -------------------------------------------------
          0.1        September 3, 1992   Matthias Lautner
          0.2        September 13, 1992  Matthias Lautner
          0.3        ???                 Matthias Lautner
          0.4        November 26, 1992   Matthias Lautner
          0.47       January 27, 1993    Robert Sanders
          0.47.7     February 5, 1993    Robert Sanders
          0.48       February 16, 1993   Robert Sanders
          0.48pl1    February 18, 1993   Robert Sanders
          0.49       May 20, 1993        Robert Sanders
          0.49pl2    November 18, 1993   James MacLean
          0.49pl3    November 30, 1993   James MacLean
          0.49pl3.3  December 3, 1993    James MacLean
          0.49pl4    February 10, 1994   James MacLean


Q8.2	I want to help.  Who should I contact?
----------------------------------------------
The dosemu project is a team effort.  If you wish to contribute,
see the DPR (DOSEMU Project Registry).  A current copy may be found in
dspsun.eas.asu.edu:/pub/dosemu.



