NetBSD Problem Report #60420

From www@netbsd.org  Mon Jul  6 20:36:28 2026
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256
	 client-signature RSA-PSS (2048 bits) client-digest SHA256)
	(Client CN "mail.netbsd.org", Issuer "YR2" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 6F3EC1A923A
	for <gnats-bugs@gnats.NetBSD.org>; Mon,  6 Jul 2026 20:36:28 +0000 (UTC)
Message-Id: <20260706203627.0BAEF1A923F@mollari.NetBSD.org>
Date: Mon,  6 Jul 2026 20:36:26 +0000 (UTC)
From: campbell+netbsd@mumble.net
Reply-To: campbell+netbsd@mumble.net
To: gnats-bugs@NetBSD.org
Subject: file systems should have man pages
X-Send-Pr-Version: www-1.0
X-From4GNATS: "campbell+netbsd@mumble.net via gnats" <gnats-admin@NetBSD.org>

>Number:         60420
>Category:       misc
>Synopsis:       file systems should have man pages
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Jul 06 20:40:00 +0000 2026
>Originator:     Taylor R Campbell
>Release:        
>Organization:
The NetFFS Documentation
>Environment:
>Description:

	What are sysvbfs and v7fs for/from?  What variants of ufs
	(freebsd, apple, ...) are supported?  What are ffsv1 vs ffsv2
	or ffsv2ea?  How are those versions different from UFS1 vs UFS2
	superblock format?  What performance characteristics are the
	different file systems or options expected to exhibit, like
	vanilla vs async vs sync vs wapbl ffs?

	These are all questions I would like to find the answers to in
	a man page about each file system.  Instead, the information is
	scattered throughout several different places:

	mount(8) -- fs-independent but a lot of ffs-specific info
	mount_ffs(8) -- ffs-specific but not much here
	mount_v7fs(8)
	newfs(8) -- ffs-specific and various format information here
	tunefs(8) -- tells how to toggle between logging and no logging

>How-To-Repeat:

	try to answer the above questions

>Fix:

	Yes, please!

Home	PR Database Search