Skip to content

Commit

Permalink
zfsprops-macos.8: fix formatting
Browse files Browse the repository at this point in the history
to clean up the appearance and comply with `make mancheck`.
  • Loading branch information
ilovezfs committed Jun 9, 2021
1 parent da41b22 commit f90ceab
Showing 1 changed file with 34 additions and 9 deletions.
43 changes: 34 additions & 9 deletions man/man8/zfsprops-macos.8
Original file line number Diff line number Diff line change
Expand Up @@ -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

0 comments on commit f90ceab

Please sign in to comment.