Skip to content

Commit bb7a364

Browse files
peterehackorum
authored andcommitted
doc: Update information on macOS SIP
On more recent versions of macOS, it is sufficient to disable only a part of SIP in order to get make check to run before make install. Document how.
1 parent 4069df2 commit bb7a364

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

doc/src/sgml/installation.sgml

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3653,6 +3653,9 @@ xcode-select --install
36533653
You may or may not wish to also install Xcode.
36543654
</para>
36553655

3656+
<sect3 id="installation-notes-macos-sysroot">
3657+
<title>Sysroot</title>
3658+
36563659
<para>
36573660
On recent <productname>macOS</productname> releases, it's necessary to
36583661
embed the <quote>sysroot</quote> path in the include switches used to
@@ -3697,6 +3700,10 @@ xcrun --show-sdk-path
36973700
to build with a non-Apple compiler, but beware that that case is not
36983701
tested or supported by the PostgreSQL developers.
36993702
</para>
3703+
</sect3>
3704+
3705+
<sect3 id="installation-notes-macos-sip">
3706+
<title>System Integrity Protection</title>
37003707

37013708
<para>
37023709
<productname>macOS</productname>'s <quote>System Integrity
@@ -3707,6 +3714,25 @@ xcrun --show-sdk-path
37073714
install</literal> before <literal>make check</literal>.
37083715
Most PostgreSQL developers just turn off SIP, though.
37093716
</para>
3717+
3718+
<para>
3719+
To disable SIP, boot into recovery mode, open a terminal, and run
3720+
<programlisting>
3721+
csrutil disable
3722+
</programlisting>
3723+
and reboot. In macOS version 10.14 and later, it is sufficient to disable
3724+
the <quote>Debugging</quote> part of SIP, by running
3725+
<programlisting>
3726+
csrutil enable --without debug
3727+
</programlisting>
3728+
instead. The status of SIP can be shown using
3729+
<programlisting>
3730+
csrutil status
3731+
</programlisting>
3732+
Note that that status display does not reflect changes until after a
3733+
reboot.
3734+
</para>
3735+
</sect3>
37103736
</sect2>
37113737

37123738
<sect2 id="installation-notes-mingw">

0 commit comments

Comments
 (0)