git-fsmonitor--daemon(1) — Linux manual page



NAME         top

       git-fsmonitor--daemon - A Built-in Filesystem Monitor

SYNOPSIS         top

       git fsmonitor--daemon start
       git fsmonitor--daemon run
       git fsmonitor--daemon stop
       git fsmonitor--daemon status

DESCRIPTION         top

       A daemon to watch the working directory for file and directory
       changes using platform-specific filesystem notification

       This daemon communicates directly with commands like git status
       using the simple IPC[1] interface instead of the slower
       githooks(5) interface.

       This daemon is built into Git so that no third-party tools are

OPTIONS         top

           Starts a daemon in the background.

           Runs a daemon in the foreground.

           Stops the daemon running in the current working directory, if

           Exits with zero status if a daemon is watching the current
           working directory.

REMARKS         top

       This daemon is a long running process used to watch a single
       working directory and maintain a list of the recently changed
       files and directories. Performance of commands such as git status
       can be increased if they just ask for a summary of changes to the
       working directory and can avoid scanning the disk.

       When core.fsmonitor is set to true (see git-config(1)) commands,
       such as git status, will ask the daemon for changes and
       automatically start it (if necessary).

       For more information see the "File System Monitor" section in

CAVEATS         top

       The fsmonitor daemon does not currently know about submodules and
       does not know to filter out filesystem events that happen within
       a submodule. If fsmonitor daemon is watching a super repo and a
       file is modified within the working directory of a submodule, it
       will report the change (as happening against the super repo).
       However, the client will properly ignore these extra events, so
       performance may be affected but it will not cause an incorrect

       By default, the fsmonitor daemon refuses to work with
       network-mounted repositories; this may be overridden by setting
       fsmonitor.allowRemote to true. Note, however, that the fsmonitor
       daemon is not guaranteed to work correctly with all
       network-mounted repositories, so such use is considered

       On Mac OS, the inter-process communication (IPC) between various
       Git commands and the fsmonitor daemon is done via a Unix domain
       socket (UDS) — a special type of file — which is supported by
       native Mac OS filesystems, but not on network-mounted
       filesystems, NTFS, or FAT32. Other filesystems may or may not
       have the needed support; the fsmonitor daemon is not guaranteed
       to work with these filesystems and such use is considered

       By default, the socket is created in the .git directory. However,
       if the .git directory is on a network-mounted filesystem, it will
       instead be created at $HOME/.git-fsmonitor-* unless $HOME itself
       is on a network-mounted filesystem, in which case you must set
       the configuration variable fsmonitor.socketDir to the path of a
       directory on a Mac OS native filesystem in which to create the
       socket file.

       If none of the above directories (.git, $HOME, or
       fsmonitor.socketDir) is on a native Mac OS file filesystem the
       fsmonitor daemon will report an error that will cause the daemon
       and the currently running command to exit.


       Everything below this line in this section is selectively
       included from the git-config(1) documentation. The content is the
       same as what’s found there:

           By default, the fsmonitor daemon refuses to work with
           network-mounted repositories. Setting fsmonitor.allowRemote
           to true overrides this behavior. Only respected when
           core.fsmonitor is set to true.

           This Mac OS-specific option, if set, specifies the directory
           in which to create the Unix domain socket used for
           communication between the fsmonitor daemon and various Git
           commands. The directory must reside on a native Mac OS
           filesystem. Only respected when core.fsmonitor is set to

GIT         top

       Part of the git(1) suite

NOTES         top

        1. simple IPC

COLOPHON         top

       This page is part of the git (Git distributed version control
       system) project.  Information about the project can be found at
       ⟨⟩.  If you have a bug report for this manual
       page, see ⟨⟩.  This page was obtained
       from the project's upstream Git repository
       ⟨⟩ on 2023-12-22.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2023-12-20.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Git         2023-12-20       GIT-FSMONITOR--DAEMON(1)

Pages that refer to this page: git-config(1)git-update-index(1)