From c4d162ea08e37dfdf958a79051aa6f6e223606b2 Mon Sep 17 00:00:00 2001 From: Max Horn Date: Thu, 8 Jun 2023 17:55:41 +0200 Subject: [PATCH] mkpidlock: clarify that stale_age is given in seconds (#50014) --- stdlib/FileWatching/src/pidfile.jl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/stdlib/FileWatching/src/pidfile.jl b/stdlib/FileWatching/src/pidfile.jl index 8416765a57b97..b78f7ef070018 100644 --- a/stdlib/FileWatching/src/pidfile.jl +++ b/stdlib/FileWatching/src/pidfile.jl @@ -31,7 +31,7 @@ your program, so the `finalizer` does not reclaim it early. Optional keyword arguments: - `mode`: file access mode (modified by the process umask). Defaults to world-readable. - `poll_interval`: Specify the maximum time to between attempts (if `watch_file` doesn't work) - - `stale_age`: Delete an existing pidfile (ignoring the lock) if its mtime is older than this. + - `stale_age`: Delete an existing pidfile (ignoring the lock) if it is older than this many seconds, based on its mtime. The file won't be deleted until 25x longer than this if the pid in the file appears that it may be valid. By default this is disabled (`stale_age` = 0), but a typical recommended value would be about 3-5x an estimated normal completion time.