diff --git a/man/man8/zfsprops-macos.8 b/man/man8/zfsprops-macos.8 index 98bb5b0d3b79..5e46639e350f 100644 --- a/man/man8/zfsprops-macos.8 +++ b/man/man8/zfsprops-macos.8 @@ -38,33 +38,58 @@ .\" Copyright 2019 Joyent, Inc. .\" Copyright (c) 2019, Kjeld Schouten-Lebbing .\" -.It Sy com.apple.browse Ns = Ns Sy on Ns | Ns Sy off +.Dd April 29, 2021 +.Dt ZFSPROPS-MACOS 8 +.Os +. +.Sh NAME +.Nm zfsprops-macos +.Nd native properties of ZFS datasets specific to macOS +. +.Sh DESCRIPTION +These properties are like the native properties described in +.Xr zfsprops 8 +but they are specific to macOS. +.Pp +The following native properties can be used to change the behavior of a ZFS +dataset. +.Bl -tag -width "" +.Pp +.It Xo +.Sy com.apple.browse Ns = Ns Sy on Ns | Ns Sy off +.Xc Equivalent to mount option -.Sx browse/nobrowse. +.Sy browse/nobrowse. This option indicates that the mount point should not be visible via the GUI (i.e., appear on the Desktop as a separate volume). Setting it to off will result in Spotlight being unavailable for the specified mount point. The default value is .Sy off . -.It Sy com.apple.ignoreowner Ns = Ns Sy on Ns | Ns Sy off +.It Xo +.Sy com.apple.ignoreowner Ns = Ns Sy on Ns | Ns Sy off +.Xc Equivalent to mount option -.Sx noowners. +.Sy noowners. Ignore the ownership field for the entire volume. The default value is .Sy off . -.It Sy com.apple.mimic Ns = Ns Sy hfs Ns | Ns Sy off +.It Xo +.Sy com.apple.mimic Ns = Ns Sy hfs Ns | Ns Sy off +.Xc Some applications check if the filesystem type is "hfs" and refuse to work with ZFS. In this situation, this property can be enabled and the filesystem type will be reported as "hfs". The default value is .Sy off . -.It Sy com.apple.devdisk Ns = Ns Sy poolonly Ns | Ns Sy on Ns | Ns Sy off +.It Xo +.Sy com.apple.devdisk Ns = Ns Sy poolonly Ns | Ns Sy on Ns | Ns Sy off +.Xc Create a /dev/diskX pseudo-disk for the mount, which has better compatibility with macOS UI. Due to the cost of creating a /dev/disk entry, the default value is set to -.Sx poolonly +.Sy poolonly as to only create an entry for the pool's root dataset. For lower datasets, set to -.Sx on . - +.Sy on . +.El