From patchwork Thu Dec 3 20:00:01 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eric Sandeen X-Patchwork-Id: 11949503 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-18.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1A13CC433FE for ; Thu, 3 Dec 2020 20:01:32 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B94E5221F4 for ; Thu, 3 Dec 2020 20:01:31 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728803AbgLCUBb (ORCPT ); Thu, 3 Dec 2020 15:01:31 -0500 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:27827 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728042AbgLCUBb (ORCPT ); Thu, 3 Dec 2020 15:01:31 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1607025604; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mKTP0oyzoYb7yupQzdNzg8iCPWee6xdEpgVHW9tAXms=; b=D4QOBZ/BGXrIeZTeunPnS0oyRsWmqrXiNTKKmKV1scWnakb5ACRfxeyBJlEqCvNzxz/40j i9RkVKwwzIpXg7qWc6MD4Yx45xRC0icCflmT4KgVIFmELZk4QwwVu3Sw5CWfP2e4hSLZ7T nLljN0zEIN5S7OGhsKG3jjW9yIlUWgM= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-483-tDYoJwP9NZCKnntdM99NQw-1; Thu, 03 Dec 2020 15:00:02 -0500 X-MC-Unique: tDYoJwP9NZCKnntdM99NQw-1 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id AC5128144E2 for ; Thu, 3 Dec 2020 20:00:01 +0000 (UTC) Received: from liberator.sandeen.net (ovpn04.gateway.prod.ext.phx2.redhat.com [10.5.9.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7E858100AE34 for ; Thu, 3 Dec 2020 20:00:01 +0000 (UTC) Subject: [PATCH 1/3] xfs_quota: document how the default quota is stored From: Eric Sandeen To: xfs References: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Message-ID: <2e9b1d0f-7ad8-b42a-ac2b-b1fdd9a9fb45@redhat.com> Date: Thu, 3 Dec 2020 14:00:01 -0600 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Content-Language: en-US X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Precedence: bulk List-ID: X-Mailing-List: linux-xfs@vger.kernel.org Nowhere in the man page is the default quota described; what it does or where it is stored. Add some brief information about this. Signed-off-by: Eric Sandeen --- man/man8/xfs_quota.8 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index dd0479cd..b3c4108e 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -178,6 +178,11 @@ to a file on where the user's quota has not been exceeded. Then after rectifying the quota situation, the file can be moved back to the filesystem it belongs on. +.SS Default Quotas +The XFS quota subsystem allows a default quota to be enforced for any user which +does not have a quota limit explicitly set. These limits are stored in and +displayed as the "root" user's limits, although they do not actually limit the +root user. .SH USER COMMANDS .TP .B print From patchwork Thu Dec 3 20:00:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eric Sandeen X-Patchwork-Id: 11949505 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-18.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id AF629C433FE for ; Thu, 3 Dec 2020 20:02:22 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 62A1A221F4 for ; Thu, 3 Dec 2020 20:02:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726915AbgLCUCW (ORCPT ); Thu, 3 Dec 2020 15:02:22 -0500 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:29648 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726681AbgLCUCV (ORCPT ); Thu, 3 Dec 2020 15:02:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1607025655; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=LDZnwIJru2s2CYmb1mcHfPmBYQjUYOel/yUcOh7HVug=; b=LMql/OIwhuuixo/V/gK4wYc4sqE9SQcpunyh+Pn40gvGu+35giYM8hFyFnJmW03pZ5ieSK qwe8156ABuBYfH/9iM1b62++DLKBnsoZXJSmjZXNAinQ5hQhlvg8BkUW8yEbLRWyPzAhze PL8oYQLwC3YzEdYatYe4qYI+RotWPL0= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-280-x9NsKO4wPCClAkfVFZzTmQ-1; Thu, 03 Dec 2020 15:00:53 -0500 X-MC-Unique: x9NsKO4wPCClAkfVFZzTmQ-1 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 25380192D7B7 for ; Thu, 3 Dec 2020 20:00:43 +0000 (UTC) Received: from liberator.sandeen.net (ovpn04.gateway.prod.ext.phx2.redhat.com [10.5.9.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id CD77972F91 for ; Thu, 3 Dec 2020 20:00:42 +0000 (UTC) Subject: [PATCH 2/3] xfs_quota: Remove delalloc caveat from man page From: Eric Sandeen To: xfs References: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Message-ID: <8fe85780-d68e-6d33-349b-66dad73858c3@redhat.com> Date: Thu, 3 Dec 2020 14:00:42 -0600 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Content-Language: en-US X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 Precedence: bulk List-ID: X-Mailing-List: linux-xfs@vger.kernel.org Ever since 89605011915a ("xfs: include reservations in quota reporting") xfs quota has been in sync with delayed allocations, so this caveat is no longer relevant or correct; remove it. Signed-off-by: Eric Sandeen Reviewed-by: Darrick J. Wong --- man/man8/xfs_quota.8 | 11 +---------- 1 file changed, 1 insertion(+), 10 deletions(-) diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index b3c4108e..bfdc2e4f 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -725,17 +725,8 @@ Same as above without a need for configuration files. .in -5 .fi .SH CAVEATS -XFS implements delayed allocation (aka. allocate-on-flush) and this -has implications for the quota subsystem. -Since quota accounting can only be done when blocks are actually -allocated, it is possible to issue (buffered) writes into a file -and not see the usage immediately updated. -Only when the data is actually written out, either via one of the -kernels flushing mechanisms, or via a manual -.BR sync (2), -will the usage reported reflect what has actually been written. .PP -In addition, the XFS allocation mechanism will always reserve the +The XFS allocation mechanism will always reserve the maximum amount of space required before proceeding with an allocation. If insufficient space for this reservation is available, due to the block quota limit being reached for example, this may result in the From patchwork Thu Dec 3 20:01:24 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eric Sandeen X-Patchwork-Id: 11949507 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-18.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 992FEC433FE for ; Thu, 3 Dec 2020 20:03:01 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 5607A2220F for ; Thu, 3 Dec 2020 20:03:01 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726222AbgLCUDB (ORCPT ); Thu, 3 Dec 2020 15:03:01 -0500 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:27944 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726048AbgLCUDA (ORCPT ); Thu, 3 Dec 2020 15:03:00 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1607025694; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=x5QE1pRGHKH8C82UA89lRDO5ZFY/NVfWYtH4q15aBUg=; b=Kv9BxjLV1HOuyAL0IJM4n2awawc8G9cfQ4h8pH9c7bPXpvODR21mROoHsgQA4epau2BvEr P7x/jExnz4FLdQdW0WrK8PXE1O09DVe+bY+0sJBkIRhdqlzxNgunWRxC3YuheroqJYbM3w XNpUpXpe78Vq0sXGl2nt3hqspfZ353s= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-528-prMTEcPMOK6fCLR5PyJleQ-1; Thu, 03 Dec 2020 15:01:32 -0500 X-MC-Unique: prMTEcPMOK6fCLR5PyJleQ-1 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id EC36D56B5A for ; Thu, 3 Dec 2020 20:01:24 +0000 (UTC) Received: from liberator.sandeen.net (ovpn04.gateway.prod.ext.phx2.redhat.com [10.5.9.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id C41A960BFA for ; Thu, 3 Dec 2020 20:01:24 +0000 (UTC) Subject: [PATCH 3/3] xfs_quota: make manpage non-male-specific From: Eric Sandeen To: xfs References: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Message-ID: <9fde98da-d221-87d0-a401-2c82cf1df35f@redhat.com> Date: Thu, 3 Dec 2020 14:01:24 -0600 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: <44dcd8f3-0585-e463-499f-44256d8bad8d@redhat.com> Content-Language: en-US X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Precedence: bulk List-ID: X-Mailing-List: linux-xfs@vger.kernel.org Users are not exclusively male, so fix that implication. Signed-off-by: Eric Sandeen --- man/man8/xfs_quota.8 | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index bfdc2e4f..beb6da13 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -128,7 +128,7 @@ To most users, disk quotas are either of no concern or a fact of life that cannot be avoided. There are two possible quotas that can be imposed \- a limit can be set on the amount of space a user can occupy, and there may be a limit on -the number of files (inodes) he can own. +the number of files (inodes) they can own. .PP The .B quota @@ -167,10 +167,10 @@ the file, not only are the recent changes lost, but possibly much, or even all, of the contents that previously existed. .br There are several possible safe exits for a user caught in this situation. -He can use the editor shell escape command to examine his file space +They can use the editor shell escape command to examine his file space and remove surplus files. Alternatively, using .BR sh (1), -he can suspend +they can suspend the editor, remove some files, then resume it. A third possibility is to write the file to some other filesystem (perhaps to a file on