RPC, embedding, UX, and Macintosh integration

Call, data, and transport layers

Genera RPC separates three concerns that are often collapsed in descriptions of MacIvory:

1. A call layer names a remote module and version, chooses an entry, returns multiple values, and represents remotely signalled errors.
2. A data layer serializes typed values. The public manuals identify the network form as RPC version 2 with XDR; this corresponds to RFC 1057 and RFC 1014. RPC moves values, not live Lisp object references.
3. A transport-agent layer carries calls over an embedded/shared-memory channel, serial or reliable serial channel, a generic stream, Chaosnet, TCP, UDP, or a dummy test agent. Programs query the agent rather than bake one transport into their interfaces.

DEFINE-REMOTE-MODULE, DEFINE-REMOTE-ENTRY, DEFINE-REMOTE-TYPE, and DEFINE-REMOTE-ERROR are the principal Lisp definition forms. A module declares its number, version, client/server languages, and entries. The generators can emit C declarations and client/server material as well as Lisp call machinery. The predefined type layer covers signed and unsigned cardinal widths, booleans, characters, strings, vectors, opaque bytes, lists, alternatives, structures, enumerations, members, bits, and single floats.

Installed RPC documentation names 22 predefined remote types: INTEGER-32, BOOLEAN, OPAQUE-BYTES, PASCAL-STRING, ENUMERATION, C-STRING, STRING, SPREAD-VECTOR, OR, VECTOR, STRUCTURE, MEMBER, LIST, SINGLE-FLOAT, BIT, CARDINAL-4, INTEGER-16, INTEGER-8, CHARACTER-8, CARDINAL-8, CARDINAL-16, and CARDINAL-32. The package also exports lower-level octet-structure field types; those are implementation and code-generation tools, not additional claims about the documented portable remote type set.

System composition and platform branches

The RPC declaration loads call runtime and server first; then generic agent, STD agent, stream agent, an Emb-Agent only for :imach, bulk transfer, error codes, and final initialization. When IP-TCP is available it additionally loads port mapping, Yellow Pages/NIS, authentication, TCP and UDP agents, and UNIX name lookup from the NFS tree. This explains why RPC is not synonymous with network RPC: the same call layer also serves local coprocessor embedding.

RPC Development supplies Utilities, Remote-type, Type-definitions, Remote-call-defs, Remote-Call, Trace, Dummy-Agent, and Reliable-stream. A conditional rpc-c branch adds a C testing subsystem. Keeping runtime and development systems separate lets a delivered world retain generated calls without every macro, generator, trace utility, and example.

Wire registrations and remote-system identities

The source declares :RPC and :RPC-LITTLE-ENDER over the generic :BYTE-STREAM medium. With IP/TCP, the registered TCP ports are 6259 for :RPC and 6257 for :RPC-LITTLE-ENDER; the UDP agent registers corresponding simple-RPC ports. Chaosnet uses contact name RPC with protocol :RPC-BIG-IN-LITTLE-BYTES. The names describe byte ordering at the transport boundary; they do not create a new application-level call model.

Agent-visible remote-system types include :MACINTOSH for the embedded Mac, :UNIX42 for UX-family UNIX services, and :LISPM for a peer Lisp machine. Error-number translation and conditional behavior use those identities. The UX-only C surface also exposes RPCAgentFileDescriptor, allowing a host event loop to integrate an RPC agent's descriptor.

Network RPC defaults and name lookup

The network agent supports port mapping, UDP and TCP, deferred/future calls, and null, UNIX, or DES authentication. The inspected defaults are measured in sixtieths of a second:

The UNIX name-lookup layer can consult the Genera namespace, Yellow Pages/NIS, the password and group files, and the hosts file. The exact twenty host or user properties are:

RPC-USE-YELLOW-PAGES, RPC-UDP-CONNECTION-IDLE-TIMEOUT, RPC-UDP-CALL-RETRANSMIT-TIMEOUTS, RPC-UDP-CALL-TIMEOUT, YP-DOMAIN-NAME, YP-DOMAIN-SERVER, RPC-USE-FILE, RPC-USE-NAMESPACE, RPC-USE-HOSTS-FILE, RPC-PASSWD-FILE, RPC-GROUP-FILE, RPC-HOSTS-FILE, RPC-HOST-UID, RPC-UID, RPC-HOST-GID, RPC-GID, RPC-GIDS, RPC-HOST-GIDS, RPC-HOST-HOMEDIR, and RPC-HOMEDIR.

Default pathnames are /etc/passwd, /etc/group, and /etc/hosts. The global use switches are enabled, while the low-level source defaults namespace lookup and NIS to true, file lookup to false, and hosts-file lookup to false. Installed documentation says file lookup defaults true; loading NFS Common changes the default file switch to true. This is a load-order-sensitive source/documentation difference, not a reason to choose one statement as universally correct.

Complete external RPC package surface

The following is the complete 192-symbol external interface declared by the inspected package file, in declaration order. Group names are analytical; the ordering and symbols are source facts. “External” means callable or nameable by another package, not that every symbol is a supported end-user API in every release.

Definition and control (1–10): DEFINE-REMOTE-MODULE, DEFINE-REMOTE-ENTRY, DEFINE-REMOTE-TYPE, DEFINE-REMOTE-ERROR, DEFINE-REMOTE-C-PROGRAM, DEFINE-REMOTE-ERROR-NUMBER, RPC-VALUES, RPC-ERROR, TYPE-ERROR, PARSE-MACRO-OPTIONS.

Type protocol (11–20): REMOTE-TYPE-FIXED-SIZE, REMOTE-TYPE-SIZE-EXPRESSION, REMOTE-TYPE-SEND, REMOTE-TYPE-SEND-MULTIPLE, REMOTE-TYPE-SEND-MULTIPLE-TRANSLATED, REMOTE-TYPE-RECEIVE, REMOTE-TYPE-PREPROCESS, REMOTE-TYPE-FREE, REMOTE-TYPE-FREE-MULTIPLE, REMOTE-TYPEP.

Codec and language (21–44): SEND-WORD, SEND-WORDS, SEND-WORD-VECTOR, SEND-BYTE-VECTOR, SEND-CHAR-VECTOR, SEND-BIT-VECTOR, SEND-HALFWORD-VECTOR, SEND-SIGNED-BYTE-VECTOR, SEND-SIGNED-HALFWORD-VECTOR, SEND-NIBBLE-VECTOR, SEND-SINGLE-FLOAT-VECTOR, RECEIVE-WORD, RECEIVE-WORD-VECTOR, RECEIVE-BYTE-VECTOR, RECEIVE-CHAR-VECTOR, RECEIVE-BIT-VECTOR, RECEIVE-HALFWORD-VECTOR, RECEIVE-SIGNED-BYTE-VECTOR, RECEIVE-SIGNED-HALFWORD-VECTOR, RECEIVE-NIBBLE-VECTOR, RECEIVE-SINGLE-FLOAT-VECTOR, TYPE, ORIGINAL-TYPE, LANGUAGE.

Agents (45–56): *DEFAULT-TRANSPORT-AGENT*, EMBEDDED-AGENT-P, NETWORK-AGENT-P, AGENT-CONNECTED-P, OPEN-SERIAL-AGENT, OPEN-TCP-AGENT, OPEN-CHAOS-AGENT, OPEN-DUMMY-AGENT, CLOSE-AGENT, REMOTE-HOST, REMOTE-SYSTEM-TYPE, *SERVER-DEBUG-FLAG*.

Tracing (57–59): DISABLE-RPC-TRACE, ENABLE-RPC-TRACE, SHOW-RPC-TRACE.

Predefined exported types (60–75): INTEGER-32, INTEGER-16, INTEGER-8, CARDINAL-32, CARDINAL-16, CARDINAL-8, CARDINAL-4, SINGLE-FLOAT, STRING, PASCAL-STRING, C-STRING, CHARACTER-8, OPAQUE-BYTES, SPREAD-VECTOR, OR, STRUCTURE.

C generation (76–85): DECLARE-C-VARIABLE, DECLARE-C-TYPE, LISP-NAME-TO-C-NAME, C-NAME-TO-LISP-NAME, *C-DECLARATIONS*, *C-TYPEDEFS*, COLLECT-C-DECLARATIONS, *KNOWN-LANGUAGES*, PARENTHESIZE-C-EXPRESSION, WRITE-C-TOKEN-LIST.

Octet structures (86–123): BYTE-SWAPPED-8-AREF-16, BYTE-SWAPPED-8-AREF-32, DEFINE-OCTET-STRUCTURE-FIELD-TYPE, DEFINE-OCTET-STRUCTURE-FIELD-TYPE-MACRO, DEFINE-OCTET-STRUCTURE-CONVERSION-FIELD-TYPE, SIGNED-BYTE, UNSIGNED-BYTE, VECTOR, LOAD-BYTE, BIT, BOOLEAN, BOOLEAN8, BOOLEAN16, BOOLEAN32, MEMBER, SUBSET, ENUMERATION, LIST, CHARACTER, PADDING, BOOLEAN-BIT, ASCII-CHARACTER, DEFINE-OCTET-STRUCTURE, OCTET-STRUCTURE-FIELD-REF, OCTET-STRUCTURE-FIELD-INDEX, OCTET-STRUCTURE-FIELD-SIZE, OCTET-STRUCTURE-TOTAL-SIZE, OCTET-STRUCTURE-FIELD-ENTRY, OCTET-STRUCTURE-FIELD-INDIRECT-ARRAY, WITH-OCTET-STRUCTURE-ACCESS-TYPE, WITH-OCTET-STRUCTURE-FIELDS, DEFINE-OCTET-STRUCTURE-AND-FLAVOR, DEFINE-OCTET-STRUCTURE-AND-FLAVOR-1, COPY-OCTET-STRUCTURE, OCTET-STRUCTURE-EQUAL, COPY-FIELDS-FROM-OCTET-STRUCTURE, DESCRIBE-OCTET-STRUCTURE, WRITE-OCTET-STRUCTURE-DEFINITIONS-TO-C-FILE.

Network agents (124–151): HOST-PMAPPROC-CALLIT-TRANSPORT-AGENT, PORT-MAPPING-TRANSPORT-AGENT-MIXIN, FORGET-PORT, FORGET-PORTS, FORGET-ALL-PORT-MAPPING-TRANSPORT-AGENT-PORTS, PORT-UNAVAILABLE, AUTHENTICATION-MIXIN, AUTHENTICATION-INITIALIZE, AUTHENTICATION-USERNAME, AUTHENTICATION-RESET, RESET-ALL-AUTHENTICATING-TRANSPORT-AGENTS, AUTHENTICATION-DESCRIBE, HOST-TCP-TRANSPORT-AGENT, CLOSE-ALL-PORT-MAPPING-TCP-TRANSPORT-AGENTS, TCP-AGENT-NOTE-DEPENDENT, DEPENDENT-NOTE-TCP-AGENT-CLOSED, TCP-RPC-STREAM-CLOSED, HOST-UDP-TRANSPORT-AGENT, UDP-AGENT-NOTE-DEPENDENT, DEPENDENT-NOTE-UDP-AGENT-CLOSED, UDP-RPC-HOST-NOT-RESPONDING, UDP-RPC-CONNECTION-ERROR, *UDP-CALL-TIMEOUT*, *DEFAULT-UDP-CALL-TIMEOUT*, *UDP-CALL-RETRANSMIT-TIMEOUTS*, *DEFAULT-UDP-CALL-RETRANSMIT-TIMEOUTS*, *UDP-RPC-CONNECTION-IDLE-TIMEOUT*, *DEFAULT-UDP-RPC-CONNECTION-IDLE-TIMEOUT*.

UNIX name lookup (152–186): USERNAME->PASSWD, USERNAME->PASSWORD, USERNAME->UID, USERNAME->GID, USERNAME->GECOS, USERNAME->HOMEDIR, USERNAME->SHELL, USERNAME->GIDS, UID->PASSWD, UID->USERNAME, GROUPNAME->GROUP, GROUPNAME->GID, GROUPNAME->PASSWORD, GROUPNAME->USERNAMES, GID->GROUP, GID->GROUPNAME, HOSTNAME->HOST, HOSTNAME->ADDRESS, ADDRESS->HOST, ADDRESS->HOSTNAME, HOST-UNIX-NAME-LOOKUP-ACCESS-PATH, RESET-ALL-UNIX-NAME-LOOKUP-ACCESS-PATHS, UNIX-NAME-LOOKUP-ACCESS-PATH-NOTE-DEPENDENT, DEPENDENT-NOTE-UNIX-NAME-LOOKUP-ACCESS-PATH-RESET, YELLOW-PAGES-ORDER, YELLOW-PAGES-LOOKUP, YELLOW-PAGES-LIST, *USE-NAMESPACE-FOR-UNIX-NAME-LOOKUP*, *DEFAULT-USE-NAMESPACE-FOR-UNIX-NAME-LOOKUP*, *USE-YELLOW-PAGES-FOR-UNIX-NAME-LOOKUP*, *DEFAULT-USE-YELLOW-PAGES-FOR-UNIX-NAME-LOOKUP*, *USE-FILE-FOR-UNIX-NAME-LOOKUP*, *DEFAULT-USE-FILE-FOR-UNIX-NAME-LOOKUP*, *USE-HOSTS-FILE-FOR-UNIX-NAME-LOOKUP*, *DEFAULT-USE-HOSTS-FILE-FOR-UNIX-NAME-LOOKUP*.

Console (187–192): RPC-CONSOLE, CREATE-RPC-CONSOLE, NEW-UNIQUE-ID, *RPC-SCREEN-USE-HOST-SCREEN-STYLE*, *RPC-SCREEN-USE-BACKUP-SCREEN*, *RPC-SCREEN-ALWAYS-USE-BACKUP-SCREEN*.

Delivered C runtime and life-support calls

The public MacIvory manual documents the C-side RPC/life-support surface at a different grain. The inspected list includes agent lifecycle emb_agent_open, InitializeRPC, PollRPC, and CloseRPC; MacIvory startup InitMacIvorySupport and InitMacIvory; server setup initialize_remote_module_name_server and initialize_predefined_remote_entries_server; application recovery RestartMacIvoryApplication; failure reporting ColdLoadVisible, ReportRPCOpenFailure, RPCRemoteError, and ReportRPCCallFailure; and machine control ShowColdLoad, IsNetworkEnabled, IsColdLoadWindow, HideColdLoad, EnableNetwork, DisableNetwork, BusyWait, ColdBootFEP, RestartLisp, ColdBootLisp, ContinueLisp, RestartFEP, ShutDownIvory, and StopLisp.

These routines expose why a MacIvory application is more than a remote window: the host program participates in starting and polling RPC, presenting failure state, controlling Ethernet ownership, and transferring control between Lisp and the Ivory FEP.

What UX Support adds

UX Support loads four modules in order: unix-protocols, rpc-services, predefined-entries, and utilities. The inspected source adds these concrete capabilities:

• TCP services and clients for UNIX rexec on port 512 and rsh on port 514;
• paired RPC modules with UNIX as server or client, plus a UX400 run-lights module;
• UNIX error translation, UNIX epoch/time calls, host OS-version reporting, and predefined host entries;
• a remote tape stream that starts /usr/sbin/rmt or /etc/rmt through rexec;
• UNIX LPD hardcopy and queue/control integration on TCP port 515.

The RPC service layer waits 10 seconds by default for a UNIX RPC response. The remote tape stream uses a 262,144-byte buffer and recognizes a table of historical tape controller codes; that table does not imply the VLM has any such device. The LPD hardcopy buffer is 32,768 bytes and its acknowledgement wait is 20 seconds.

The LPD implementation is intentionally incomplete at the generic printer API boundary. Job submission, short-form queue query, and job deletion are implemented. Queue creation, creating or assigning a data channel, queue entry modification, policy modification, printer characteristic query, restart, suspend, resume, and reset explicitly signal “unimplemented”. This is source-visible behavior not evident from the simple claim “UNIX LPD support”.

Complete direct UX user command

Only one user command is defined directly in the inspected UX sources:

The source calls this a rough prototype and notes that Meta-Complete is normally needed to enter its richer source presentation. It obtains login credentials through the tape/login support if not supplied at the API level. There is no direct command-table keybinding.

UX Development is empty in this snapshot

The UX Development declaration requires UX Support and RPC Development, but its body is exactly an empty (:parallel) group. Installed active Help also describes it as reserved and lists no files. Thus “development” here is a named dependency boundary, not an additional API or application whose missing commands should be guessed. It may have been populated in another release; finding such a witness is an open preservation task.

Open Genera host application options

The public Open Genera guide documents 22 distinct genera command-line option names. They are part of the UX/VLM host operating surface, not Lisp commands:

Equivalent X-resource-style names can be read, in increasing precedence, from a site .VLM, the user's .VLM, the working-directory .VLM, and finally the command line. The documented search-path example contains /user/lib/symbolics where /usr/lib/symbolics might be expected; this page preserves it as a manual observation and does not silently “correct” a historical document.

UX screenshot TODO: a substantive Execute Command capture needs a deterministic, synthetic rexec peer inside the isolated namespace and disposable credentials. This study did not send a command or expose credentials merely to produce a listener image. A future probe should show the accepted source choice and harmless peer output while retaining the no-external-route boundary.

Complete direct command inventory

The source defines exactly eleven commands in the Keyboard Control command table. Commands without a menu accelerator remain typeable program commands; they are not silently promoted to menu buttons here.

Hardcopy contains a compiled-out Include Keysyms choice whose source comment calls the keysyms potentially wrong. It is not part of the user surface. Save Differences does not write a site file: it prints replayable SYS:SET-KEYBOARD-TABLE-MAPPING forms to the kill ring, in hexadecimal and lowercase. Persistence requires the user to paste or otherwise save those forms.

The application defines no direct command accelerator. End terminates only the raw Key Test and Typing Test loops, and inherited Help and Accept Values editing come from parent command tables. A :menu-accelerator t declaration means “use the generated command name as a menu label”; it is not a keyboard shortcut.

The separate Show Keyboard Layout command

Show Keyboard Layout is a Documentation-area Command Processor command, not a twelfth application command. It takes a layout, defaulting to the current console's recognized layout when available, plus:

• Include Legends, default Yes;
• Include Mappings, default current mappings when the chosen layout is current, otherwise the layout defaults; if current and default differ, the choices are Current, Default, or No;
• Include Codes, default No, with Octal, Decimal, and Hex alternatives.

It also inherits ordinary output-destination and More Processing behavior from the Documentation command environment.

Layout inventory and documentation drift

The generic source files define these eleven layout records:

• Symbolics, Sun Type 3, Sun Type 4, SGI Iris, NCD N-101, NDS, and DEC LK401 AA;
• IBM PC (U.S. English), IBM PC (101 keys, U.S. English), IBM PC (102 keys, key numbers), and IBM PC (another 102 keys, key numbers).

MacIvory additionally loads Macintosh layouts from a resource file rather than Lisp geometry forms. Installed UX documentation has a fourteen-name list: Apple, Apple Extended, Apple ISO, Apple ISO Extended, Mac 512K, Mac 512K International, Mac Plus, Mac Portable, Mac Portable ISO, NCD N-101, SGI Iris, Sun Type 3, Sun Type 4, and Symbolics. That Help list omits the later source's NDS, DEC, and IBM PC records, while including dynamically supplied Mac layouts. It is therefore an installed-documentation snapshot, not an exhaustive list of the later source tree.

MacIvory common settings and native-Mac mapping

The Genera Mac program's Keyboard submenu invokes Keyboard Control and exposes Common settings. In the inspected source, Common settings has a specialized dialog only for Apple Extended:

• shift-key order: Control–Meta–Super, Super–Meta–Control, or Meta–Control–Super;
• whether mouse keys act as mouse buttons rather than shift keys.

The MacIvory manual separately documents how a Symbolics keyboard drives native Macintosh applications. The direction is important; this is not the mapping from an Apple keyboard into Genera.

The manual describes special same/opposite-Shift handling for numeric keypad 8, equals, asterisk, and plus. It also records two host limitations: MultiFinder could lose key-up events despite a polling workaround, and the classic Mac event queue was small enough to make typeahead less reliable. These are manual claims for MacIvory, not behavior reproduced on the VLM.

Isolated Open Genera runtime probe

A read-only probe used named session d47-keyboard-control-20260718, generation 1, from 2026-07-18 11:38:44 to 11:40:28 EDT. The ordered input was:

1. type Select Activity Keyboard Control and press Return;
2. after the activity was rejected, evaluate (sys:keyboard-layout-type (sys:console-keyboard (send (tv:console-default-superior) :console))).

The runtime displayed exactly:

Keyboard Control cannot be used on a console with an unrecognized keyboard.

The read-only expression returned NIL. This agrees with the source choice predicate and establishes the blocker: the VLM X console did not identify itself as any loaded keyboard layout. It does not establish that Keyboard Control is broken on a recognized console.

The final action log contains eight intent/outcome records and has SHA-256 d3177e5b12c28295024bb6a42659b4ccaece57ee8ec1b14178e6a65f01e88467. The two relevant ignored captures were 1200×900:

The harness ran the private VLM in separate user, mount, network, PID, IPC, and hostname namespaces. It exposed no host root, external route, default route, or guest-visible host file service; Xvfb did not advertise MIT-SHM. The selected window was Genera on DIS-LOCAL-HOST, 1200×900 at X=72, Y=55. Both exact X protocol substitutions and the one-shot RFC 868 reply were observed before the run was accepted as running; the supervised responder separately exited with status 0. This isolated local identity is not a configured Symbolics site.

The base and private world hashes remained a8ee5e86cc7e322f7385af3e0cd579d7650d4dcfc3ce328acbf8b25515dd0672. The harness did not invoke Save World or make a host checkpoint; save_world_performed and guest_checkpoint_created remain unknown. Shutdown was recorded as separate stages: the prompt was observed, yes was sent, confirmation was accepted, and cleanup progress was observed. The known VLM cleanup stall then required a bounded forced stop. orderly_vlm_host_shutdown is false and state_may_be_incomplete is true.

Screenshot rights review and exact blocker

The rejection capture was reviewed specifically, not under a blanket rule. Its proposed purpose would be noncommercial historical scholarship and criticism; the visible interface is highly functional; one cropped listener state is the minimum amount needed to evidence the exact rejection; and such a use would not substitute for the product or its documentation. Those facts support a fair-use case for a carefully cropped evidentiary image.

No image is published here, however. The capture shows the blocker rather than Keyboard Control itself and adds little visual evidence beyond the exact recorded message. The raw capture remains in the ignored session tree.

Screenshot TODO: configure a recognized keyboard layout in the harness without broadening its pinned X compatibility contract, then capture the actual five-pane initial program and one non-destructive mapping-inspection state. Review each selected image under the repository policy and curate it separately; do not replace this blocker with an unproven illustration.

What the support system contains

MacIvory Support serially combines:

1. Macintosh internals and resource-defined key layouts;
2. Mac keyboard-cap geometry;
3. Mac Toolbox and remote Mac file-system systems;
4. toolkit, callback, UIMS, and dialog substrate;
5. the remote Genera console program;
6. Genera-to-Mac font mappings;
7. Mac/RPC error translation.

The Macintosh-internals subsystem covers Mac types, QuickDraw, file formats, fonts, time conversion, Mac image copying, RPC status, and a machine-conditional MacIvory configuration module. The file-system layer distinguishes ordinary data and resource forks and makes the host Mac available through a Genera host object. Presence in the licensed source tree does not imply that the VLM can instantiate its :imach hardware paths.

The Mac Toolbox declaration contains 40 manager/program source units: ADB, color manager and picker, Color QuickDraw and Color Toolbox, control, desk, dialog, disk initialization, event communication, file, font, graphics devices, international utilities, list, memory, menu, palette, QuickDraw, resource, scrap, script, SCSI, segment loader, sound, Standard File, system miscellaneous, TextEdit, Toolbox event, window, printing, device, disk driver, serial driver, Toolbox utilities, OS utilities, OS event, vertical retrace, slot, and notification. Definitions, Mac OS errors, all-manager glue, toolkit macros, and remote launch support sit around those units.

The source declaration comments that AppleTalk is the only manager not included. Installed toolbox5 Help nevertheless has an AppleTalk Manager section. No AppleTalk manager implementation unit appears in this source declaration or subtree, so the Help heading is evidence of documentation coverage or another release—not proof of a loadable AppleTalk bridge here.

The public MacIvory Delivery manual provides a separate product check: it lists Macintosh file-system support, Macintosh Toolbox support, and Macintosh RPC among the facilities retained in its reduced delivery world, while excluding many development applications and databases. Embedding was therefore part of the delivery substrate, not merely development tooling.

Complete external MAC-TOOLBOX package surface

The package declaration exports 161 names. The list below is complete at that package boundary and in declaration order; it is much smaller than the generated set of individual Macintosh Manager calls.

Graphics and display (1–11): QUICKDRAW-PICTURE, WITH-OUTPUT-TO-QUICKDRAW-PICTURE, QUICKDRAW-PRESENTATION, QD-PRESENTATION-UNIQUE-ID, QD-PRESENTATION-BOUNDING-BOX, QD-PRESENTATION-CHORDS, LOAD-MORE-FONTS, *MAC-DISPLAY-DEVICE*, *AUTOMATICALLY-GENERATE-PIXMAP-CORRESPONDENCES*, *PIXMAP-CORRESPONDENCE-MEMORY-THRESHOLD*, READ-MACPAINT-FILE.

Structure basics (12–19): DEFINE-MAC-STRUCTURE, POINT, RECT, POLYGON, PATTERN, CURSOR, SET-POINT, SET-RECT.

File, volume, and queue structures (20–71): CCONSTANT, CCONSTANT-1, HANDLE, FINFO, FINFO-FDTYPE, FINFO-FDCREATOR, FINFO-FDFLAGS, FILEPARAM, MAKE-FILEPARAM, FILEPARAM-IOFLFNDRINFO, FILEPARAM-IOFLLGLEN, FILEPARAM-IOFLRLGLEN, FILEPARAM-IOFLMDDAT, VOLUMEPARAM, MAKE-VOLUMEPARAM, VOLUMEPARAM-IOVREFNUM, DRVQEL-QLINK, DRVQEL-DQDRIVE, MAKE-HVOLUMEPARAM, HVOLUMEPARAM-IOVREFNUM, HVOLUMEPARAM-IOVNMALBLKS, HVOLUMEPARAM-IOVALBLKSIZ, HVOLUMEPARAM-IOVFRBLK, HVOLUMEPARAM-IOVFILCNT, HVOLUMEPARAM-IOVDIRCNT, MAKE-HFILEINFO, HFILEINFO-IOFLATTRIB, HFILEINFO-IOFLFNDRINFO, HFILEINFO-IOFLLGLEN, HFILEINFO-IOFLPYLEN, HFILEINFO-IOFLRLGLEN, HFILEINFO-IOFLRPYLEN, HFILEINFO-IOFLMDDAT, HFILEINFO-IOFLBKDAT, DIRINFO-IODRDIRID, DIRINFO-IODRNMFLS, DIRINFO-IODRMDDAT, DIRINFO-IODRBKDAT, MAKE-FCBPBREC, FCBPBREC-IOVREFNUM, FCBPBREC-IOREFNUM, FCBPBREC-IOFCBFLAGS, FCBPBREC-IOFCBEOF, FCBPBREC-IOFCBPLEN, FCBPBREC-IOFCBCRPS, FCBPBREC-IOFCBPARID, QELEM-QLINK, QELEMPTR, QHDR, QHDR-QHEAD, MAKE-SYSENVREC, SYSENVREC-SYSVREFNUM.

Remote-menu constants (72–76): REMOTE-VIEWER-COMMANDS, REMOTE-QUIT-COMMANDS, *STANDARD-REMOTE-VIEWER-FILE-MENU*, *STANDARD-EDIT-MENU*, SIZE.

Resources and ports (77–95): WITH-QD-PORT, WITH-WINDOW, WITH-HANDLE-LOCKED, WITH-RESOURCE-HANDLE, WITH-RESOURCE, CCONSTANT-CASE, CCONSTANT-ECASE, WITH-MAC-STRUCT, MAP-OVER-MAC-QUEUE-ELEMENTS, USING-RESFILE, DO-RESTYPES, DO-RSRCS, SHOW-RESFILES, WITH-MAC-TEMP, WITH-RESFILES, WITH-RESLOAD, USING-SCRATCH-RESFILE, DOWNLOAD-RESOURCE, RPC-WINDOW-FOR-MAC-WINDOW.

Errors and remote access (96–115): MAC-OS-ERROR, RPC-FILE-ERROR, MAC-FS-NOT-A-DIRECTORY, MAC-RPC-FILE-RENAME-ACROSS-VOLUMES, MAC-RPC-FILE-UNKNOWN-PROPERTY, WITH-MAC-OS-ERROR-ARGS, SIGNAL-MAC-OS-ERROR, LOOKUP-MAC-OS-CONDITION, WITH-OPEN-REFNUM, WITH-PICT-FROM-FILE, EZ-SFGETFILE, OCTET-REF-REMOTE-PTR, OCTET-REF-REMOTE-HANDLE, WITH-RECT, WITH-POINT, REMOTE-NUMBER, READ-REMOTE-NUMBER, WRITE-REMOTE-NUMBER, DESCRIBE-EVENTRECORD, WITH-TEMPS.

Callbacks and definition types (116–146): WITH-MAC-CALLBACK, WITH-MAC-CALLBACK-FUNCTION, GET-CANNED-CALLBACK, MAKE-MAC-CALLBACK, REMOVE-MAC-CALLBACK, CONTROL-DEFINITION, CONTROL-INDICATOR-ACTION, CONTROL-NONINDICATOR-ACTION, DIALOG-SOUND-PROC, DIALOG-USER-ITEM-DEFINITION, DRAW-DIALOG-LINE, MENU-DEFINITION, MODAL-DIALOG-FILTER, QUICKDRAW-ARCPROC, QUICKDRAW-BITSPROC, QUICKDRAW-COMMENTPROC, QUICKDRAW-GETPICPROC, QUICKDRAW-LINEPROC, QUICKDRAW-OVALPROC, QUICKDRAW-POLYPROC, QUICKDRAW-PUTPICPROC, QUICKDRAW-RECTPROC, QUICKDRAW-RGNPROC, QUICKDRAW-RRECTPROC, QUICKDRAW-TEXTPROC, QUICKDRAW-TXMEASPROC, STANDARD-FILE-DIALOG-HOOK, STANDARD-FILE-FILE-FILTER, TEXT-EDIT-CLICK-PROC, TEXT-EDIT-WORD-BREAK-PROC, WINDOW-DEFINITION.

MacBinary (147–161): MACBINARY, MAKE-MACBINARY, MACBINARY-VERSION, MACBINARY-NAME, MACBINARY-TYPE, MACBINARY-CREATOR, MACBINARY-FLAGS, MACBINARY-LOCATION, MACBINARY-WINDOW, MACBINARY-LOCK, MACBINARY-DATA-FORK-LENGTH, MACBINARY-RESOURCE-FORK-LENGTH, MACBINARY-CREATION-DATE, MACBINARY-MODIFICATION-DATE, MACBINARY-COMPUTER-TYPE.

MacIvory Development boundary

No MacIvory Development system declaration or development source subtree was found in the inspected source snapshot. Installed Help describes development user-interface tools, says the system is relevant on 3600-series machines, and says all Ivory worlds contain it. Those statements are retained as installed documentation claims. They do not supply a complete command or API inventory, and the base VLM's differently named MACIVORY-D&E system does not close that gap.

TODO: locate a licensed release with the MacIvory Development declaration and source or a public programmer's reference that enumerates its exact additions; then distinguish those additions from the Support system and generic Dynamic Windows APIs.

Frame, menus, commands, and keybindings

The source defines a remote-program framework named GENERA, selectable only when the remote-system type is :MAC. It represents a Genera console inside a classic Macintosh application, queries the host's displays, creates an RPC console, and converts Genera command/menu metadata into native Mac menu state.

The declared menu order is File, the standard Edit template, and Options. File names Close and Quit; Options contains a Keyboard submenu. The source defines these seven direct program commands and two direct menu-to-command handlers:

Edit Cut/Copy is one direct command with a Boolean; Cut and Copy are two menu handlers that instantiate it. Thus the table has nine user-facing actions but seven program-command definitions plus inherited Quit.

The standard Edit template also names Undo with Super-Z and Clear, but no direct handler for either appears in the Genera program source. They are not asserted as implemented. The File menu ordering names Close, but this frame inherits only REMOTE-QUIT-COMMANDS, not the framework that defines Close/Close All viewer commands. Close might be host-reserved behavior; its exact effect is a runtime TODO. Close All is part of the generic remote-viewer framework and is not in this Genera frame's declared File menu.

An internal Mac Window Scroll Command Processor command exists in a private Mac Window Control table for presentation-driven scrolling. It has no user menu item or accelerator in this frame and is not counted as a user command.

Complete Start Screen surface

If the chosen display is smaller than 900×700 and uses installed Genera fonts, the source substitutes a small-screen display device. A movable screen deducts 20 pixels from the reported host height for the title bar. Screen number and Color are forcibly reset to safe values when their conditional questions were not presented, avoiding stale defaults from a preconstructed command.

Configure MacIvory Application

Configure MacIvory Application is a no-argument World Building Command Processor command that opens an Accept Values form and writes a configured classic Macintosh application. Its complete direct input surface is:

The implementation reads the template's data and resource forks, replaces the application configuration, version, memory, and description resources, and writes the new Macintosh file. That is a mutating build operation; it was not run against the preserved media. A correct future test needs a disposable copy of a period Mac application and a host able to preserve both forks.

Ivory menu and control panel

The classic Mac host software also supplies an Ivory menu outside the remote Genera command table. Its state-dependent inventory is:

Restart Lisp preserves virtual-memory contents while reinitializing processes and network connections; Cold Boot Lisp discards that state. Network enable or disable transfers the single Ethernet interface between Ivory and the Mac. Those meanings come from the public MacIvory manual and C library API, not from a local MacIvory run.

The MacIvory Control Panel has three functional panes:

• Hardware status: Ivory processor and NuBus memory, with raw MB and usable 40-bit-plus-ECC megawords.
• Status and configuration: Configure, an immediate Ethernet Grabbed checkbox, Status, and Help.
• Disk partitions: inspect, create, and delete MacIvory partitions, plus a Copy/Compare utility for MacIvory partitions or Macintosh disks and its Help.

Disk creation/deletion, cold boots, network ownership, and shutdown are materially mutating operations. They were not exercised for documentation.

Screenshot status

Screenshot TODO: no MacIvory-capable host, application resource fork, or classic Mac UI runtime was available to the isolated VLM harness. The VLM release explicitly excludes the separate MacIvory systems, so a Genera X-window capture would not verify these native menus or dialogs. A future capture should use rights-cleared period Mac system software and disposable disk images, record both host and Lisp artifacts, and stop before executing cold boot, partition, network, or application-output actions. Public manual illustrations are evidence but are not republished as a substitute for a runtime observation.

The twelve demonstration cards

These are manual descriptions of the distributed stack, not locally executed claims. In particular, the Statice, Joshua, Finder, and Document Examiner demos depend on additional data and programs whose presence was not established here.

HyperTalk and Lisp bridge API

The complete documented HyperTalk surface has six routines:

At the documented Lisp boundary, the complete bridge-specific surface has these nineteen names:

• server control: MTB:*DEBUG-HC-SERVER-FLAG* and MTB:DEFINE-XFCN-SERVER;
• string parsing: MTB:HC-CHUNK-CHARACTER and MTB:HC-CHUNK-ITEM, both using zero-based indices unlike HyperTalk chunks;
• scoped allocation and drawing: MTB:WITH-HC-ZSTRING, MTB:WITH-HC-EVAL-EXPR, and MTB:MAKING-QD-PICTURE;
• implemented callbacks: MTB:HC-SEND-CARD-MESSAGE, MTB:HC-SEND-HC-MESSAGE, MTB:HC-EVAL-EXPR, MTB:HC-ZERO-BYTES, MTB:HC-GET-GLOBAL, MTB:HC-SET-GLOBAL, MTB:HC-GET-FIELD-BY-NAME, MTB:HC-GET-FIELD-BY-NUM, MTB:HC-GET-FIELD-BY-ID, MTB:HC-SET-FIELD-BY-NAME, MTB:HC-SET-FIELD-BY-NUM, and MTB:HC-SET-FIELD-BY-ID.

WITH-HC-ZSTRING and WITH-HC-EVAL-EXPR free their temporary Mac handles on exit. The lower-level getters can return allocated handles for which the caller is responsible. The manual warns that leaking those handles exhausts the HyperCard heap and that stopping an XFCN server in the Genera Debugger can also stop HyperCard's UI service.

The five general CallIvory servers supplied by the interface are LIST-ROUTINES, ECHO-ARG, BEEP-SOME, EVAL-SOME, and COMMAND-SOME. Seven named demo servers support the cards: FLAVOR-PARTS, CARDS-FOR-ALL-DESKTOP-ICONS, CARDS-FOR-SAGE-TOPIC, MAP-HACK-CLICK, LIST-MUGSHOTS-STARTING-WITH, GET-MUGSHOT-FOR, and GET-MUGSHOT-FOR-1. The last seven are examples/application entries, not generic bridge primitives.

Deliberately unimplemented HyperCard callbacks

The public manual explicitly lists seventeen HyperCard callbacks that the remote bridge does not implement because Lisp already handles their string, coercion, or conversion work:

BoolToStr, ExtToStr, LongToStr, NumToHex, NumToStr, PasToZero, ReturnToPas, ScanToReturn, ScanToZero, StringEqual, StringLength, StringMatch, StrToBool, StrToExt, StrToLong, StrToNum, and ZeroToPas.

This is a useful limit: “callbacks into HyperCard” never meant every callback in the HyperCard host API.

Source and screenshot status

The installed manuals and loadable-system Help identify the historical source directory and stack, but neither the HyperCard/MacIvory Lisp examples nor the HyperIvory stack is present in the inspected licensed source snapshot. No local source-derived claim is made about card button layouts or scripts.

Screenshot TODO: obtain a rights-cleared HyperCard runtime and the matching HyperIvory stack plus Lisp-side system, run them on a disposable MacIvory setup, and capture one card together with the minimum Genera response needed to prove the round trip. The current VLM cannot supply the embedded Mac channel, and a manual scan is not a runtime substitute.

Licensed source witnesses

All paths in this table are relative to the licensed sys.sct/ root. They are identifiers and hashes, not repository links.

Installed Help witnesses

The tracked inert extractor scripts/extract-genera-help.py is 55,939 bytes with SHA-256 e59440906a0092afe28ca514be9e7afdf6c21ca1009b765a710f0a4121f13a74. Its ignored catalog is 577,696 bytes with SHA-256 a089d1e64e65e06471ef5bb90533164242267c9f8eb1067062a41796998c1aed; the ignored source-form Help inventory is 9,817,347 bytes with SHA-256 8e59a784b805808e86b84be58fea8622f64fb3e79d7d0603ef64ce0ed1365190.

Record counts are inert extractor records, not counts of commands or APIs. Decoded content remains ignored under build/help/genera/.

Runtime witness

The runtime source and execution identities for the Keyboard Control probe are:

Tracked harness-source hashes at start were Python harness bc9276ac766913bc15018dd334a2a2704ae5a926e1fcbc30ccfcff08af8cb48a, Guix entrypoint e10d07a1c745d37044f1a97903455d334d6dcdb0c1d0e6854598e10fab24fa05, VLM helper cbf9ee0520b4892325266ed17afba8f1b663e7d266fea6d80de9cf98de17d2f8, namespace helper 17a3e297930eef45a6f59a349f92ec1f6dc99b2c4d5caa2392dc0521636af01c, X preload source 4db1dee8e71d5ddc5cfd8289ecc3607738370ac97f856853786cfe713e94e392, and ifconfig preload source a4d126dbb6fd6f4903835bbb41c39652cfc53c91e942267dc9166c1c938c36e7.

The Guix manifest SHA-256 was 3adae999bbe420182f22adc2499fcc82449a46eaf580a362de9c0e718fa6b37d at channel commit 230aa373f315f247852ee07dff34146e9b480aec. Principal tool versions were Guix 1.5.0, Bubblewrap 0.11.0, Xorg server 21.1.21, Python 3.11.14, ImageMagick 6.9.13-5, and xdotool 3.20211022.1.