OS Manuals

/usr/bin/sshfs

A network filesystem client to connect to SSH servers

From sshfs 3.7.6-r2 (os), captured 2026-11-05 by running sshfs --help (exit 0). permalink

usage: /usr/bin/sshfs [user@]host:[dir] mountpoint [options]

    -h   --help            print help
    -V   --version         print version
    -f                     foreground operation
    -s                     disable multi-threaded operation
    -p PORT                equivalent to '-o port=PORT'
    -C                     equivalent to '-o compression=yes'
    -F ssh_configfile      specifies alternative ssh configuration file
    -1                     equivalent to '-o ssh_protocol=1'
    -o opt,[opt...]        mount options
    -o reconnect           reconnect to server
    -o delay_connect       delay connection to server
    -o sshfs_sync          synchronous writes
    -o no_readahead        synchronous reads (no speculative readahead)
    -o sync_readdir        synchronous readdir
    -d, --debug            print some debugging information (implies -f)
    -o dir_cache=BOOL      enable caching of directory contents (names,
                           attributes, symlink targets) {yes,no} (default: yes)
    -o dcache_max_size=N   sets the maximum size of the directory cache (default: 10000)
    -o dcache_timeout=N    sets timeout for directory cache in seconds (default: 20)
    -o dcache_{stat,link,dir}_timeout=N
                           sets separate timeout for {attributes, symlinks, names}
    -o dcache_clean_interval=N
                           sets the interval for automatic cleaning of the
                           cache (default: 60)
    -o dcache_min_clean_interval=N
                           sets the interval for forced cleaning of the
                           cache if full (default: 5)
    -o direct_io           enable direct i/o
    -o workaround=LIST     colon separated list of workarounds
             none             no workarounds enabled
             [no]rename       fix renaming to existing file (default: off)
             [no]renamexdev   fix moving across filesystems (default: off)
             [no]truncate     fix truncate for old servers (default: off)
             [no]buflimit     fix buffer fillup bug in server (default: off)
             [no]fstat        always use stat() instead of fstat() (default: off)
             [no]createmode   always pass mode 0 to create (default: off)
    -o idmap=TYPE          user/group ID mapping (default: none)
             none             no translation of the ID space
             user             only translate UID/GID of connecting user
             file             translate UIDs/GIDs contained in uidfile/gidfile
    -o uidfile=FILE        file containing username:remote_uid mappings
    -o gidfile=FILE        file containing groupname:remote_gid mappings
    -o nomap=TYPE          with idmap=file, how to handle missing mappings
             ignore           don't do any re-mapping
             error            return an error (default)
    -o ssh_command=CMD     execute CMD instead of 'ssh'
    -o ssh_protocol=N      ssh protocol to use (default: 2)
    -o sftp_server=SERV    path to sftp server or subsystem (default: sftp)
    -o directport=PORT     directly connect to PORT bypassing ssh
    -o passive             communicate over stdin and stdout bypassing network
    -o disable_hardlink    link(2) will return with errno set to ENOSYS
    -o transform_symlinks  transform absolute symlinks to relative
    -o contain_symlinks    reject absolute symlinks and symlinks containing ..
                           (enabled by default; disable with no_contain_symlinks)
    -o no_contain_symlinks allow all symlink targets including absolute and ..
    -o follow_symlinks     follow symlinks on the server
    -o no_check_root       don't check for existence of 'dir' on server
    -o password_stdin      read password from stdin (only for pam_mount!)
    -o max_conns=N         open parallel SSH connections
    -o vsock=CID:PORT      connect to the given vsock
    -o SSHOPT=VAL          ssh options (see man ssh_config)

FUSE Options:
    -o kernel_cache        cache files in kernel
    -o [no]auto_cache      enable caching based on modification times (off)
    -o no_rofd_flush       disable flushing of read-only fd on close (off)
    -o umask=M             set file permissions (octal)
    -o fmask=M             set file permissions (octal)
    -o dmask=M             set dir  permissions (octal)
    -o uid=N               set file owner
    -o gid=N               set file group
    -o entry_timeout=T     cache timeout for names (1.0s)
    -o negative_timeout=T  cache timeout for deleted names (0.0s)
    -o attr_timeout=T      cache timeout for attributes (1.0s)
    -o ac_attr_timeout=T   auto cache timeout for attributes (attr_timeout)
    -o noforget            never forget cached inodes
    -o remember=T          remember cached inodes for T seconds (0s)
    -o modules=M1[:M2...]  names of modules to push onto filesystem stack
    -o allow_other         allow access by all users
    -o allow_root          allow access by root
    -o auto_unmount        auto unmount on process termination
    -o io_uring            enable io-uring
    -o io_uring_q_depth=<n> io-uring queue depth

Options for subdir module:
    -o subdir=DIR	    prepend this directory to all paths (mandatory)
    -o [no]rellinks	    transform absolute symlinks to relative

Options for iconv module:
    -o from_code=CHARSET   original encoding of file names (default: UTF-8)
    -o to_code=CHARSET     new encoding of the file names (default: ANSI_X3.4-1968)
Options (10)
OptionDescriptionSource
-h--help print helphelp
-V--version print versionhelp
-fforeground operationhelp
-sdisable multi-threaded operationhelp
-p PORTequivalent to '-o port=PORT'help
-Cequivalent to '-o compression=yes'help
-F ssh_configfilespecifies alternative ssh configuration filehelp
-1equivalent to '-o ssh_protocol=1'help
-o optmount optionshelp
-d, --debugprint some debugging information (implies -f)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.