MuntashirAkon/AppManager · error

The IBinder provided is invalid

Error message

The IBinder provided is invalid

What it means

FileSystemManager.createRemote(IBinder) wraps a binder to a remote IFileSystemService. Stub.asInterface(b) returns null if the binder is null or not a valid local/remote binder handle; in that case the method throws IllegalArgumentException("The IBinder provided is invalid"). This guards against using dead, bogus, or wrong-process binder objects.

Source

Thrown at libcore/io/src/main/java/io/github/muntashirakon/io/NIOFactory.java:87

                        // without truncating. Forced to open rw RAF in all cases.
                        FileChannel ch = new RandomAccessFile(file, "rw").getChannel();
                        if (f.truncate) {
                            ch.truncate(0);
                        }
                        return ch;
                    } else {
                        return new FileInputStream(file).getChannel();
                    }
                }
            }
        };
    }

    public static FileSystemManager createRemote(@NonNull IBinder b) throws RemoteException {
        Objects.requireNonNull(b);
        IFileSystemService fs = IFileSystemService.Stub.asInterface(b);
        if (fs == null) {
            throw new IllegalArgumentException("The IBinder provided is invalid");
        }

        fs.register(new Binder());
        return new FileSystemManager() {
            @NonNull
            @Override
            public ExtendedFile getFile(@NonNull String pathname) {
                return new RemoteFile(fs, pathname);
            }

            @NonNull
            @Override
            public ExtendedFile getFile(@Nullable String parent, @NonNull String child) {
                return new RemoteFile(fs, parent, child);
            }

            @NonNull
            @Override

View on GitHub (pinned to 0152f468fc)

Solutions

1. Verify the bind to IFileSystemService succeeded (onServiceConnected) and pass that fresh binder
2. Catch IllegalArgumentException and rebind/retry obtaining the service binder
3. Confirm the binder actually implements IFileSystemService (correct AIDL interface and package)

Example fix

// before
FileSystemManager fm = FileSystemManager.createRemote(staleBinder); // IllegalArgumentException
// after
if (binder == null || !binder.isBinderAlive() || !binder.pingBinder()) {
    binder = bindFileServiceAndWait(); // rebind
}
FileSystemManager fm = FileSystemManager.createRemote(binder);

if (binder == null || !binder.pingBinder()) { throw new IllegalStateException("bind the IFileSystemService before createRemote"); }

boolean isValidServiceBinder(IBinder b) { return b != null && b.pingBinder() && IFileSystemService.Stub.asInterface(b) != null; }

try { fm = FileSystemManager.createRemote(binder); } catch (IllegalArgumentException e) { /* rebind service and retry */ }

When it happens

Trigger: Passing a null IBinder (requireNonNull also triggers), a Binder that has died or was never bound, or an IBinder obtained from the wrong service/component so IFileSystemService.Stub.asInterface yields null.

Common situations: Binding to the remote file service failed or the service was killed before createRemote was called; caching a binder across service restarts; passing the wrong service's binder (type confusion between AIDL interfaces).

Understand the failure class

Background: "Must be a positive integer", "Invalid value", "Unsupported": the invalid-argument-value error family, when a library rejects the value you pass — this error's family across 35 libraries.

Related errors

• IOException(REMOTE_ERR_MSG, throwable)
• IOException(remoteException)
• Data directory cannot be empty.
• Failed to restore ADB data
• Could not cache splits

AI-assisted analysis of MuntashirAkon/AppManager@0152f468fc (2026-09-12). Data as JSON: /api/errors/eb18652194a769f9. Report an issue: GitHub.