Module Name: src
Committed By: martin
Date: Fri Dec 16 16:58:14 UTC 2022
Modified Files:
src/distrib/notes/common: main
Log Message:
Add notes about FFS and extended attributes.
To generate a diff of this commit:
cvs rdiff -u -r1.569 -r1.570 src/distrib/notes/common/main
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/notes/common/main
diff -u src/distrib/notes/common/main:1.569 src/distrib/notes/common/main:1.570
--- src/distrib/notes/common/main:1.569 Fri Apr 1 21:53:35 2022
+++ src/distrib/notes/common/main Fri Dec 16 16:58:14 2022
@@ -1,4 +1,4 @@
-.\" $NetBSD: main,v 1.569 2022/04/01 21:53:35 andvar Exp $
+.\" $NetBSD: main,v 1.570 2022/12/16 16:58:14 martin Exp $
.\"
.\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -526,6 +526,32 @@ development, and no formal or informal t
this snapshot (yet).
.Pp
.\} \" !\n[RELEASE_BRANCH] \{
+One important new feature in this release is the support for extended
+attributes and access controll lists on FFS file systems.
+.Pp
+For new installations the installer will default to disable this features,
+so the file system is compatible with older
+.Nx
+releases (before 10), and allow other operating systems to mount this
+file systems at least in read-only mode.
+.Pp
+If you want a new installed file system to support extended attributes,
+change the file system type from
+.Dq FFSv2
+to
+.Dq FFSv2ea
+in the partitioning menu.
+You can also convert file systems later, using the
+.Xr fsck_ffs 8
+utility.
+More details are available in
+.Lk https://wiki.netbsd.org/tutorials/acls_and_extended_attributes_on_ffs "this guide" .
+.Pp
+If you are upgrading from a version of
+.Nx -current
+please also check the
+.Sx "Compatibility Issues With Previous NetBSD Releases" .
+.PP
It is impossible to completely summarize the massive development that
went into the
.Nx
@@ -785,6 +811,20 @@ and thus all issues that are fixed by
.Ic postinstall
by default will be handled.
.Pp
+If you have ever run a version of
+.Nx -current
+between April 18, 2020 and September 23, 2022 (the version numbers
+used in the affected time range are between 9.99.56 and 9.99.106)
+your FFS file systems might have broken extended attributes stored.
+.Pp
+You should follow this
+.Lk https://wiki.netbsd.org/features/UFS2ea/ guide
+before booting the updated system multi-user for the first time.
+.Pp
+.Em Note that you do not need to do anything special if you never did run any affected kernel,
+especially if you have never run
+.Nx -current .
+.Pp
A number of things have been removed from the
.Nx
\*V release.
