From patchwork Wed Jan 25 15:28:53 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexey Gladkov X-Patchwork-Id: 48194 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp346633wrn; Wed, 25 Jan 2023 07:55:59 -0800 (PST) X-Google-Smtp-Source: AK7set+DikZG2YUYTjfXq/rWlA4h4XEDmgJtF4WN4XUjhJ8ZuFoi3D0flaC+kQe60aCNVdkvKrHf X-Received: by 2002:a17:903:1108:b0:196:12f1:76f5 with SMTP id n8-20020a170903110800b0019612f176f5mr7366963plh.52.1674662159261; Wed, 25 Jan 2023 07:55:59 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674662159; cv=none; d=google.com; s=arc-20160816; b=R30ACWlLGItzEf3maxcIqgoMKyuUwxdUsGihTfDzvkxwAO4p4XfBbPTd42rMZy+R7i dkOBgGR32k4MB/PRysrSyxuiq+LStxgPXD9GJdcGO8JCe0E47qUu9vM+eDOMemIpJbr0 Ek9E9Z0YBZMAl5jKWaqRHZHQlwmco1AWO6LseEQv5i3Gj38wpdDTYb9KKSZkqeGBldcG Za+kSVptFOGb+L6lMey1oaKMl4dq5nYzuP7HR4AmgWciirmCgOCRT5v8e/gXqNtcWfOv dMpJsEY1zcfYP1lKXdrBiMDxDqsk+cxw4tPHGlsu/XXpOduln0TcrShCLKTgJtsca5Y5 mE4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=v1V84e0aGOmID6b7Zl/EdtLePOodNQQZKlfDOW2ldFo=; b=lpRCfaC4EcuCWBxWFFI6XOwKCaXKKtl0ELNBSnHsSJsrd8J6LUVh87GXsPrMimllkb XHx7TC7sUVQ871h2eZY3+qkush33rCy6FL3ZQfnAp3nEqfTf9UuwqzDBKyODLmRsuqOA R9H/6tk9t9/tCrb7rGdWkz8WnOI3HHKfMK1WccI1TVrEYN+sdg7vSgD5u4tuAVxHbCJN 2WdDgzre4I7Hhxl+fL1Rck06N64rpN9DK1/cpGvwnZftUdzFrcFCa7hsB5SUHLyN5yuD QXnnI7ImfTto1C3MjCfHtDsccuCNgGgThBabbEfrr0isbB408FA75NchbLeUOPYq2Pd+ AsCA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id c1-20020a170903234100b00186989178b0si6750388plh.132.2023.01.25.07.55.46; Wed, 25 Jan 2023 07:55:59 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236066AbjAYPaE (ORCPT + 99 others); Wed, 25 Jan 2023 10:30:04 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51790 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236050AbjAYP3u (ORCPT ); Wed, 25 Jan 2023 10:29:50 -0500 Received: from us-smtp-delivery-44.mimecast.com (us-smtp-delivery-44.mimecast.com [205.139.111.44]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0024E59B63 for ; Wed, 25 Jan 2023 07:29:42 -0800 (PST) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-554-J2YxgZukPJadicB8_9FLOw-1; Wed, 25 Jan 2023 10:29:38 -0500 X-MC-Unique: J2YxgZukPJadicB8_9FLOw-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 97A4E800B30; Wed, 25 Jan 2023 15:29:37 +0000 (UTC) Received: from comp-core-i7-2640m-0182e6.redhat.com (ovpn-208-16.brq.redhat.com [10.40.208.16]) by smtp.corp.redhat.com (Postfix) with ESMTP id D290B2026D4B; Wed, 25 Jan 2023 15:29:35 +0000 (UTC) From: Alexey Gladkov To: LKML , containers@lists.linux.dev, linux-fsdevel@vger.kernel.org Cc: Alexey Dobriyan , Al Viro , Andrew Morton , Christian Brauner , Val Cowan Subject: [RFC PATCH v1 6/6] doc: proc: Add description of subset=allowlist Date: Wed, 25 Jan 2023 16:28:53 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.4 X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW, SPF_HELO_NONE,SPF_SOFTFAIL autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1756010548149005403?= X-GMAIL-MSGID: =?utf-8?q?1756010548149005403?= Signed-off-by: Alexey Gladkov --- Documentation/filesystems/proc.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/filesystems/proc.rst b/Documentation/filesystems/proc.rst index e224b6d5b642..c2598bca8193 100644 --- a/Documentation/filesystems/proc.rst +++ b/Documentation/filesystems/proc.rst @@ -2213,6 +2213,16 @@ information about processes information, just add identd to this group. subset=pid hides all top level files and directories in the procfs that are not related to tasks. +subset=allowlist allows you to specify a list of files and directories to +which you want to provide access. If the option is specified, then the +/proc/allowlist will appear at the top level of the filesystem. By default, this +file contains only its name. The user can add or remove other filenames and +directories. To prohibit editing the allowlist, you need to exclude its name +from the list of allowed ones. + +Different subset= option arguments can be combined using the plus(+) delimiter. +For example: subset=pid+allowlist + Chapter 5: Filesystem behavior ==============================