黑苹果 - 开发笔记分享

最后修改人	果农
最后修改时间	2021-11-28 05:57:32
创建人	果农
创建时间	2020-03-08 06:27:12

该文档由果农创建于 2020-03-08 06:27:12 ，果农在 2021-11-28 05:57:32 修改了该文档。

[TOCM]

## csr-active-config  
举例：  
-> Raw Data: csr-active-config=0x13  
0x0013 = 0b 00000000 00010011  
每个标志位的含义，上方从右至左8个标志位以bit 0 - bit 7表示：  
___ ____ ___1 (bit 0): [kext] 允许加载不受信任的kext（与已被废除的kext-dev-mode=1等效）  
___ ____ __1_ (bit 1): [fs] 解锁文件系统限制  
___ ____ _1__ (bit 2): [debug] 允许task_for_pid()调用  
___ ____ 1___ (bit 3): [n/a] 允许内核调试 （官方的csrutil工具无法设置此位，从10.13开始会随bit 0/4被自行设置）  
___ ___1 ____ (bit 4): [internal] Apple内部保留位（csrutil disable默认会设置此位，用于Recovery/安装环境）  
___ __1_ ____ (bit 5): [dtrace] 解锁dtrace限制  
___ _1__ ____ (bit 6): [nvram] 解锁NVRAM限制  
___ 1___ ____ (bit 7): [n/a] 允许设备配置，用于Recovery/安装环境  
__1 ____ ____ (bit 8): [basesystem] Basesystem验证，即允许启动任意Recovery系统（10.12新增）  
_1_ ____ ____ (bit 9): [n/a] 允许加载未经用户批准的kext，即禁用kext user consent功能（10.13新增）  
1__ ____ ____ (bit 10): [n/a] Executable Policy Override（10.14新增）

把需要关闭的安全保护技术标志位设置为1即可。非开发者一般仅需要关心前2项。  
更多示例及建议值：  
-> Clover(需要修改原版kext但未使用kextpatch)/Chameleon用户，建议仅解锁kext加载和文件系统限制：  
csr-active-config=0x13或0x3 (csrutil enable --without kext --without fs [--no-internal]) - 此配置对于大部分非白果用户适用  
-> Clover(已正确配置kextpatch对原版kext进行修改)/Ozmosis用户，建议仅解锁kext加载限制以加载第三方未签名kext：  
csr-active-config=0x11或0x1 (csrutil enable --without kext [--no-internal])  
-> Clover(愿意依赖Kext注入功能+已正确配置kextpatch对原版kext进行修改)/白果用户，可完全开启SIP：  
csr-active-config=0x10或0x0 (csrutil enable [--no-internal] 或 curutil clear)  
注：部分kext无法通过Clover的kext注入来正常工作，例如AppleHDA Injector等。  
-> 关闭SIP中的所有防护，不推荐：  
csr-active-config=0x07ff  
在非必要的情况下，不要把提供的这些保护全部关闭。  
-> 10.13下仅关闭Kext User Consent功能：  
csr-active-config=0x200 (在Recovery OS下运行 spctl kext-consent disable)

## BooterConfig  
至于系统启动标志位，即Clover的config.plist中BooterConfig的含义：  
举例：  
-> Raw Data: BooterConfig=0x49  
0x0049 = 0b 00000000 01001001  
每个标志位的含义，上方从右至左9个标志位以bit 0 - bit 9表示：  
_ ____ ___1 (bit 0): RebootOnPanic，遇到内核崩溃自动重启  
_ ____ __1_ (bit 1): HiDPI，在启动过程中使用HiDPI模式显示  
_ ____ _1__ (bit 2): Black，在启动过程中不显示进度条  
_ ____ 1___ (bit 3): CSRActiveConfig，将读取当前生效的SIP控制标志位  
_ ___1 ____ (bit 4): CSRConfigMode，仅用于Recovery/安装环境，将允许对SIP进行配置  
_ __1_ ____ (bit 5): CSRBoot，仅用于Recovery/安装环境，SIP将完全禁用  
_ _1__ ____ (bit 6): BlackBg，在启动过程中使用黑色背景  
_ 1___ ____ (bit 7): LoginUI，登陆界面，用于FileVault解锁  
1 ____ ____ (bit 8): InstallUI，安装进度条界面，用于系统安装/升级  
复制代码  
把需要的打开的启动标志位设置为1即可。通过Clover设置BooterConfig可能需要机器支持原生NVRAM读写方可生效。如无特殊需要可以不在config.plist中添加此项。