Difference between revisions of "Platform Notes (Mac OS X)"

From FreeM Wiki
Jump to navigation Jump to search
(Update testing details to reflect recent macOS Monterey testing efforts.)
(Add build notes, testing details, and correct the port status)
Line 2: Line 2:
  
 
The Mac OS X port is a [[Tier 3 Port]]
 
The Mac OS X port is a [[Tier 3 Port]]
 +
 +
The main branch will compile on macOS Monterey (12.6.8) on Intel, but the default shared memory size on this operating system is too small to accommodate the default FreeM shared memory segment size. Reducing the segment size results in the following error:
 +
 +
freem [FATAL]:  memory allocation failure in job_init [errno 2 No such file or directory]
  
 
== Verified Releases ==
 
== Verified Releases ==
 
TBD
 
TBD
 +
 +
== Build Notes ==
 +
 +
In order to build FreeM on macOS, you will need to install the following:
 +
 +
* Apple XCode command-line tools
 +
* Homebrew
 +
 +
Then, install the following with the brew package manager:
 +
 +
* automake
 +
* autoconf
 +
* gcc
 +
* libtool
 +
* texinfo
 +
* texi2html
  
 
== Testing Details ==
 
== Testing Details ==
The macos-fixes branch will compile on macOS Monterey (12.6.8) on Intel, but the default shared memory size on this operating system is too small to accommodate the default FreeM shared memory segment size. Reducing the segment size results in the following error:
 
  
freem [FATAL]: memory allocation failure in job_init [errno 2 No such file or directory]
+
We build the macOS port on the following hardware:
 +
 
 +
* MacBook Air (Early 2015) running macOS Monterey (12.6.8)
  
 
== Port Challenges ==
 
== Port Challenges ==

Revision as of 08:03, 29 August 2023

Port Status

The Mac OS X port is a Tier 3 Port

The main branch will compile on macOS Monterey (12.6.8) on Intel, but the default shared memory size on this operating system is too small to accommodate the default FreeM shared memory segment size. Reducing the segment size results in the following error:

freem [FATAL]: memory allocation failure in job_init [errno 2 No such file or directory]

Verified Releases

TBD

Build Notes

In order to build FreeM on macOS, you will need to install the following:

  • Apple XCode command-line tools
  • Homebrew

Then, install the following with the brew package manager:

  • automake
  • autoconf
  • gcc
  • libtool
  • texinfo
  • texi2html

Testing Details

We build the macOS port on the following hardware:

  • MacBook Air (Early 2015) running macOS Monterey (12.6.8)

Port Challenges

Apple makes it extremely difficult to build traditional UNIX software, in the name of "security". Also, Apple silicon (M1 and descendants) cannot likely be supported with the current shared memory architecture.

We will most likely support only PowerPC and Intel Macs.