File: README.macosx

package info (click to toggle)
faumachine 20180503-4
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 61,272 kB
  • sloc: ansic: 272,290; makefile: 6,199; asm: 4,251; sh: 3,022; perl: 886; xml: 563; pascal: 311; lex: 214; vhdl: 204
file content (93 lines) | stat: -rw-r--r-- 3,123 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

**************
* DISCLAIMER *
**************

This document describes a work in progress, is far from being exhaustive
and might be out-dated. The endeavour is carried out on _one_single_
Intel-based Macintosh computer running Mac OS X 10.6. The results may
heavily depend on the local configuration of this system and might not be
easily portable to other systems.

Releases can and will not be provided as we don't have appropriate
Intel-Macs in our build systems pool (donations are welcome!).

**********************
* GENERAL PREQUISITE *
**********************

You have to get, build, and install our VHDL compiler/interpreter fauhdlc
before being able to build, install, and run FAUmachine.

*****************
* 32 vs. 64 BIT *
*****************

Originally, porting has been done on the x86_32 platform (on 10.4 and 10.5).
It was then ported again to x86_64 on 10.6. It should still be possible to
build on the 32 bit platform but we cannot test it at the moment.

*****************
* Lion (10.7.x) *
*****************

An updating effort of the port for Mac OS X 10.7 will started as soon as a
working open source tool/library environment (cf. below) is available.

************
* BUILDING *
************

To build FAUmachine under Mac OS X 10.6 (Intel), the complete development tools
provided by Apple (aka "XCode") are required (including X11 headers).
Additionally, there are (still) some open source libraries (including the
respective developement headers) and tools that are needed:

 * automake >= 1.10        \ 
 * autoconf >= 2.62        |
 * pkgconfig >= 0.11       | e.g. from fink or macports
 * GTK+2 >= 2.12           |
 * libpng >= 1.2.29        /
 * (to be completed...)

(You might have to check with pkg-config, whether all packages on which
GTK depends are installed.)

To be able to use network bridging, a working binary of slirp has to
be installed somewhere in the search path. It doesn't have to be present
at build time, though.

Unfortunately, BIOSes currently cannot be built, as the Mac platform does
not provide a toolchain which is able to generate and process ELF binaries.
Use --disable-build-bios with 'configure' to avoid error messages and build
failures, although lacking support of ELF should be detected automatically.
You have to build your BIOSes on a Linux or OpenBSD system and copy it to
'$install_prefix/lib/faumachine/roms/'.

Other parts of the FAUmachine environment that cannot be built due to lacking
dependencies are deselected automatically by 'configure'. (Well, let's keep
our fingers crossed...)

********************
* WORKING FEATURES *
********************

The following features are tested and (currently) working:

 * 32 and 64 bit target CPUs
 * keyboard and mouse (keyboard mapping might have to be improved, though)
 * disk-image based mass storage
 * audio bridging (native CoreAudio support)
 * network bridging (via slirp)
 * fauhdli and fault injection

********************
* LACKING FEATURES *
********************

The following features are known not to build or work:

 * attaching host CD/DVD-ROM drives
 * networking via tun/tap
 * ...