From patchwork Mon Mar 25 13:39:55 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?G=C3=BCnther_Noack?= X-Patchwork-Id: 13602233 Received: from mail-ed1-f74.google.com (mail-ed1-f74.google.com [209.85.208.74]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 341D5757F5 for ; Mon, 25 Mar 2024 13:40:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.74 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711374013; cv=none; b=o2mGnrW/5oNUngHdG2caAjMJRDLn8rqKptRL3wv0GRI01IbUxkan0PjTIKzBgAzA3X1gOyIkcjbqLgh2kAAAf7xYhFS5Aj+a3uDdcio82VWnX0RQewgkvhtXA9GO3KPpWfoLttypPTMAMDHTxR8n67miu9qcZkScGh53I1nEW5I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711374013; c=relaxed/simple; bh=qts/Tfv6dh4hHSiFOZ2qFsIOiGCg7wJ7diZBp+S8iQc=; h=Date:Mime-Version:Message-ID:Subject:From:To:Cc:Content-Type; b=baocpt6FZdyQiEjBQwu57rzBsHxb58DmiGq3Y/ZxI65V3RAtuAMq/xS5mo0hqisHD55ql4z4pr1X5Le9oG7HF8I3AwdYERl5VzSZUYApvrqismET+fGPx65LjEKOsNT87Bp3WlzAGD5ZhLudSYL94HuEoDW2m0RsIbABieHt6lg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--gnoack.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=LhFVY2yI; arc=none smtp.client-ip=209.85.208.74 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--gnoack.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="LhFVY2yI" Received: by mail-ed1-f74.google.com with SMTP id 4fb4d7f45d1cf-56c0d3517deso799090a12.0 for ; Mon, 25 Mar 2024 06:40:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1711374008; x=1711978808; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:from:subject:message-id :mime-version:date:from:to:cc:subject:date:message-id:reply-to; bh=ratRYSdSBe2bypSrS48wUC41PqULpHaSEWYlIhspDj4=; b=LhFVY2yIo1vIc799GdI5YlQu2W8rVVXrBwIunrkPBk5SKFIsV8rwWyXWqEUqQgazbd e6UmsPCWAcG2oj131aI1hsbKX73UD3ldCopJOHxcygvpjoB/6CyJ/grJlyapsIqA6ph9 2C+fs2YLp3WkJS+jQUefjfczxVnR5ZNsnT5qem6RsTutiS57PTkNJh2tyLyRpf+ywZe+ y2M9y32+ggvJ8Us9RrsTRmnBAaEYkqbAE7tURZvFb9QwIlnP3KTUPdWlSJp8/GvLNqmq d+sM66hBXG4m0symAdJ9H5esAg7grDo4dAQo8knZ5lCUIz/zpPbkmxdXEdsv7CLcS9+m AFSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711374008; x=1711978808; h=content-transfer-encoding:cc:to:from:subject:message-id :mime-version:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=ratRYSdSBe2bypSrS48wUC41PqULpHaSEWYlIhspDj4=; b=VI7vRp3erLDHUKlOAEfcEy+OJhZImuuU0Oxd3Zn1TX89RgarWxFJrvpfC7ITBdTI+b OHJMjJWFyzb+Wvu9P15UwJB/bKO1ksVeCYnNoLxmvfFeYg6DCRfueQdufGDZcaVX8cto e0g4XcY57OiioujvaJO3m7XTCxIWC3aTT3TEIsgk4daQiKpGdVdv/zDTN3RvfIzbHHg0 OILf+msnRKXW+T7ETF2mJ/z/yXM/BNpdZbFLmc/IYohGDdxAsF0tkriAwAIX2K69Im6r ailAWCXWNEhT1CbwlGO1/5tb7l99Yar24raWx2aC+fBjMDNMxMntLa44r4ILK5t/wU7Z gOKQ== X-Gm-Message-State: AOJu0Yybs9sn4gGJmbhvKmmivVRLXyRfXVuJO3r+b+oUO0amIv+5dfaq zC6scEzzf8BBk2xyF+hQaj9i2HSgr3LMxld/HH51VCn0O2kAYKV7abh5Z+RLTaQXRY5aiJgkNqM YFVvzxbH3zt4hP/lcHAHQs8Mg2oG8CKIP3ZZ8TnbiWqd371z4Ea1SMLuCIfNXOJjMpWxE+6GSgb OQRxkLM9zLB7LLIzM4nFxfhFOEDF/eUSIDV9KAUO86NCTO41ZW3mOo X-Google-Smtp-Source: AGHT+IHpeoEg2FsOcizED1nqVPJHbjQNBRwFMbV8WfQZ9CN5NFnrUElcBEPLK1gmA6zFaWy5wtH601U46DE= X-Received: from swim.c.googlers.com ([fda3:e722:ac3:cc00:31:98fb:c0a8:1605]) (user=gnoack job=sendgmr) by 2002:a05:6402:350b:b0:56c:122a:8c81 with SMTP id b11-20020a056402350b00b0056c122a8c81mr28696edd.1.1711374008221; Mon, 25 Mar 2024 06:40:08 -0700 (PDT) Date: Mon, 25 Mar 2024 13:39:55 +0000 Precedence: bulk X-Mailing-List: linux-security-module@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 X-Mailer: git-send-email 2.44.0.396.g6e790dbe36-goog Message-ID: <20240325134004.4074874-1-gnoack@google.com> Subject: [PATCH v12 0/9] Landlock: IOCTL support From: " =?utf-8?q?G=C3=BCnther_Noack?= " To: linux-security-module@vger.kernel.org, " =?utf-8?q?Micka=C3=ABl_Sala?= =?utf-8?q?=C3=BCn?= " Cc: Jeff Xu , Arnd Bergmann , Jorge Lucangeli Obes , Allen Webb , Dmitry Torokhov , Paul Moore , Konstantin Meskhidze , Matt Bobrowski , linux-fsdevel@vger.kernel.org, " =?utf-8?q?G=C3=BCnther_Noack?= " Hello! These patches add simple ioctl(2) support to Landlock. Objective ~~~~~~~~~ Make ioctl(2) requests restrictable with Landlock, in a way that is useful for real-world applications. Proposed approach ~~~~~~~~~~~~~~~~~ Introduce the LANDLOCK_ACCESS_FS_IOCTL_DEV right, which restricts the use of ioctl(2) on block and character devices. We attach the this access right to opened file descriptors, as we already do for LANDLOCK_ACCESS_FS_TRUNCATE. If LANDLOCK_ACCESS_FS_IOCTL_DEV is handled (restricted in the ruleset), the LANDLOCK_ACCESS_FS_IOCTL_DEV right governs the use of all device-specific IOCTL commands. We make exceptions for common and known-harmless IOCTL commands such as FIOCLEX, FIONCLEX, FIONBIO and FIOASYNC, as well as other IOCTL commands for regular files, which are implemented in fs/ioctl.c. A full list of these IOCTL commands is listed in the documentation. I believe that this approach works for the majority of use cases, and offers a good trade-off between complexity of the Landlock API and implementation and flexibility when the feature is used. Current limitations ~~~~~~~~~~~~~~~~~~~ With this patch set, ioctl(2) requests can *not* be filtered based on file type, device number (dev_t) or on the ioctl(2) request number. On the initial RFC patch set [1], we have reached consensus to start with this simpler coarse-grained approach, and build additional IOCTL restriction capabilities on top in subsequent steps. [1] https://lore.kernel.org/linux-security-module/d4f1395c-d2d4-1860-3a02-2a0c023dd761@digikod.net/ Notable implications of this approach ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * A processes' existing open file descriptors stay unaffected when a process enables Landlock. This means in particular that in common scenarios, the terminal's IOCTLs (ioctl_tty(2)) continue to work. * ioctl(2) continues to be available for file descriptors for non-device files. Example: Network sockets, memfd_create(2). Examples ~~~~~~~~ Starting a sandboxed shell from $HOME with samples/landlock/sandboxer: LL_FS_RO=/ LL_FS_RW=. ./sandboxer /bin/bash The LANDLOCK_ACCESS_FS_IOCTL_DEV right is part of the "read-write" rights here, so we expect that newly opened files outside of $HOME don't work with most IOCTL commands. * "stty" works: It probes terminal properties * "stty unlocked_ioctl or f_ops->compat_ioctl. * The only change compared to V11 is commit 1, as well as a small adaptation in the commit 2 (The Landlock implementation needs to return the new special value). The tests and documentation commits are exactly the same as before. V11: * Rebased on Mickaël's proposal to refactor fs/ioctl.c: https://lore.kernel.org/all/20240315145848.1844554-1-mic@digikod.net/ This means that: * we do not add the file_vfs_ioctl() hook as in V10 * we add vfs_get_ioctl_handler() instead, so that Landlock can query which of the IOCTL commands in handled in do_vfs_ioctl() That proposal is used here unmodified (except for minor typos in the commit description). * Use the hook_ioctl_compat LSM hook as well. V10: * Major change: only restrict IOCTL invocations on device files * Rename access right to LANDLOCK_ACCESS_FS_IOCTL_DEV * Remove the notion of synthetic access rights and IOCTL right groups * Introduce a new LSM hook file_vfs_ioctl, which gets invoked just before the call to f_ops->unlocked_ioctl() * Documentation * Various complications were removed or simplified: * Suggestion to mount file systems as nodev is not needed any more, as Landlock already lets users distinguish device files. * Remarks about fscrypt were removed. The fscrypt-related IOCTLs only applied to regular files and directories, so this patch does not affect them any more. * Various documentation of the IOCTL grouping approach was removed, as it's not needed any more. V9: * in “landlock: Add IOCTL access right”: * Change IOCTL group names and grouping as discussed with Mickaël. This makes the grouping coarser, and we occasionally rely on the underlying implementation to perform the appropriate read/write checks. * Group IOCTL_RW (one of READ_FILE, WRITE_FILE or READ_DIR): FIONREAD, FIOQSIZE, FIGETBSZ * Group IOCTL_RWF (one of READ_FILE or WRITE_FILE): FS_IOC_FIEMAP, FIBMAP, FIDEDUPERANGE, FICLONE, FICLONERANGE, FS_IOC_RESVSP, FS_IOC_RESVSP64, FS_IOC_UNRESVSP, FS_IOC_UNRESVSP64, FS_IOC_ZERO_RANGE * Excempt pipe file descriptors from IOCTL restrictions, even for named pipes which are opened from the file system. This is to be consistent with anonymous pipes created with pipe(2). As discussed in https://lore.kernel.org/r/ZP7lxmXklksadvz+@google.com * Document rationale for the IOCTL grouping in the code * Use __attribute_const__ * Rename required_ioctl_access() to get_required_ioctl_access() * Selftests * Simplify IOCTL test fixtures as a result of simpler grouping. * Test that IOCTLs are permitted on named pipe FDs. * Test that IOCTLs are permitted on named Unix Domain Socket FDs. * Work around compilation issue with old GCC / glibc. https://sourceware.org/glibc/wiki/Synchronizing_Headers Thanks to Huyadi , who pointed this out in https://lore.kernel.org/all/f25be6663bcc4608adf630509f045a76@h3c.com/ and Mickaël, who fixed it through #include reordering. * Documentation changes * Reword "IOCTL commands" section a bit * s/permit/allow/ * s/access right/right/, if preceded by LANDLOCK_ACCESS_FS_* * s/IOCTL/FS_IOCTL/ in ASCII table * Update IOCTL grouping documentation in header file * Removed a few of the earlier commits in this patch set, which have already been merged. V8: * Documentation changes * userspace-api/landlock.rst: * Add an extra paragraph about how the IOCTL right combines when used with other access rights. * Explain better the circumstances under which passing of file descriptors between different Landlock domains can happen * limits.h: Add comment to explain public vs internal FS access rights * Add a paragraph in the commit to explain better why the IOCTL right works as it does V7: * in “landlock: Add IOCTL access right”: * Make IOCTL_GROUPS a #define so that static_assert works even on old compilers (bug reported by Intel about PowerPC GCC9 config) * Adapt indentation of IOCTL_GROUPS definition * Add missing dots in kernel-doc comments. * in “landlock: Remove remaining "inline" modifiers in .c files”: * explain reasoning in commit message V6: * Implementation: * Check that only publicly visible access rights can be used when adding a rule (rather than the synthetic ones). Thanks Mickaël for spotting that! * Move all functionality related to IOCTL groups and synthetic access rights into the same place at the top of fs.c * Move kernel doc to the .c file in one instance * Smaller code style issues (upcase IOCTL, vardecl at block start) * Remove inline modifier from functions in .c files * Tests: * use SKIP * Rename 'fd' to dir_fd and file_fd where appropriate * Remove duplicate "ioctl" mentions from test names * Rename "permitted" to "allowed", in ioctl and ftruncate tests * Do not add rules if access is 0, in test helper V5: * Implementation: * move IOCTL group expansion logic into fs.c (implementation suggested by mic) * rename IOCTL_CMD_G* constants to LANDLOCK_ACCESS_FS_IOCTL_GROUP* * fs.c: create ioctl_groups constant * add "const" to some variables * Formatting and docstring fixes (including wrong kernel-doc format) * samples/landlock: fix ABI version and fallback attribute (mic) * Documentation * move header documentation changes into the implementation commit * spell out how FIFREEZE, FITHAW and attribute-manipulation ioctls from fs/ioctl.c are handled * change ABI 4 to ABI 5 in some missing places V4: * use "synthetic" IOCTL access rights, as previously discussed * testing changes * use a large fixture-based test, for more exhaustive coverage, and replace some of the earlier tests with it * rebased on mic-next V3: * always permit the IOCTL commands FIOCLEX, FIONCLEX, FIONBIO, FIOASYNC and FIONREAD, independent of LANDLOCK_ACCESS_FS_IOCTL * increment ABI version in the same commit where the feature is introduced * testing changes * use FIOQSIZE instead of TTY IOCTL commands (FIOQSIZE works with regular files, directories and memfds) * run the memfd test with both Landlock enabled and disabled * add a test for the always-permitted IOCTL commands V2: * rebased on mic-next * added documentation * exercise ioctl(2) in the memfd test * test: Use layout0 for the test --- V1: https://lore.kernel.org/linux-security-module/20230502171755.9788-1-gnoack3000@gmail.com/ V2: https://lore.kernel.org/linux-security-module/20230623144329.136541-1-gnoack@google.com/ V3: https://lore.kernel.org/linux-security-module/20230814172816.3907299-1-gnoack@google.com/ V4: https://lore.kernel.org/linux-security-module/20231103155717.78042-1-gnoack@google.com/ V5: https://lore.kernel.org/linux-security-module/20231117154920.1706371-1-gnoack@google.com/ V6: https://lore.kernel.org/linux-security-module/20231124173026.3257122-1-gnoack@google.com/ V7: https://lore.kernel.org/linux-security-module/20231201143042.3276833-1-gnoack@google.com/ V8: https://lore.kernel.org/linux-security-module/20231208155121.1943775-1-gnoack@google.com/ V9: https://lore.kernel.org/linux-security-module/20240209170612.1638517-1-gnoack@google.com/ V10: https://lore.kernel.org/linux-security-module/20240309075320.160128-1-gnoack@google.com/ V11: https://lore.kernel.org/linux-security-module/20240322151002.3653639-1-gnoack@google.com/ Günther Noack (9): security: Introduce ENOFILEOPS return value for IOCTL hooks landlock: Add IOCTL access right for character and block devices selftests/landlock: Test IOCTL support selftests/landlock: Test IOCTL with memfds selftests/landlock: Test ioctl(2) and ftruncate(2) with open(O_PATH) selftests/landlock: Test IOCTLs on named pipes selftests/landlock: Check IOCTL restrictions for named UNIX domain sockets samples/landlock: Add support for LANDLOCK_ACCESS_FS_IOCTL_DEV landlock: Document IOCTL support Documentation/userspace-api/landlock.rst | 76 +++- fs/ioctl.c | 25 +- include/linux/security.h | 6 + include/uapi/linux/landlock.h | 35 +- samples/landlock/sandboxer.c | 13 +- security/landlock/fs.c | 45 ++- security/landlock/limits.h | 2 +- security/landlock/syscalls.c | 8 +- security/security.c | 10 +- tools/testing/selftests/landlock/base_test.c | 2 +- tools/testing/selftests/landlock/fs_test.c | 405 ++++++++++++++++++- 11 files changed, 576 insertions(+), 51 deletions(-) base-commit: a17c60e533f5cd832e77e0d194e2e0bb663371b6