Skip to content

Commit 8d40168

Browse files
committed
Update documentation
1 parent df636c1 commit 8d40168

File tree

2 files changed

+9
-22
lines changed

2 files changed

+9
-22
lines changed

docs/palera1n.1

Lines changed: 7 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
.\" Copyright (c) 2024 Nick Chan
33
.\" SPDX-License-Identifier: MIT
44
.\"
5-
.Dd "30 March 2024"
5+
.Dd "24 July 2024"
66
.Dt palera1n 1
77
.Sh NAME
88
.Nm palera1n
@@ -155,17 +155,13 @@ Set the effective production fuse to 0, so as to enable hardware debugging featu
155155
Execute the DFU helper to guide the user into putting the device into DFU mode
156156
then exit.
157157
.It Fl e , -boot-args Ar boot arguments
158-
Specify custom XNU kernel command line. The
159-
.Em rootdev=md0
160-
argument is used by
161-
.Nm
162-
and cannot be overriden. Additionally, the
158+
Specify custom XNU kernel command line. Additionally, the
163159
.Em wdt=-1
164160
argument is used during fakefs setup.
165161
.It Fl E , -enter-recovery
166162
Exit after entering recovery mode.
167163
.It Fl f , -fakefs
168-
Proceed in rootful mode. This applies to both full, partial fakefs, as well as realfs.
164+
Proceed in rootful mode. Despite its name, this applies to both full, partial fakefs, as well as realfs, and it still applies even when trying to force revert.
169165
.It Fl h , -help
170166
Prints help text.
171167
.It Fl i , -checkra1n-file Ar checkra1n file
@@ -183,10 +179,6 @@ command. If in doubt, use
183179
iOS15 branch or your own fork of it.
184180
.It Fl l , -rootless
185181
Proceed in rootless mode. This option is only supported on iOS/iPadOS.
186-
.It Fl L , -jbinit-log-to-file
187-
This option is not currently supported and is a no-operation in this version of
188-
.Nm
189-
\[char46]
190182
.It Fl n , -exit-recovery
191183
Exit recovery mode and exit.
192184
.It Fl o , -override-overlay Ar overlay file
@@ -241,13 +233,13 @@ is extracted and executed here. When not set, /tmp is used.
241233
.Sh EXAMPLES
242234
To (re-)jailbreak in rootless mode:
243235
.Pp
244-
.Dl "palera1n"
236+
.Dl "palera1n -l"
245237
.Pp
246238
To setup fakefs for rootful mode:
247239
.Pp
248240
.Dl "palera1n -fc"
249241
.Pp
250-
After the device has rebooted, follow the following example.
242+
After the device has rebooted into recovery mode, follow the following example.
251243
.Pp
252244
To re-jailbreak in rootful mode:
253245
.Pp
@@ -304,7 +296,7 @@ option might cause some versions for tvOS to crash and not boot.
304296
Offical Apple USB-C cables as well as some other USB-C cables cannot be used to enter DFU mode.
305297
USB-A cable with male USB-C to female USB-A adapter works fine.
306298
.Sh POST INSTALLATION (iOS/iPadOS)
307-
The palera1n loader app will take up to 30 seconds to appear on the homescreen after the
299+
The palera1n loader app will take up to 1 minute to appear on the homescreen after the
308300
device has booted. If it does not appear, you can try using the shortcut:
309301
.Pp
310302
.Lk https://www.icloud.com/shortcuts/8cd5f489c8854ee0ab9ee38f2e62f87d
@@ -332,7 +324,7 @@ loader app to install additional jailbreak files.
332324

333325
.Bl -tag -width "/var/jb/Library/LaunchDaemons"
334326
.It Pa /cores
335-
The location of the temporary filesystem where jailbreak files are stash during boot.
327+
The location of the temporary filesystem where jailbreak files are stashed during boot.
336328
.It Pa /Library/LaunchDaemons
337329
The directory where jailbreak-specific
338330
.Xr launchd.plist 5
@@ -358,8 +350,6 @@ may crash if the machine it is running on:
358350
.Pp
359351
The exploit may also work less reliably on some hosts, like AMD desktops, or some MediaTek devices.
360352
.Pp
361-
The device may randomly crash and reboot due to launchd using too much memory.
362-
.Pp
363353
The built-in SSH server might be not accessible with password after bootstrapping rootful,
364354
since the bootstrap uses a custom crypt() function that is not supported
365355
by the built-in SSH server.

src/optparse.c

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ static int usage(int e, char* prog_name)
7878
#endif
7979
"] [-e boot arguments] [-k Pongo image] [-o overlay file] [-r ramdisk file] [-K KPF file] [-i checkra1n file]\n"
8080
"Copyright (C) 2024, palera1n team, All Rights Reserved.\n\n"
81-
"iOS/iPadOS/tvOS 15.0-17.5, bridgeOS 5.0-8.3 arm64 jailbreaking tool\n\n"
81+
"iOS/iPadOS/tvOS 15.0-18.0, bridgeOS 5.0-9.0 arm64 jailbreaking tool\n\n"
8282
"\t--version\t\t\t\tPrint version\n"
8383
"\t--force-revert\t\t\t\tRemove jailbreak\n"
8484
#ifdef DEV_BUILD
@@ -181,10 +181,7 @@ int optparse(int argc, char* argv[]) {
181181
#endif
182182
break;
183183
case 'e':
184-
if (strstr(optarg, "rootdev=") != NULL) {
185-
LOG(LOG_FATAL, "The boot arg rootdev= is already used by palera1n and cannot be overriden");
186-
return -1;
187-
} else if (strlen(optarg) > (sizeof(xargs_cmd) - 0x20)) {
184+
if (strlen(optarg) > (sizeof(xargs_cmd) - 0x20)) {
188185
LOG(LOG_FATAL, "Boot arguments too long");
189186
return -1;
190187
}

0 commit comments

Comments
 (0)