Platform Notes (Mac OS X) - Revision history

Smw: /* Port Challenges */

2025-05-16T13:02:19Z

Port Challenges

2025-05-16T13:01:38Z

2023-09-07T23:14:58Z

Add FreeM Lite reference

2023-08-30T23:21:47Z

2023-08-30T22:51:43Z

2023-08-30T18:06:18Z

2023-08-30T14:27:57Z

2023-08-30T14:18:24Z

Add specific information on configuring shared memory

2023-08-29T14:04:40Z

Add git to required packages for building

2023-08-29T14:03:53Z

Add build notes, testing details, and correct the port status

@@ Line 68: / Line 68: @@
 == 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.
+The shared memory architecture of FreeM had to be rewritten to support Apple's System V IPC changes for their Unified Memory Architecture.
 [[Category:Platform Notes]]
 [[Category:Tier 2 Ports]]

@@ Line 1: / Line 1: @@
 == Port Status ==
-The Mac OS X port is a [[Tier 3 Port]], though it can run with some significant headaches.
+The Mac OS X port is a [[Tier 2 Port]].
 The main branch will compile on macOS Monterey (12.6.8) on Intel, and it can run if the <code>kern.sysv.shmmax</code> parameter is correct (see below).
 == Verified Releases ==
 * [[FreeM Lite]]
 == Build Notes ==
@@ Line 32: / Line 30: @@
 * MacBook Air (Early 2015) running macOS Monterey (12.6.8)
 == Required Kernel Tuning ==
-You will need to set the <code>kern.sysv.shmmax</code> sysctl parameter to at least 6144000 (the value must be a multiple of the system page size; generally 4096).
+You will need to set the <code>kern.sysv.shmmax</code> sysctl parameter to at least 17002496 (the value must be a multiple of the system page size; generally 4096).
 To determine the current setting, see below:
@@ Line 48: / Line 47: @@
 See your macOS version below for instructions on modifying this value.
-=== macOS Monterey ===
+=== All Versions ===
 * Find the file <code>com.startup.sysctl.plist</code> file in the <code>scripts</code> subdirectory of the FreeM distribution
@@ Line 74: / Line 73: @@
 [[Category:Platform Notes]]
-[[Category:Tier 3 Ports]]
+[[Category:Tier 2 Ports]]

@@ Line 4: / Line 4: @@
 The main branch will compile on macOS Monterey (12.6.8) on Intel, and it can run if the <code>kern.sysv.shmmax</code> parameter is correct (see below). Launching new interpreters can be hit-or-miss, as there are shared memory issues on this platform. You may need to try starting a new process 10 times or more before one will launch successfully.
 == Verified Releases ==
-TBD
+* [[FreeM Lite]]
 == Build Notes ==

@@ Line 1: / Line 1: @@
 == Port Status ==
-The Mac OS X port is a [[Tier 3 Port]]
+The Mac OS X port is a [[Tier 3 Port]], though it can run with some significant headaches.
-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:
+The main branch will compile on macOS Monterey (12.6.8) on Intel, and it can run if the <code>kern.sysv.shmmax</code> parameter is correct (see below). Launching new interpreters can be hit-or-miss, as there are shared memory issues on this platform. You may need to try starting a new process 10 times or more before one will launch successfully.
 == Verified Releases ==

@@ Line 35: / Line 35: @@
 == Required Kernel Tuning ==
-You will need to set the <code>kern.sysv.shmmax</code> sysctl parameter to at least 6000000.
+You will need to set the <code>kern.sysv.shmmax</code> sysctl parameter to at least 6144000 (the value must be a multiple of the system page size; generally 4096).
 To determine the current setting, see below:

@@ Line 50: / Line 50: @@
 === macOS Monterey ===
-* Find the file <code>com.startup.sysctl.plist</code> file in the <code>scripts</code> subdirectory of the FreeM distributionc
+* Find the file <code>com.startup.sysctl.plist</code> file in the <code>scripts</code> subdirectory of the FreeM distribution
 * Copy it to <code>/Library/LaunchDaemons</code>
 * Change the ownership of <code>/Library/LaunchDaemons/com.startup.sysctl.plist</code> to <code>root:wheel</code>

@@ Line 39: / Line 39: @@
 To determine the current setting, see below:
-<code>
+<pre>
 $ sudo sysctl -a | grep shmmax
 kern.sysv.shmmax: 4194304
-</code>
+</pre>
 In the above example, the <code>shmmax</code> value is <code>4194304</code>, and thus insufficient for proper FreeM operation.
@@ Line 53: / Line 53: @@
 * Copy it to <code>/Library/LaunchDaemons</code>
 * Change the ownership of <code>/Library/LaunchDaemons/com.startup.sysctl.plist</code> to <code>root:wheel</code>
 * Reboot
 See the following example:
-<code>
+<pre>
 $ sudo cp scripts/com.startup.sysctl.plist /Library/LaunchDaemons/
 $ sudo chown root:wheel /Library/LaunchDaemons/com.startup.sysctl.plist
-</code>
+$ sudo launchctl load /Library/LaunchDaemons/com.startup.sysctl.plist

← Older revision		Revision as of 14:18, 30 August 2023
Line 32:		Line 32:

	* MacBook Air (Early 2015) running macOS Monterey (12.6.8)		* MacBook Air (Early 2015) running macOS Monterey (12.6.8)
		+
		+	== Required Kernel Tuning ==
		+
		+	You will need to set the <code>kern.sysv.shmmax</code> sysctl parameter to at least 6000000.
		+
		+	To determine the current setting, see below:
		+
		+	<code>
		+	$ sudo sysctl -a \| grep shmmax
		+	kern.sysv.shmmax: 4194304
		+	</code>
		+
		+	In the above example, the <code>shmmax</code> value is <code>4194304</code>, and thus insufficient for proper FreeM operation.
		+
		+	See your macOS version below for instructions on modifying this value.
		+
		+	=== macOS Monterey ===
		+
		+	* Find the file <code>com.startup.sysctl.plist</code> file in the <code>scripts</code> subdirectory of the FreeM distributionc
		+	* Copy it to <code>/Library/LaunchDaemons</code>
		+	* Change the ownership of <code>/Library/LaunchDaemons/com.startup.sysctl.plist</code> to <code>root:wheel</code>
		+	* Reboot
		+
		+	See the following example:
		+
		+	<code>
		+	$ sudo cp scripts/com.startup.sysctl.plist /Library/LaunchDaemons/
		+	$ sudo chown root:wheel /Library/LaunchDaemons/com.startup.sysctl.plist
		+	</code>
		+
		+
		+	== Starting the FreeM Daemon Automatically ==
		+	Coming soon.

	== Port Challenges ==		== Port Challenges ==

@@ Line 25: / Line 25: @@
 * texinfo
 * texi2html
 == Testing Details ==