You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/src/config.md
+21-9
Original file line number
Diff line number
Diff line change
@@ -123,25 +123,37 @@ string `"1"` (e.g., `JULIA_REVISE_INCLUDE=1` in a bash script).
123
123
Revise needs to be notified by your filesystem about changes to your code,
124
124
which means that the files that define your modules need to be watched for updates.
125
125
Some systems impose limits on the number of files and directories that can be
126
-
watched simultaneously; if this limit is hit, on Linux this can result in a fairly cryptic
127
-
error like
126
+
watched simultaneously; if such a limit is hit, on Linux this can result in Revise silently ceasing to work
127
+
(albeit with unit tests failing) or in a fairly cryptic error like
128
128
129
129
```sh
130
130
ERROR: start_watching (File Monitor): no space left on device (ENOSPC)
131
131
```
132
132
133
-
The cure is to increase the number of files that can be watched, by executing
133
+
The cure is to investigate and possibly increase the number of files that can be watched.
134
134
135
+
Invoking
135
136
```sh
136
-
echo 65536 | sudo tee -a /proc/sys/fs/inotify/max_user_watches
137
+
$ sysctl fs.inotify
137
138
```
139
+
at the linux prompt may e.g. result in
140
+
```
141
+
fs.inotify.max_queued_events = 16384
142
+
fs.inotify.max_user_instances = 128
143
+
fs.inotify.max_user_watches = 524288
144
+
```
145
+
146
+
For Revise usage, `max_user_watches >= 65536` is recommended, and more can be helpful; the value of 524288 above is common on modern systems. One can set higher values as needed, e.g.,
147
+
```
148
+
$ sudo sysctl fs.inotify.max_user_instances=2048
149
+
```
150
+
After changing these values, it is advised to run Revise's unit tests to see if they pass.
151
+
152
+
This change can be made [permanent](https://www.suse.com/de-de/support/kb/doc/?id=000020048).
138
153
139
-
at the Linux prompt. (The maximum value is 524288,
140
-
which will allocate half a gigabyte of RAM to file-watching).
141
-
For more information see [issue #26](https://github.com/timholy/Revise.jl/issues/26).
154
+
For more information see issues [#26](https://github.com/timholy/Revise.jl/issues/26)
155
+
and [#778](https://github.com/timholy/Revise.jl/issues/778).
142
156
143
-
Changing the value this way may not last through the next reboot,
144
-
but [you can also change it permanently](https://askubuntu.com/questions/716431/inotify-max-user-watches-value-resets-on-reboot-how-to-change-it-permanently).
145
157
146
158
### Polling and NFS-mounted code directories: JULIA\_REVISE\_POLL
0 commit comments