From 98f2678db8e2303ccdf05322e3395376260b442a Mon Sep 17 00:00:00 2001
From: Kait Lam <39479354+katrinafyi@users.noreply.github.com>
Date: Fri, 27 Sep 2024 14:24:09 +1000
Subject: [PATCH] docs: note about mac os

---
 docs/usage.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/usage.md b/docs/usage.md
index 767e8907f2..71650df420 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -58,6 +58,19 @@ See also: [tool-installation](development/tool-installation.md)
 and [development: building](development/readme.md#building)
 (primarily if you are interested in building BASIL manually).
 
+#### Mac OS
+
+The Mac OS platform (both x86 and arm64)
+uses a different binary format (Mach-O instead of ELF),
+so you will need to install and use a cross-compiler targeting aarch64-unknown-linux-gnu such as the one here:
+https://github.com/messense/homebrew-macos-cross-toolchains
+This means the commands for gcc and readelf might be different from those shown below.
+The Nix commands should work unchanged.
+Some scripts/makefiles within the repository
+might also need tweaks.
+Mac OS is a less supported platform,
+please report any issues.
+
 ### Preparation
 
 1. Compile a C program into an Aarch64 binary, for example: