zpoolprops.7: Fix max length of name of user property

The documentation mentioned that the property name can be 256 characters
long. This was incorrect. The last byte is reserved for NUL, so the
name provided by the operator can be only 255 characters long.

Reviewed-by: Tony Hutter <hutter2@llnl.gov>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Alexander Motin <mav@FreeBSD.org>
Reviewed-by: Tino Reichardt <milky-zfs@mcmilk.de>
Reviewed-by: Allan Jude <allan@klarasystems.com>
Signed-off-by: Mateusz Piotrowski <0mp@FreeBSD.org>
Sponsored-by: Klara, Inc.
Sponsored-by: Wasabi Technology, Inc.
Closes #16248
This commit is contained in:
Mateusz Piotrowski 2024-06-03 16:46:46 +02:00 committed by Brian Behlendorf
parent 7ceb9ad630
commit 2558518c5d
1 changed files with 2 additions and 2 deletions

View File

@ -28,7 +28,7 @@
.\" Copyright (c) 2021, Colm Buckley <colm@tuatha.org> .\" Copyright (c) 2021, Colm Buckley <colm@tuatha.org>
.\" Copyright (c) 2023, Klara Inc. .\" Copyright (c) 2023, Klara Inc.
.\" .\"
.Dd January 14, 2024 .Dd July 29, 2024
.Dt ZPOOLPROPS 7 .Dt ZPOOLPROPS 7
.Os .Os
. .
@ -488,7 +488,7 @@ The expected convention is that the property name is divided into two portions
such as such as
.Ar module : Ns Ar property , .Ar module : Ns Ar property ,
but this namespace is not enforced by ZFS. but this namespace is not enforced by ZFS.
User property names can be at most 256 characters, and cannot begin with a dash User property names can be at most 255 characters, and cannot begin with a dash
.Pq Qq Sy - . .Pq Qq Sy - .
.Pp .Pp
When making programmatic use of user properties, it is strongly suggested to use When making programmatic use of user properties, it is strongly suggested to use