Merge branch 'jc/branch-parseopt-fix'
[git/debian.git] / Documentation / git-fsmonitor--daemon.txt
blob8238eadb0e166a97537fdfd28296df6c31e7e342
1 git-fsmonitor{litdd}daemon(1)
2 =============================
4 NAME
5 ----
6 git-fsmonitor--daemon - A Built-in Filesystem Monitor
8 SYNOPSIS
9 --------
10 [verse]
11 'git fsmonitor{litdd}daemon' start
12 'git fsmonitor{litdd}daemon' run
13 'git fsmonitor{litdd}daemon' stop
14 'git fsmonitor{litdd}daemon' status
16 DESCRIPTION
17 -----------
19 A daemon to watch the working directory for file and directory
20 changes using platform-specific filesystem notification facilities.
22 This daemon communicates directly with commands like `git status`
23 using the link:technical/api-simple-ipc.html[simple IPC] interface
24 instead of the slower linkgit:githooks[5] interface.
26 This daemon is built into Git so that no third-party tools are
27 required.
29 OPTIONS
30 -------
32 start::
33         Starts a daemon in the background.
35 run::
36         Runs a daemon in the foreground.
38 stop::
39         Stops the daemon running in the current working
40         directory, if present.
42 status::
43         Exits with zero status if a daemon is watching the
44         current working directory.
46 REMARKS
47 -------
49 This daemon is a long running process used to watch a single working
50 directory and maintain a list of the recently changed files and
51 directories.  Performance of commands such as `git status` can be
52 increased if they just ask for a summary of changes to the working
53 directory and can avoid scanning the disk.
55 When `core.fsmonitor` is set to `true` (see linkgit:git-config[1])
56 commands, such as `git status`, will ask the daemon for changes and
57 automatically start it (if necessary).
59 For more information see the "File System Monitor" section in
60 linkgit:git-update-index[1].
62 CAVEATS
63 -------
65 The fsmonitor daemon does not currently know about submodules and does
66 not know to filter out filesystem events that happen within a
67 submodule.  If fsmonitor daemon is watching a super repo and a file is
68 modified within the working directory of a submodule, it will report
69 the change (as happening against the super repo).  However, the client
70 will properly ignore these extra events, so performance may be affected
71 but it will not cause an incorrect result.
73 By default, the fsmonitor daemon refuses to work against network-mounted
74 repositories; this may be overridden by setting `fsmonitor.allowRemote` to
75 `true`. Note, however, that the fsmonitor daemon is not guaranteed to work
76 correctly with all network-mounted repositories and such use is considered
77 experimental.
79 On Mac OS, the inter-process communication (IPC) between various Git
80 commands and the fsmonitor daemon is done via a Unix domain socket (UDS) -- a
81 special type of file -- which is supported by native Mac OS filesystems,
82 but not on network-mounted filesystems, NTFS, or FAT32.  Other filesystems
83 may or may not have the needed support; the fsmonitor daemon is not guaranteed
84 to work with these filesystems and such use is considered experimental.
86 By default, the socket is created in the `.git` directory, however, if the
87 `.git` directory is on a network-mounted filesystem, it will be instead be
88 created at `$HOME/.git-fsmonitor-*` unless `$HOME` itself is on a
89 network-mounted filesystem in which case you must set the configuration
90 variable `fsmonitor.socketDir` to the path of a directory on a Mac OS native
91 filesystem in which to create the socket file.
93 If none of the above directories (`.git`, `$HOME`, or `fsmonitor.socketDir`)
94 is on a native Mac OS file filesystem the fsmonitor daemon will report an
95 error that will cause the daemon and the currently running command to exit.
97 CONFIGURATION
98 -------------
100 include::includes/cmd-config-section-all.txt[]
102 include::config/fsmonitor--daemon.txt[]
106 Part of the linkgit:git[1] suite