From owner-freebsd-doc@FreeBSD.ORG Wed Mar 10 11:10:22 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E56A216A4D2 for ; Wed, 10 Mar 2004 11:10:21 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7B6B643D4C for ; Wed, 10 Mar 2004 11:10:04 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i2AJA4bv025019 for ; Wed, 10 Mar 2004 11:10:04 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.10/8.12.10/Submit) id i2AJA4gG025014; Wed, 10 Mar 2004 11:10:04 -0800 (PST) (envelope-from gnats) Resent-Date: Wed, 10 Mar 2004 11:10:04 -0800 (PST) Resent-Message-Id: <200403101910.i2AJA4gG025014@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Stacey Roberts Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C59D316A4CE for ; Wed, 10 Mar 2004 11:07:38 -0800 (PST) Received: from heisenberg.zen.co.uk (heisenberg.zen.co.uk [212.23.3.141]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4809643D2F for ; Wed, 10 Mar 2004 11:07:38 -0800 (PST) (envelope-from stacey@vickiandstacey.com) Received: from [82.68.31.180] (helo=crom.vickiandstacey.com) by heisenberg.zen.co.uk with esmtp (Exim 4.30) id 1B193J-0005RN-8n for FreeBSD-gnats-submit@freebsd.org; Wed, 10 Mar 2004 19:07:37 +0000 Received: from crom.vickiandstacey.com (localhost [127.0.0.1]) i2AJ7NAD058234 for ; Wed, 10 Mar 2004 19:07:33 GMT (envelope-from stacey@crom.vickiandstacey.com) Received: (from stacey@localhost) by crom.vickiandstacey.com (8.12.11/8.12.11/Submit) id i2AJ7IVv058233; Wed, 10 Mar 2004 19:07:18 GMT (envelope-from stacey) Message-Id: <200403101907.i2AJ7IVv058233@crom.vickiandstacey.com> Date: Wed, 10 Mar 2004 19:07:18 GMT From: Stacey Roberts To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/64063: Size of block in File System Quota documentation is ambiguous X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Stacey Roberts List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Mar 2004 19:10:22 -0000 >Number: 64063 >Category: docs >Synopsis: Size of block in File System Quota documentation is ambiguous >Confidential: no >Severity: serious >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Mar 10 11:10:04 PST 2004 >Closed-Date: >Last-Modified: >Originator: Stacey Roberts >Release: FreeBSD 4.9-STABLE i386 >Organization: >Environment: System: FreeBSD crom.vickiandstacey.com 4.9-STABLE FreeBSD 4.9-STABLE #0: Sat Mar 6 12:31:02 GMT 2004 root@crom.vickiandstacey.com:/usr/obj/usr/src/sys/SMP i386 >Description: In attempting to follow the online HandBook on setting up per-user File System Quotas as described at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/quotas.html, it is not clear what the size of a block is, as used by the FreeBSD Quota system. When compared to man du(1) notes: ENVIRONMENT BLOCKSIZE If the environment variable BLOCKSIZE is set, and the -k option is not specified, the block counts will be displayed in units of that size block. If BLOCKSIZE is not set, and the -k option is not specified, the block counts will be displayed in 512-byte blocks. man ls(1): -s Display the number of file system blocks actually used by each file, in units of 512 bytes, where partial units are rounded up to the next integer value. If the output is to a terminal, a total sum for all the file sizes is output on a line before the listing. The environment variable BLOCKSIZE overrides the unit size of 512 bytes. it is not clear *what* the size of a block is supposed to be. Together with the PR submitted here: http://www.freebsd.org/cgi/query-pr.cgi?pr=41936, this issue is further complicated by the lack of a clear, unambiguous statement in Chapter 12.13 in the HandBook. >How-To-Repeat: N/A >Fix: Suggesting: - 1] Addition to Chapter 12.13 of the HandBook of a statement that clearly states what the sizeof a block is (currently?) supposed to be. 2] One or two examples for illustrative purposes >Release-Note: >Audit-Trail: >Unformatted: