home *** CD-ROM | disk | FTP | other *** search
Received: from sloth.swcp.com (sloth.swcp.com [198.59.115.25]) by nacm.com (8.6.9/8.6.9) with ESMTP id DAA10122 for <executor@nacm.com>; Tue, 29 Nov 1994 03:35:39 -0800 Received: from iclone.UUCP (uucp@localhost) by sloth.swcp.com (8.6.9/8.6.9) with UUCP id EAA19489 for nacm.com!executor; Tue, 29 Nov 1994 04:37:10 -0700 Received: by iclone (NX5.67d/NX3.0M) id AA21879; Tue, 29 Nov 94 04:22:59 -0700 Date: Tue, 29 Nov 94 04:22:59 -0700 From: "Clifford T. Matthews" <iclone!ctm@sloth.swcp.com> Message-Id: <9411291122.AA21879@iclone> Received: by NeXT.Mailer (1.100) Received: by NeXT Mailer (1.100) To: executor@nacm.com Subject: Executor 1.99c is out + FAQ Sender: owner-executor@nacm.com Precedence: bulk Hi Folks, Executor 1.99c is out for NEXTSTEP and Linux. There is no 1.99c for DOS, because the benefits are too slight to make it worth downloading. The major changes are Linux related: We now link with the XFree86 3.1 shared libraries (X11R6) We detect a variety of reasons to not use the SHM extension and back off appropriately We do not allow you to attempt to resize the Executor window In addition, a bug that prevented Executor/NEXTSTEP from printing more than 128 pages at a time under Word has been fixed, and a bug that affects all copies of Executor that prevented a particular type of "transparency" drawing mode from working has been fixed. I had a wonderful time in Chile, I wound up spending more time answering e-mail when I got back than I expected, hence the relatively small number of changes in 1.99c and the missing Appendix A in the FAQ printed below. I'm off to Denver for the week. I'll be working on Appendix A during the day and visiting old friends during the evening. To pick up 1.99c for Linux, you'll need to retrieve ftp.cs.unm.edu:/pub/ardi/Executor_Linux/executorlinux199c.tar.gz (remember to use BINARY mode when you pick it up). To pick up 1.99c for NEXTSTEP, you'll need to retrieve ftp.cs.unm.edu:/pub/ardi/Executor_NEXTSTEP/Executor.gz and ftp.cs.unm.edu:/pub/ardi/Executor_NEXTSTEP/%System.gz (remember to use BINARY mode when you pick up these two files). You'll then need to gunzip both files and replace your current /LocalApps/Executor.app/Executor and /LocalApps/Executor.app/ExecutorVolume/System Folder/%System files, remembering to keep the permissions the same as your current files. --Cliff ctm@ardi.com (e-mail sent to "questions@ardi.com" is handled more promptly) ===================================================================== FAQ for Executor [last updated 94-11-28] This set of answers to Frequently Asked Questions is not designed to take the place of our Executor manual. However, currently our manual is not available on-line, so this FAQ does briefly touch on some issues that are covered more in depth in our manual. In addition to this FAQ, there should be README files associated with the demo versions of Executor and there is also an Executor/DOS document that describes how to get started with Executor/DOS from a DOS user's point of view, which may be useful to users of Executor on other platforms as well. That document is called "ERNSTOUD.TXT", since it's hard to come up with useful names when constrained by the DOS 8.3 filename limits and the author of the document is Ernst J. Oud. [1] Executor in General [1.1] What is Executor? [1.2] On which platforms is Executor available? [1.3] Who makes Executor? [1.4] Pronunciation? [1.5] Does Executor require you to obtain ROMs or System Files from Apple? [1.6] How long has Executor been in development? [1.7] What techniques were used to rewrite the OS and Toolbox [1.8] What limitations does Executor have? [1.9] Does Executor run all applications? [1.10] What do the various Executor version numbers mean? [1.11] Where can I pick up the Executor demos? [1.12] Is Executor shareware? [1.13] How do the demo versions differ from the commercial versions? [1.14] What's next? [1.15] When will 2.0 be out? [1.16] How can I get in ARDI's beta program? [1.17] Does Executor have networking support? [1.18] How do you install Fonts and Desk Accessories (DAs)? [1.19] Will Desk Accessories work under Executor? [1.20] Does E/D run xxx? [1.21] What's the best way to keep informed about Executor? [1.22] Why shouldn't I send e-mail to ctm@ardi.com? [1.23] What is an ".hfv" file? [1.24] Can I launch apps directly from the command line? [2] Executor/DOS [2.1] Which FTP sites will carry stable versions of the E/D demo? [2.2] What are the hardware requirements for Executor/DOS? [2.3] What do I do if my Super VGA card isn't VESA compliant? [2.4] Executor crashes with "GrSetMode ; unknown adapter type in driver." [2.5] Does E/D require an ASPI driver to access SCSI? [2.6] Have you released Executor for OS/2 yet? [3] Executor/Linux [3.1] Can I buy the Linux version now? [3.2] Why can't the Linux version access floppies with option-shift-2 [3.3] Are we ready to hear about Executor/Linux bugs? [3.4] Should bug reports be sent one at a time or in a big list? [3.5] Why is there no Executor for NetBSD or FreeBSD? [3.6] Where are the bitmaps stored on the Linux version of executor? [3.7] Will there be an SVGALIB version of E/L in the future? [3.8] Why do all the non-Executor Windows get creepy colors when Executor is running? [4] Executor/NEXTSTEP This section has not yet been written. [1.1] What is Executor? ------------------------ Executor is a commercial emulator that allows non-Macintosh hardware to run some applications originally written on a Macintosh. Executor has many limitations, see below. [1.2] On which platforms is Executor available? ------------------------------------------------ Executor/DOS (E/D) is an implementation that runs under DOS and Windows. Executor/NEXTSTEP (E/NS) is an implementation that runs under NEXTSTEP, both on original NeXT hardware and Intel based hardware running NEXTSTEP. Executor/Linux is an implementation that runs under Linux, using X-Windows. [1.3] Who makes Executor? -------------------------- ARDI questions@ardi.com Suite 4-101 1650 University Blvd., NE Albuquerque, NM 87102 +1 505 766 9115 Phone +1 505 247 1899 FAX [1.4] Pronunciation? --------------------- Ig-zek'-yu-tor [1.5] Does Executor require you to obtain ROMs or System Files from Apple? --------------------------------------------------------------------------- No. Executor reimplements from scratch the Macintosh Operating System and Toolbox. [1.6] How long has Executor been in development? ------------------------------------------------- Work began in September of 1986. [1.7] What techniques were used to rewrite the OS and Toolbox -------------------------------------------------------------- Entirely clean-room techniques. That is to say none of the Apple ROMs or Apple System File were ever disassembled. Instead ROMlib (the section of Executor that emulates the OS and Toolbox) was written from the manuals "Inside Macintosh", and Tech. notes. That isn't sufficient to get the degree of compatibility that we need, so tests were written and run on Macs to see what a real Mac would do. In addition, we run applications under Executor and when they deviate from how they would behave on a Mac, we take a look at what is going on and fix Executor accordingly. [1.8] What limitations does Executor have? ------------------------------------------- Because the OS and Toolbox have been rewritten from scratch, Executor has many limitations, including no AppleTalk, no sound, no System 7, no INITs, no CDEVs and no Internationalization. Executor can read and write 1.4 Mb Mac formatted floppy disks, but can not format floppies, nor can it read or write 800 Kb floppy disks. E/NS can access the serial ports and can print, E/D and E/L can not. [1.9] Does Executor run all applications? ------------------------------------------ Currently, no. In addition to applications that won't run because they require something that we currently don't support (e.g. System 7), due to our rewriting of the OS and Toolbox, there is room for enough incompatibility that many large programs do not work. For this reason, we make demo versions of Executor available for potential customers to run before purchasing Executor (see below). We are in the process of cataloging what we have tested and will include that as appendix A. [1.10] What do the various Executor version numbers mean? ---------------------------------------------------------- Any 1.x release other than 1.99 is a black and white release. Any release that ends in a lower case letter is technically an "experimental" release. In general, experimental releases are pre-beta or beta releases that will eventually be released with a higher version number. The most recent non-experimental release of Executor/NEXTSTEP is version 1.3. The most recent non-experimental release of Executor/DOS is 1.2. There has not yet been a non-experimental release of Executor/Linux. Currently, with the recent addition of color support to Executor, Executor is experimental for all platforms. We are trying to release new versions for all platforms in lockstep, so 1.99b has roughly the same feature set and bug set under DOS, Linux and NEXTSTEP. Our goal is to put out a new 1.99<x> version each week, but with the holidays and people taking vacations, we are not currently meeting that goal -- we're still making tremendous progress, though. [1.11] Where can I pick up the Executor demos? ----------------------------------------------- As long as they put up with us, the most up to date experimental versions of Executor can be found on ftp.cs.unm.edu in /pub/ardi. However, ftp.cs.unm.edu does not have the bandwidth to accept many simultaneous users, so when we're happy with the stability of one of our color experimental versions, we'll make that version available on the tradtional sites for commercial demos of the given platform. See the platform specific answers for a list of these sites. We don't mind people making our current experimental versions available on other sites, but *please* be sure to include all the READMEs and FAQs which will allow users to find more current versions of Executor as they're released. [1.12] Is Executor shareware? ------------------------------ No. Executor is a commercial program available from ARDI. The demo versions are the only versions that should be found on bulletin boards or FTP sites. If you find a non-limited version of Executor available to download, it was put there illegally. [1.13] How do the demo versions differ from the commercial versions? --------------------------------------------------------------------- The E/D, E/L and E/NS demos are time limited to ten minutes of use. Once your ten minutes are up, you are thrown out, but you can restart the program again and run for another ten minutes if you'd like. In addition, the E/D demo does not allow you to access Macintosh formatted SCSI hard drives. [1.14] What's next? -------------------- Our immediate goal is to get Executor 2.0 out. Back before 1.99 was out, we had a set of goals for what would be in 2.0. We have had enough trouble implementing 32-bit color QuickDraw that we have had to pare some features out of what we had orginally proposed for the 2.0 feature set. Features present in 2.0 are *still* subject to change, but our current plans are to add: A file browser -- we've written one in house. We will be releasing it with source. Better documentation The ability to change the screen "depth" (number of colors that can be present at one time on the screen) and size on the fly. A simpler method for installing fonts and Desk Accessories A better set of demo and utility programs We also have a set of general and platform specific bugs that we need to have fixed before we can freeze 2.0. Beyond 2.0, we want to make Executor compatible with Apple's System 7.5, so you'll be able to purchase a copy of System 7.5, install it on top of Executor and get even more compatibility and features. [1.15] When will 2.0 be out? ----------------------------- The answer here is embarrassing. Our original target was summer of 1994. With the experimental releases coming out regularly, there is a light at the end of the tunnel, but we can't say exactly when it will be. We had some miscommunication with our investors that prevented us from working very efficiently in the spring, summer and fall of 1994. It looks like we've got that cleaned up now. [1.16] How can I get in ARDI's beta program? --------------------------------------------- Our beta program is really boring. The only thing that you get that you can't get over the net is an actual set of floppies that contain installation scripts. As such, we really don't need new beta members. Just pick up the experimental versions and keep us informed. [1.17] Does Executor have networking support? ---------------------------------------------- Currently, no. Nor, will it be available in Executor 2.0. Networking support is planned for release 3.0, but we do not yet have an estimated date of completion for 3.0. The first platform to have networking support built in will probably be Linux. [1.18] How do you install Fonts and Desk Accessories (DAs)? ------------------------------------------------------------ The short answer is "wait for our new file browser that will allow you to install fonts and DAs via drag and drop." However, if you are an old time Macintosh user and you have a copy of Font/DA Mover on a Mac, you can copy the Executor System file over to a Mac, install the Fonts/DAs over there and then bring the System file back to Executor. This is tricky and not for the faint of heart. [1.19] Will Desk Accessories work under Executor? -------------------------------------------------- Currently Desk Accessory support is very weak; most will not run. After we get the browser released that allows easy installation and removal of desk accessories, we'll spruce up our DA code and work on insuring that some of the more popular DAs work. [1.20] Does E/D run xxx? ------------------------- With all the rush to get 2.0 out the door ASAP, we're putting our testing people to work testing new experimental versions, instead of testing 1.2. There is plenty that 1.2 will not run, and as such, we recommend people try out the demo before purchasing Executor. We will be making a list of what runs and what doesn't available as part of this document as Appendix A, but that information is not available in this release of the FAQ. [1.21] What's the best way to keep informed about Executor? ------------------------------------------------------------ Join the Executor mailing list. Send a message to "majordomo@nacm.com". Make sure your subject line is blank and your message body says: subscribe executor yourname@yoursite.yourdomain We try to post important events to the net, and send new release information via U.S. mail to our current customers, but the Executor mailing list is where we post news about our experimental versions and where you can send mail to talk with other people who are using Executor. If you'd rather get the Executor Interest information in a digest form, say "subscribe executor-digest" instead of "subscribe executor" as described above. The digest is a new feature, currently it's made once a day, but that may change. To remove yourself from either mailing list, send a message to majordomo@nacm.com with a body of "unsubscribe executor" or "unsubscribe executor-digest". The Executor Interest mailing list is administered by a volunteer. We do not directly control the list. Lately there has been a request that we operate a mailing list for announcements only. Although we can't provide that right now, we're hoping the digestification will make such a separate list much less needed. [1.22] Why shouldn't I send e-mail to ctm@ardi.com? ---------------------------------------------------- Cliff gets tons of e-mail. E-mail sent to questions@ardi.com is answered much more punctually. [1.23] What is an ".hfv" file? ------------------------------- Executor has the ability to store an entire Macintosh "volume" (i.e. filesystem corresponding to a disk drive or a partition within a disk drive) in a DOS or UNIX file. Under DOS, this feature is very handy because there is no way to have files with long names and upper and lower case characters in their names unless you use a ".hfv" file. [1.24] Can I launch apps directly from the command line? --------------------------------------------------------- Yes. If an app resides within a UNIX or DOS filesystem, you can specify the name of the app, and documents that you would like the app to open when it starts up, on the command line. In 1.99c, the license info is still printed, and must be dismissed by clicking on the "OK" button, or typing a RETURN. We know this is annoying and will be fixing it so that once you've read the license you won't have to see it again until you ask to see it explicitly. Apps that reside in ".hfv" files can't currently be launche from the command line. This will change soon. [1.25] What are all the command line switches? ----------------------------------------------- Switch Min Max Default Default when switch is present, but with no value specified macbpp 1 8 4 8 realbpp 1 8 4 8 refresh 0 60 0 10 shadow 0 1 0 1 nosplash 0 1 0 1 debug 0 10 0 10 noclock 0 1 0 1 noint8 0 1 0 1 drivecheck 0 1 0 1 nomouse 0 1 0 1 applzone 128 8192 1024 2048 syszone 128 4096 512 1024 stack 64 4096 256 128 nativecode 0 1 1 1 The switches macbpp, realbpp, refresh and shadow all affect how the screen is emulated. The number of bits per pixel that the program running under Executor sees is specified by macbpp. If macbpp is set to 1, then there are only two "colors" (black and white) available. If it is set to 8, two hundred fifty six colors are available. The switch realbpp specifies how many bits per pixel the display is actually configured to show to you. In general, you want these two switches to be given the same value. When Executor first starts up, a "splash screen" is printed. You can omit this splash screen with the nosplash switch. Sometimes Executor detects potential errors that may be useful for us to see when we try to figure out why a given program won't run under Executor the debug option controls the printing of these error messages. One of the hardest things to emulate properly is the internal timing mechanisms of a Macintosh. Sometimes it is desirable to turn off our clock emulation. Both noclock and noint8 do this, although in slightly different ways. When Executor displays a standard "get" or "put" dialog box, there is a button marked "drive" that allows you to cycle through the Macintosh volumes that Executor knows about. You can use the drivecheck switch to have Executor examine your DOS drives each time you click the "drive" button. In general, this is more annoying than it is useful. Although Executor is almost totally useless without a mouse, Executor/DOS can be started without a mouse if you use the nomouse switch. If you don't use that switch and you don't have a mouse, Executor/DOS will politely tell you that you can't run Executor. The switches applzone, syszone and stack control how much memory is allocated to the application, the system, and the application stack. In general, if you have more memory, you should override the default applzone and allow Executor to use more memory. Executor 1.99<x> uses a new "synthetic CPU" which is much faster than the synthetic CPU in previous releases of Executor. The speed increase is due to our use of native code. However, like anything that is new, there's a chance that our improvement has some hidden drawbacks. You can turn off the use of native code by specifying nativecode 0. Here is an example of some of those switches: executor -applzone 4096 -noclock -nativecode 0 That would allocate 4 Mb of memory for the applications use, turn off our clock emulation and revert to a slower type of synthetic CPU emulation -- an unlikely combination of switches. [1.26] Can I have Executor use more than 8Mb for the application zone? ----------------------------------------------------------------------- Currently, no. We are reorganizing our memory layout to allow you to do this in the future. [2] Executor/DOS ================= [2.1] Which FTP sites will carry stable versions of the Executor/DOS demo? --------------------------------------------------------------------------- Currently the most recent "stable" version of Executor/DOS is 1.2. That version is black and white and doesn't run as much software as 1.99b does. However, 1.99b is just a little too rough to put out for general inspection, so we're waiting for 1.99d or greater before we put a color version on the SimTel mirrors. E/D is available from the SimTel mirrors. The primary SimTel mirror is oak.oakland.edu, and you can find the Executor/DOS demo within the "SimTel/msdos/emulator" directory. It comes in four pieces: exctr12?.zip where ? represents the letters a,b,c and d. Other SimTel mirrors are: St. Louis, MO: wuarchive.wustl.edu (128.252.135.4) /systems/ibmpc/msdos Corvallis, OR: archive.orst.edu (128.193.2.13) /pub/mirrors/simtel/msdos Australia: archie.au (139.130.4.6) /micros/pc/oak England: src.doc.ic.ac.uk (146.169.2.10) /pub/packages/simtel Finland: ftp.funet.fi (128.214.248.6) /pub/msdos/SimTel France: ftp.ibp.fr (132.227.60.2) /pub/msdos Germany: ftp.uni-paderborn.de (131.234.2.32) /SimTel/msdos Hong Kong: ftp.cs.cuhk.hk (137.189.4.57) /pub/simtel/msdos Israel: ftp.technion.ac.il (132.68.1.10) /pub/unsupported/dos/simtel Poland: ftp.cyf-kr.edu.pl (149.156.1.8) /pub/mirror/msdos Sweden: ftp.sunet.se (130.238.127.3) /pub/pc/mirror/SimTel/msdos Switzerland: ftp.switch.ch (130.59.1.40) /mirror/msdos Taiwan: NCTUCCCA.edu.tw (140.111.1.10) /PC/simtel Thailand: ftp.nectec.or.th (192.150.251.32) /pub/mirrors/msdos If you have AFS, you can pick up Executor/DOS demo 1.2 by changing directories to /afs/umich.edu/group/itd/archive/msdos/emulators/macintosh. [2.2] What are the hardware requirements for Executor/DOS? ----------------------------------------------------------- For Executor/DOS 1.2 you need a '386 or better, VGA, 7 Mb disk space, a 3.5" 1.44 Mb floppy drive, and 4 Mb RAM. A SCSI Controller is needed only if you want to access external Macintosh hard disks or PowerBooks. Executor/DOS 1.99<x> should work in sixteen colors on any VGA, although we do not have the facilities to test more than a few in house. In addition, if you have a Super VGA that is "VESA compliant", Executor/DOS should be able to provide 256 colors. [2.3] What do I do if my Super VGA card isn't VESA compliant? -------------------------------------------------------------- There is a shareware SVGA utility that provides VESA compliance for SVGA cards that normally are not VESA compliant. At the time this FAQ was last modified, univbe50.zip was the most recent release of this extender. It is not a product of ARDI, but as a convenience to people picking up experimental versions of Executor, the file univbe50.zip is available in ftp.cs.unm.edu:/pub/ardi/Executor_DOS. If you use it, you should pay the shareware fee as described in the documentation included in the zip file. If you have a recent SVGA card you probably don't need univbe. There may be a more recent version of univbe in oak.oakland.edu:/SimTel/msdos/graphics. [2.4] Executor crashes with "GrSetMode ; unknown adapter type in driver." -------------------------------------------------------------------------- 1.99b has problems when Microsoft's display.sys driver is in config.sys. We are in the process of updating the code that has this problem and expect a fix soon. In the meantime, you must remove display.sys from the config.sys section you use when you're using Executor/DOS. [2.5] Does E/D require an ASPI driver to access SCSI? ------------------------------------------------------ If your SCSI drivers patch the "INT 13" BIOS calls, then an ASPI driver is not needed. As long as "INT 13" can allow Executor to read a SCSI drive, there is no need to use ASPI. [2.6] Have you released Executor for OS/2 yet? ----------------------------------------------- We plan on making an OS/2 specific version of Executor, but only after we get Executor 2.0 shipping [3] Executor/Linux =================== [3.1] Can I buy the Linux version now? --------------------------------------- (Technically, our software is licensed, not sold) Not yet (as of November 23), but soon we'll start licensing the experimental versions so that you won't have the time limit interrupting you. [3.2] Why can't the Linux version access floppies with option-shift-2 ---------------------------------------------------------------------- (like the DOS version does)? ----------------------------- Oversight on our part. Executor/Linux 1.99b and 1.99c were rushed out the door so that folks could get a peek at it and contribute suggestions while we were in the process of polishing it up. This should be fixed soon. [3.3] Are we ready to hear about Executor/Linux bugs? ------------------------------------------------------ Yes. Send them to "bugs@ardi.com" and make sure that you identify what version of Executor you're running (i.e. Executor/Linux 1.99b) as well as what kernel and X-Windows you're using. Please mention what Mac software you were running when you encountered the bug and explain whether the bug is reproducible or not. If Executor provides some sort of debug output, please include that as well. Our NEXTSTEP version has a bug-sending facility that automatically fills in all that information for you. If we get some time, we'll incorporate that code into Executor/Linux. [3.4] Should bug reports be sent one at a time or in a big list? ----------------------------------------------------------------- In general, it's easier for *us* if you send them one at a time. Internally we use "gnats", a free bug-tracking tool and we need to separate each bug into a single file for tracking. On the other hand, since by providing us with bug reports you're helping us out, we won't refuse bug reports that are collections. [3.5] Why is there no Executor for NetBSD or FreeBSD? ------------------------------------------------------ We don't currently have the manpower to support it. The Linux release is a byproduct of the fact that we use Linux in house. It's also a very rough release. After we've cleaned up the Linux version and get some Executor/Linux sales, we'll look into the feasibility of Executor for NetBSD and FreeBSD. [3.6] Where are the bitmaps stored on the Linux version of executor? --------------------------------------------------------------------- All versions of executor maintain an internal bitmap corresponding to the actual screen. We accrue a "dirty rect" as the program draws to what it thinks is the screen via Executor's QuickDraw implementation. We periodically update the _real_ screen (e.g., the X window) by transferring the dirty rect across. So basically our graphics interface to the host machine consists of nothing more than blitting rectangles to the screen, which aids our portability. Under X, we use shared memory extensions for speed, but we don't do anything fancy like trying to cache Mac fonts on the X server side. Spending time trying to do so would be a bad idea for a number of reasons I won't go into. "Refresh" mode is useful when the program directly manipulates the frame buffer itself. In this mode, we periodically analyze the internal screen memory to decide what has been changed, and transfer the changed data to the real screen. [3.7] Will there be an SVGALIB version of Executor/Linux in the future? ------------------------------------------------------------------------ Probably. Executor/Linux would clearly get a major performance benefit from an SVGALIB implementation. We are in the process of rewriting our graphics and event handling code so that it will be easy to add this sort of capability, but we don't yet have a timetable for doing so. [3.8] Why do all the non-Executor Windows get creepy colors when Executor -------------------------------------------------------------------------- is running? ----------- Currently Executor requests a "private color map" so that it can get allocate display colors that are as close to what the Mac program has requested as possible. It is possible for us to make an approximation that will be good enough for many applications to run and not make all the other colors look so bad. We'll be doing this in a future version. 
