watchman
A file watching service
Subcommands
Name | Description |
---|---|
clock | Returns the current clock value for a watched root |
find | Finds all files that match the optional list of patterns under the specified dir |
flush-subscriptions | This is designed to be used by interactive programs that have a background process or daemon maintaining a subscription to Watchman |
get-config | Returns the .watchmanconfig for the root |
get-sockname | Get socket path |
list-capabilities | Returns the full list of supported capabilities offered by the watchman server |
log | Generates a log line in the watchman log |
log-level | Changes the log level of your connection to the watchman service |
query | Executes a query against the specified root |
shutdown-server | This causes your watchman service to exit with a normal status code |
since | Finds all files that were modified since the specified clockspec that match the optional list of patterns |
state-enter | This causes a watch to be marked as being in a particular named state |
state-leave | This causes a watch to no longer be marked as being in a particular named state |
subscribe | Subscribes to changes against a specified root and requests that they be sent to the client via its connection |
trigger | This will create or replace a trigger |
trigger-del | Deletes a named trigger from the list of registered triggers |
trigger-list | Returns the set of registered triggers associated with a root directory |
unsubscribe | Cancels a named subscription against the specified root |
version | The version and build information for the currently running watchman service |
watch-del | Removes a watch and any associated triggers |
watch-del-all | Removes all watches and associated triggers |
watch-list | Returns a list of watched dirs |
watch-project | Requests that the project containing the requested dir is watched for changes |
Options
Name | Description |
---|---|
--help, -h | Show help for watchman |
--inetd | Spawning from an inetd style supervisor |
-S, --no-site-spawner | Don't use the site or system spawner |
-v, --version | Show version number for watchman |
--named-pipe-path <path> | Specify alternate named pipe path |
-u <path> | Specify alternate unix domain socket path |
--unix-listener-path <path> | Specify alternate unix domain socket path |
-o <path> | Specify the path to logfile |
--logfile <path> | Specify the path to logfile |
--log-level <level> | Set the log level |
--pidfile | Specify path to pidfile |
-p, --persistent | Persist and wait for further responses |
-n, --no-save-state | Don't save state between invocations |
--statefile <path> | Specify path to file to hold watch and trigger state |
-j, --json-command | Instead of parsing CLI arguments, take a single json object from stdin |
--output-encoding <encoding> | CLI output encoding |
--server-encoding <encoding> | CLI<->server encoding |
-f, --foreground | Run the service in the foreground |
--no-pretty | Don't pretty print JSON |
--no-spawn | Don't try to start the service if it is not available |
--no-local | When no-spawn is enabled, don't try to handle request in client mode if service is unavailable |