Macintosh-Tools/executor
1
0
Fork 0
mirror of https://github.com/ctm/executor.git synced 2026-01-22 19:16:21 +00:00
Code Issues Projects Releases Wiki Activity

All the Executor source as-is from the subversion tree it was last worked on.

Browse Source
This commit is contained in:
Clifford T. Matthews
2008-10-05 21:48:37 -06:00
commit 3183eb6ea0
2517 changed files with 441747 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

251
opt/man/man1/executor.1 Normal file
View File

@@ -0,0 +1,251 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH EXECUTOR 1 "April 10, 1998" "Executor 2.0v"
.SH NAME
executor, executor-svga, executor-demo, executor-svga-demo \- Run Macintosh applications
.SH SYNOPSIS
.B executor
[options]
[mac-application [document1] [document2 ...]]
.SH COPYRIGHT
.if n Executor is Copyright (C) 1986 - 1998 by Abacus Research & Development, Inc.
.if t Executor is Copyright \(co 1986 - 1998 by Abacus Research & Development, Inc.
.SH DESCRIPTION
.B Executor
runs many \fBMacintosh\fR applications. It neither contains, nor
requires any code from Apple Computer. That makes
.B executor
a very complex piece of software and it also introduces many
limitations.
.B Executor
does not run Apple's Finder, nor any INITs or CDEVs. Facilities newer
than System 7.0 (like QuickTime) are not currently available and even
some System 7.0 features are not present.
.B Executor
has some sound support, very little serial port support and no
networking support. Executor's font management and printing
capabilities are not as sophisticated as those on a modern Macintosh.
Hardware limitations of the PC floppy controller prevent the use of
floppies formatted at 800K. Some programs which use undocumented or
misdocumented features will fail under
.B executor.
.PP
.B Executor
is the \fBonly\fR Macintosh emulator available for any platfrom that does not require copying ROMs from
a Macintosh (a practice that is usually illegal).
.PP
Some of the better known applications that people use
.B executor
for include \fIMicrosoft Word 5.1\fP, \fIMicrosoft Excel 4.0\fP,
\fIQuicken 6.0\fP for the Macintosh, \fINIH Image\fP and tons of
games. A compatibility database and much more information is
available on our web-site (<http://www.ardi.com>).
.SH "SVGA VERSION"
.B Executor
is supported as an X application. In addition to the X version, the binary
.B executor-svga
is an svgalib application. This version is not officially supported and
will eventually be supplanted by either an X version that uses DGA, or a GGI
version or both.
.SH "DEMO VERSION"
The binaries
.B executor-demo
and
.B executor-svga-demo
are demo versions which can be used for 30 days to determine the suitability
of
.B executor
to your specific needs. In addition to only being able to be used for 30
days before expiring, the demo versions also have a few other limitations:
all pages printed will have "Demo" written on them; Macintosh formatted
media can be read but not written; and Command-Key equivalents are not
supported.
.SH OPTIONS
The
.B \-help
option causes Executor to print a list of available options and a
brief description of each option.
.SH ARGUMENTS
If there isn't an argument after the options, Executor will run
"Browser", ARDI's substitute for Apple's Finder. Browser isn't
particularly clever, but will at least do a good job of keeping
AppleDouble files consistent when they're moved or renamed. We have
limited resources, so we've put almost all our engineering effort into
rewriting the Mac OS OS and toolbox calls instead of improving our browser.
At some point we hope to integrate sufficiently well into the various
Linux desktop managers that we will be able to do away with our browser
entirely.
.PP
If there is another argument after the options, it's used as the name
of the Macintosh application to run. This can either be a UNIX
pathname (e.g.
"/tmp/Adobe Illustrator%A8 7.0 Tryout/Adobe Illustrator%A8 7.0 Tryout")
or a Macintosh path name (e.g. "Demo:Swivel Applications:SwivelPro 2.0.4").
Further arguments after the application name are interpreted as documents
that the Macintosh application should open when it is started.
.SH "BUILT-IN F-KEYS"
.TP
.B Cmd-Shift-1
brings up an "About Box" that lists the Executor version number, the
number
of days left in the demo, the total amount of emulated RAM available,
the amount of System RAM consumed, the amount of Application RAM
consumed, and five buttons. The buttons allow you to see the License
under which you may run
.B executor,
the details of
.B ARDI,
credits, and the tips file
(randomly sorted). The forth button dismisses the "About Box".
.TP
.B Cmd-Shift-2
tells Executor to re-examine /dev/fd0 and /dev/cdrom for Macintosh
media. It's imperative that you never remove Mac-formatted media
while Executor is running unless you have already clicked on an
"Eject" button or chosen an "Eject" menu option and had Executor
acknowledge that it's acceptable to remove your Macintosh formatted media.
.TP
.B Cmd-Shift-3
dumps the screen to a file.
.TP
.B Cmd-Shift-5
brings up the "Preferences Panel" which allows you to alter some
.B Executor
parameters and save the changes for later on a per-application basis.
This is especially important if you want to run applications that
require a System version greater than 6.0.7.
.TP
.B Cmd-Shift-6
tells
.B Executor
that when you quit the currently running application that you don't
want to return to the Browser.
.TP
.B Cmd-Shift-7
requests
.B executor
to repaint the screen. This should never be necessary.
.SH ENVIRONMENT
.TP
.B ConfigurationFolder
the directory where per-application configuration files are saved. These are
the files that are created when you click on the "Save" button of the
"Preferences" panel that comes up when you type Cmd-shift-5. The default
value is "/var/opt/executor/share/conf".
.TP
.B SystemFolder
the Macintosh name of the folder which contains the System file. The System
file can be stored in an HFV or in an Apple-Double file. The default is
for
.B SystemFolder
to be "System:System Folder" with System being part of the HFV
"/var/opt/executor/exsystem.hfv".
.TP
.B PublicDirectoryMap
is the root name of the database, shared with other Executor users, that maps i-numbers
to names. This is needed, because unlike under UNIX, Macintosh applications
can look up directories by number. The default is
"/var/opt/executor/directory_map". The suffix "-le.db" is added to
the
root name.
.TP
.B PrivateDirectoryMap
is the root name of the private database that maps i-numbers to names. The default is
"~/.executor/directory_map".
.TP
.B DefaultFolder
is the folder that will be displayed whenever the running Macintosh application
brings up a standard get or put dialog box. The default is "/home/executor".
.TP
.B MacVolumes
This variable tells
.B executor
where it should look for Macintosh volumes. Directories listed in
MacVolumes will automatically be scanned for HFVs. MacVolumes is
delimited
by semi-colons (";"). The volume which
contains the System file must be first in any MacVolumes list. The
default value is "/var/opt/executor/exsystem.hfv;/var/opt/executor".
As such, any HFV created in /var/opt/executor will automatically be
opened when Executor runs.
.TP
.B ScreenDumpFile
When you type Cmd-Shift-3,
.B executor
creates a TIFF file containing a dump of the
.B executor
screen. The default value is "/tmp/excscrn*.tiff". The "*" tells
.B executor
where to place an integer (starting with 0) to make the file unique.
In other words, if the files "/tmp/exscrn0.tiff" and
"/tmp/exscrn1.tiff" already exist when a Cmd-Shift-3 is typed,
.B executor
will write its dump into "/tmp/exscrn2.tiff".
.TP
.B PrintersIni
is the name of the file that contains the options of the printing
subsystem. The default is "/opt/executor/printers.ini".
.TP
.B PrintersDef
is the name of the file that contains the most recently used printer
options. The default is "/var/opt/executor/printdef.ini"
.SH BUGS
Executor is complex and the man pages are new. They omit many details.
.PP
.B Executor
works by using the facilities of
.B ROMlib,
a rewrite of the MacOS OS and toolbox calls. ROMlib was created from
publicly available documentation, but documentation isn't always
correct. If an application relies on undocumented or misdocumented
features of the MacOS, the application may fail under Executor. One
way in which Macintosh applications may fail is by referencing memory
that is not available.
.B Executor
does not currently trap stray memory
accesses; they cause
.B executor
to dump core.
.SH "SEE ALSO"
\fIAppleDouble\fP(5),
\fIdirectory_map\fP (5),
\fIecf\fP(5),
\fIhfv\fP(5),
\fIprinters.ini\fP(5),
.SH FILES
/opt/executor/splash - the directory that contains the splash screen
that
.B executor
presents as it is coming up. You can disable the splash screen by
removing the files in this directory. We have not yet released a tool
to allow people to build their own splash screens.
/opt/executor/tips.txt - a text file containing a collection of useful
tidbits that you can read when using Cmd-Shift-1.
/var/opt/executor/share/home - true location of /home/executor (which
is
just a symlink).
/home/executor - convenient place to store Macintosh files.
/dev/fd0, /dev/cdrom - floppy drive and CD-ROM drive that are examined
for Macintosh media when
.B executor
is first started and when Cmd-Shift-2 is typed.
/dev/cua0 - serial line that may be accessed when Macintosh programs
try to use the serial ports. Serial port access is very weak and will
continue to be weak, even in release 2.1.
.SH DISCLAIMER
Executor is a registered trademark of Abacus Research and Development,
Inc. Macintosh is a registered trademark of Apple Computer, Inc.
(Those are two separate companies; please don't confuse the two.)

57
opt/man/man5/AppleDouble.5 Normal file
View File

@@ -0,0 +1,57 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH AppleDouble 5 "April 10, 1998" "Executor 2.0v"
.SH NAME
AppleDouble \- File format Executor uses to store individual Macintosh files on non-Macintosh filesystems
.SH DESCRIPTION
AppleDouble is a specification that allows storing Macintosh files on
non-Macintosh filesystems.
.PP
In Macintosh parlance, files have two
"forks". Each fork is effectively an independent file that can be
grown or shrunk without affecting the other fork. The "resource fork has a
pre-defined order built into it. The "data" fork doesn't. In
addition to these two forks, each file has extra meta-data that isn't
available under UNIX filesystems, including things like the file
"type" and file "creator".
.PP
AppleDouble format uses two UNIX files for each Macintosh file. One
file contains the data fork, the other file contains the
meta-information and the resource fork. The resource fork filename
has a "%" prepended to it to denote the resource fork. Unfortunately,
special characters in the filename are represented by using "%xx"
where xx is the hexadecimal representation of the ASCII value of the
special character. This leads to an ambiguity. Is "%father" a data
fork whose first character is 0xfa, with the remaining characters
being "ther", or is it the resource fork for the file named "father"?
.PP
The Apple spec says that programs should look inside AppleDouble files
to disambiguate. Consequently, although ARDI does, very few companies
actually implement AppleDouble according to the Apple specification.
Consequently,
.B executor
won't work with non-conforming files, like those produced by
netatalk. Technically, there's an option to allow
.B executor
to use AppleDouble files using the netatalk naming variation, but
there have been other bugs in netatalk's AppleDouble implementation that
prevented this from being useful. As Executor/Linux becomes more
popular, we'll take the time to work out the bugs on both netatalk's
and
.B executor's
side and then switch to using netatalk conventions as the default
behavior. This will be convenient for people who are running
.B executor
on machines that also provide filesystems to Macs via netatalk.
.PP
Apple's specification for AppleDouble is probably available on their
web-site.
.SH FILES
/home/executor - a symlink to /var/opt/executor/share/home
/var/opt/executor/share/home - good place to store AppleDouble files
.SH "SEE ALSO"
\fIexecutor\fP(1)

30
opt/man/man5/directory_map.5 Normal file
View File

@@ -0,0 +1,30 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH directory_map 5 "April 10, 1998" "Executor 2.0v"
.SH NAME
directory_map \- Executor database for mapping i-numbers to names
.SH DESCRIPTION
Macintosh filesystems give the programmer the ability to look up
directories by number rather than by name.
.B Executor
needs to provide the same functionality to Macintosh applications. So
when representing Macintosh on UNIX filesystems, it's necessary to
keep a map from UNIX filesystem and i-number to pathname.
.PP
.SH FORMAT
The format of the map is not publicly documented.
.SH FILES
/var/opt/executor/directory_map-le.db - the directory map that is shared
by all
.B executor
users on little-endian machines (e.g. 80x86 compatibles).
/var/opt/executor/directory_map.db - the directory map that is shared by all
.B executor
users on big-endian machines (e.g. NeXTstations).
.SH "SEE ALSO"
\fIexecutor\fP(1)

28
opt/man/man5/ecf.5 Normal file
View File

@@ -0,0 +1,28 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH ecf 5 "April 10, 1998" "Executor 2.0v"
.SH NAME
ecf \- Executor ".ecf" configuration file format
.SH DESCRIPTION
In
.B executor,
the Cmd-Shift-5 key sequence brings up a preference panel that allows
you to alter Executor's behavior. If you click on the "Save" button
from within that panel, the settings of that panel will be saved in a
file whose name is the hexadecimal representation of the file creator
of the currently running Macintosh program, with the suffix ".ecf"
added.
.PP
The format of this file isn't publicly documented, but it's a text
file, so brave souls can edit the files, but
.B executor
considers these files as machine generated and doesn't report syntax
errors
in any useful manner.
.SH FILES
/var/opt/executor/share/conf - the directory where configuration files are stored by default
.SH "SEE ALSO"
\fIexecutor\fP(1)

23
opt/man/man5/hfv.5 Normal file
View File

@@ -0,0 +1,23 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH hfv 5 "April 10, 1998" "Executor 2.0v"
.SH NAME
hfv \- File format Executor uses to store Macintosh HFS volumes on
non-Macintosh filesystems
.SH DESCRIPTION
An HFV file is nothing more than an image copy of a Macintosh HFS
volume. HFVs can be manipulated by mounting them as HFS
filesystems (part of the 2.1.x kernel) using the loopback device, or
by using Rob Leslie's HFS manipulating tools
<http://www.mars.org/home/rob/proj/hfs/>.
.SH BUGS
.B Executor
doesn't yet support HFS+ volumes.
.SH FILES
/var/opt/executor/exsystem.hfv - This HFV used to contain the "System Folder".
.SH "SEE ALSO"
\fIexecutor\fP(1),
\fIAppleDouble\fP(5)

12
opt/man/man5/printers.ini.5 Normal file
View File

@@ -0,0 +1,12 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH printers.ini 5 "April 10, 1998" "Executor 2.0v"
.SH NAME
printers.ini, printdef.ini \- format for Executor printer configuration files
.SH DESCRIPTION
.SH FILES
.SH "SEE ALSO"
\fIexecutor\fP(1)

27
opt/man/man7/ExecutorVolume.7 Normal file
View File

@@ -0,0 +1,27 @@
.\" (c) 1998 by Abacus Research & Development, Inc. (ARDI)
.\"
.\" This man page is part of the commercial Executor package available
.\" from ARDI <http://www.ardi.com/>.
.TH EXECUTORVOLUME 7 "April 10, 1998" "Executor 2.0v"
.SH NAME
ExecutorVolume \- Description of the Executor hierarchy
mention that /home/executor is a symlink to /var/opt/executor/share/home
mention the fact that System Folder is usually located in
/var/opt/executor/exsystem.hfv
mention the DefaultFolder environment variable
.I Demoware
.I Freeware
.I Shareware
.SH SEE ALSO
.BR executor (1),
.BR AppleDouble (5),
.BR hfv (5)

44
opt/printers.ini Normal file
View File

@@ -0,0 +1,44 @@
# This file is used by Executor to determine which printer options the
# end-user should be presented with in the print dialog boxes.
#
# You can use a leading '#' to begin a comment.
# Don't change the keywords inside [].
#
# In general you should not modify this file unless you know exactly what you
# are doing and even then you should save a copy before you begin editing.
# Port isn't needed for Linux
[Port]
# We comment out all but the common papers sizes.
[Paper Size]
Letter=612 792
# Tabloid=792 1224
# Ledger=1224 792
Legal=612 1008
# Executive=540 720
# A3=842 1190
A4=595 842
# A5=420 595
# B4=729 1032
# B5=516 729
# Filter isn't needed for Linux
[Filter]
# The [Printer] entry "PostScript File" is a
# special entry that is recognized directly by Executor. All others
# are command lines
[Printer]
Default=lpr
# at ARDI we have 2 printers, one that is on beaut, a machine that runs
# Linux around the clock, another that is on uni, a machine that sometimes
# runs Linux and sometimes runs Windows 95. The following three (commented
# out) lines are what we use to route Executor directly to the right place
# Deskjet on Beaut=lpr -Pbeautlp
# LaserJet Linux=lpr -Punilp
# LaserJet Win95=lpr -Puni95lp
GhostView=ghostview -
PostScript File=/tmp/execout*.ps

46
opt/tips.txt Normal file
View File

@@ -0,0 +1,46 @@
Do not remove floppy disks or CD-ROMs from their drives while Executor
is running unless you have clicked on an "Eject" button and Executor
has told you that it's OK to remove it. Changing removable media
behind Executor's back will cause Executor to crash, just like pushing
a paper-clip into a Macintosh floppy drive and changing floppies
without the Macintosh knowing will cause a Macintosh to crash.
Use the "Alt" key on the left side of your keyboard as a Macintosh
command key.
Use the "Alt" key on the right side of your keyboard as a Macintosh
option key.
If a program claims that it needs System 7 to run, use Cmd-Shift-5 to
bring up the preferences panel. You can then alter which version of
the System Executor emulates. More details are available on pages 19
and 23 of the Executor 2 manual.
When using the Windows or Linux version of Netscape, make sure you
hold down the shift key whenever you click on a link to retrieve
Macintosh software. If you don't hold the shift key down, Netscape
will try to help you out by converting the file as it brings it
across. However, this conversion makes the resultant file unusable by
Executor. Holding down the shift key tells Netscape to bypass the
conversion process.
Cmd-Shift-3 causes Executor to create a TIFF screen dump.
These tips are stored in the text file /opt/executor/tips.txt.
You can use a text editor to delete tips that you've already memorized.
After purchasing Executor, send your registration card in. That will
entitle you to discounts on future major upgrades to Executor (minor
upgrades are available for free).
ARDI's web site is <http://www.ardi.com/>. Experimental versions of
Executor are made available there periodically.
ARDI offers services to makers of Mac-only software that allows them to
bundle an application-specific version of Executor with their
software. This is a convenient way to allow them to sell their
software to clients who only have PCs.
If you would like fewer choices in the "Page Setup..." dialog box, you
can edit the file printers.ini to remove entries that correspond to printers
that you don't have.