From 5b2716e94b4cd7c07733a8a486acf50e1817a657 Mon Sep 17 00:00:00 2001
From: Nick Chan <towinchenmi@gmail.com>
Date: Wed, 27 May 2026 09:33:31 +0800
Subject: [PATCH] update help and documentation

---
 docs/palera1n.1 | 15 ++++++++++++---
 src/optparse.c  |  6 ++++--
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/docs/palera1n.1 b/docs/palera1n.1
index 9b209b4..59400f0 100644
--- a/docs/palera1n.1
+++ b/docs/palera1n.1
@@ -1,12 +1,12 @@
 .\"-
-.\" Copyright (c) 2024 Nick Chan
+.\" Copyright (c) 2026 Nick Chan
 .\" SPDX-License-Identifier: MIT
 .\"
 .Dd "23 December 2024"
 .Dt palera1n 1
 .Sh NAME
 .Nm palera1n
-.Nd arm64 iOS/iPadOS/tvOS 15.0-26.0, bridgeOS 5.0-10.0 jailbreaking tool
+.Nd arm64 iOS/iPadOS/tvOS 15-26, bridgeOS 5-10 jailbreaking tool
 .Sh SYNOPSIS
 .Nm
 .Op Fl cCdDEfhIlLnpRsSTvV
@@ -18,9 +18,10 @@
 .Op Fl i Ar checkra1n file
 .Op Fl -version
 .Op Fl -force-revert
+.Op Fl -override-libcheckra1nhelper Ar hook dylib
 .Sh DESCRIPTION
 .Nm
-jailbreaks an arm64 (arm64e excluded) iOS/iPadOS/tvOS 15.0-26.0, bridgeOS 5.0-10.0 device,
+jailbreaks an arm64 (arm64e excluded) iOS/iPadOS/tvOS 15-26, bridgeOS 5-10 device,
 utilizing the
 .Em checkm8
 bootROM exploit.
@@ -168,6 +169,10 @@ Proceed in rootful mode. Despite its name, this applies to both full, partial fa
 Prints help text.
 .It Fl i , -checkra1n-file Ar checkra1n file
 Specify the path to a custom checkra1n file.
+On Apple platforms this will disable the built-in checkra1n helper.
+A custom one may still be specified with
+.Fl -override-libcheckra1nhelper
+\[char46]
 .It Fl k , -override-pongo Ar pongo file
 Override PongoOS image. The raw image, named
 .Em Pongo.bin
@@ -222,6 +227,10 @@ Enable debug logging. The option may be repeated for extra verbosity.
 Boots the device in verbose mode, allowing boot logs to be seen.
 .It Fl I , -device-info
 Prints info about device and exits.
+.It Fl -override-libcheckra1nhelper Ar hook dylib
+(Apple platforms only) Specify a custom dylib to insert into checkra1n via
+.Em DYLD_INSERT_LIBRARIES
+\[char46]
 .El
 .Sh ENVIRONMENTAL VARIABLES
 .Bl -tag -width -indent
diff --git a/src/optparse.c b/src/optparse.c
index 5220116..7f47db0 100644
--- a/src/optparse.c
+++ b/src/optparse.c
@@ -78,7 +78,7 @@ static int usage(int e, char* prog_name)
 #endif
 			"] [-e boot arguments] [-k Pongo image] [-o overlay file] [-r ramdisk file] [-K KPF file] [-i checkra1n file]\n"
 			"Copyright (C) 2024, palera1n team, All Rights Reserved.\n\n"
-			"iOS/iPadOS/tvOS 15.0-26.0, bridgeOS 5.0-10.0 arm64 jailbreaking tool\n\n"
+			"iOS/iPadOS/tvOS 15-26, bridgeOS 5-10 arm64 jailbreaking tool\n\n"
 			"\t--version\t\t\t\tPrint version\n"
 			"\t--force-revert\t\t\t\tRemove jailbreak\n"
 #ifdef DEV_BUILD
@@ -122,6 +122,9 @@ static int usage(int e, char* prog_name)
 #ifdef TUI
 			"\t-t, --tui\t\t\t\tForce interactive TUI\n"
 			"\t--cli\t\t\t\t\tForce cli mode\n"
+#endif
+#if defined(__APPLE__)
+			"\t--override-libcheckra1nhelper <file>\tCustom checkra1n hook dylib\n"
 #endif
 		"\nEnvironmental variables:\n"
 		"\tTMPDIR\t\ttemporary diretory (path the built-in checkra1n will be extracted to)\n"
@@ -329,7 +332,6 @@ int optparse(int argc, char* argv[]) {
 			palerain_flags |= palerain_option_palerain_version;
 			break;
 		case palerain_option_case_libcheckra1nhelper_path:
-			printf("meow\n");
 			gOverrideLibcheckra1nHelper = calloc(1, strlen(optarg) + 1);
 			if (!gOverrideLibcheckra1nHelper) {
 				return -1;