---
name: "zfs-fuse"
section: "8"
platform: "linux"
package: "zfs-fuse"
version: "0.7.0-30+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/zfs-fuse"
---

# zfs-fuse(8)

ZFS filesystem daemon

## NAME

zfs-fuse - ZFS filesystem daemon

## SYNOPSIS

**zfs-fuse** \[**--pidfile** *filename*\] \[**--no-daemon**\] \[**--no-kstat-mount**\] \[**--disable-block-cache**\] \[**--disable-page-cache**\] \[**--fuse-attr-timeout** *SECONDS*\] \[**--fuse-entry-timeout** *SECONDS*\] \[**--log-uberblocks**\] \[**--max-arc-size** *MB*\] \[**--fuse-mount-options** *OPT,OPT,OPT...*\] \[**--min-uberblock-txg** *MIN*\] \[**--stack-size=***size*\] \[**--enable-xattr**\] \[**--help**\]

## DESCRIPTION

This manual page documents briefly the **zfs-fuse** command.

**zfs-fuse** is a daemon which provides support for the ZFS filesystem, via fuse. Ordinarily this daemon will be invoked from system boot scripts.

## OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (\`-'). A summary of options is included below. For a complete description, see the Info files.

- **-h** **--help**

  Show summary of options.

- **-p** *filename* **--pidfile** *filename*

  Write the daemon's PID to *filename* after daemonizing. Ignored if **--no-daemon** is passed. *filename* should be a fully-qualified path.

- **-n** **--no-daemon**

  Stay in foreground, don't daemonize.

- **--no-kstat-mount**

  Do not mount kstats in /zfs-kstat

- **--disable-block-cache**

  Enable direct I/O for disk operations. Completely disables caching reads and writes in the kernel block cache. Breaks mmap() in ZFS datasets too.

- **--disable-page-cache**

  Disable the page cache for files residing within ZFS filesystems. Not recommended as it slows down I/O operations considerably.

- **-a** *SECONDS* **--fuse-attr-timeout** *SECONDS*

  Sets timeout for caching FUSE attributes in kernel. Defaults to 0.0. Higher values give a 40% performance boost.

- **-e** *SECONDS* **--fuse-entry-timeout** *SECONDS*

  Sets timeout for caching FUSE entries in kernel. Defaults to 0.0. Higher values give a 10000% performance boost but cause file permission checking security issues.

- **--log-uberblocks**

  Logs uberblocks of any mounted filesystem to syslog

- **-m** *MB* **--max-arc-size** *MB*

  Forces the maximum ARC size (in megabytes). Range: 16 to 16384.

- **-o** *OPT...* **--fuse-mount-options** *OPT,OPT,OPT...*

  Sets FUSE mount options for all filesystems. Format: comma-separated string of characters.

- **-u** *MIN* **--min-uberblock-txg** *MIN*

  Skips uberblocks with a TXG \< *MIN* when mounting any fs

- **-v** *MB* **--vdev-cache-size** *MB*

  adjust the size of the vdev cache. Default : 10

- **--zfs-prefetch-disable**

  Disable the high level prefetch cache in zfs. This thing can eat up to 150 Mb of ram, maybe more

- **--stack-size=***size*

  Limit the stack *size* of threads (in kb). default : no limit (8 Mb for linux)

- **-x** **--enable-xattr**

  Enable support for extended attributes. Not generally recommended because it currently has a significant performance penalty for many small IOPS

- **-h** **--help**

  Show this usage summary.

## REMARKS ON PRECEDENCE

Note that the parameters passed on the command line take precedence over those supplied through /etc/zfs/zfsrc.

## BUGS/CAVEATS

The path to the configuration file (/etc/zfs/zfsrc) cannot at this time be configured.

Most existing packages suggest settings can be set at the top of their init script. These get frequently overridden by a (distribution specific) /etc/default/zfs-fuse file, if it exists. Be sure to look at these places if you want your changes to options to take effect.

The /etc/zfs/zfsrc is going to be the recommended approach in the future. So, packagers, please refrain from passing commandline parameters within the initscript (except for --pid-file).

## SEE ALSO

zfs (8), zpool (8), [zdb(8)](/zdb/8.md), [zstreamdump(8)](/zstreamdump/8.md), /etc/zfs/zfsrc

## AUTHOR

This manual page was written by Bryan Donlan bdonlan@gmail.com for the Debian(TM) system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation, or the Common Development and Distribution License.

Revised by Seth Heeren zfs-fuse@sehe.nl

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. The text of the Common Development and Distribution Licence may be found at /usr/share/doc/zfs-fuse/copyright

## COPYRIGHT

Copyright © 2010 Bryan Donlan\