hinotify

Haskell binding to inotify

https://github.com/kolmodin/hinotify

LTS Haskell 23.23:0.4.2
Stackage Nightly 2025-05-23:0.4.2
Latest on Hackage:0.4.2

See all snapshots hinotify appears in

BSD-3-Clause licensed by Lennart Kolmodin
Maintained by Tom McLaughlin
This version can be pinned in stack with:hinotify-0.4.2@sha256:dc4c45544e1920864882ee1b332d78960cdb9f7b706983f6eab3c9dabda4fa9e,2725

Module documentation for 0.4.2

Used by 3 packages in nightly-2025-05-23(full list with versions):
amqp-utils, fsnotify, git-annex

hinotify: inotify for Haskell

CI

About

This package provides bindings to inotify, which has been part of the Linux kernel since 2.6.13.

The inotify subsystem provides file system event notifications. Simply add a watcher to a file or directory and you get events when it is accessed, modified, etc.

News

See CHANGELOG.md.

API

The API basically consists of:

initINotify :: IO INotify

addWatch :: INotify
         -> [EventVariety]   -- different events to listen on
         -> RawFilePath      -- file/directory to watch
         -> (Event -> IO ()) -- event handler callback
         -> IO WatchDescriptor

removeWatch :: WatchDescriptor -> IO ()

See this example or the docs.

Author

Lennart Kolmodin

kolmodin at gmail.com

Legal

This software is released under a BSD-style license. See LICENSE for more details.

Copyright © 2007-2012 Lennart Kolmodin

Changes

hinotify

0.4.2

0.4.1

  • Depend on inotify library on {Free,Open}BSD

0.4

  • Allow async-2.*

0.3.10

  • Allow async-2.2.

  • Use RawFilePath (ByteString) for filenames, from unix package.

    Changes the Event type and addWatch function.

0.3.9

Patches contributed by Simon Marlow [email protected]

  • Don’t run callbacks in mask_.

    It prevented the callback threads from receiving StackOverflow, amongst other things.

  • Synchronous killThread.

    killThread will now wait for the callback dispatcher threads to finish.

  • Bug fixes

    https://github.com/kolmodin/hinotify/pull/23

0.3.8

  • Use file system encoding for file names.

    When run in a locale like LANG=C, this ensures that the filename is encoded as a filename, so that arbitrary bytes in it will round-trip correctly, rather than being stripped out.

    Fixes https://github.com/kolmodin/hinotify/issues/13

    Patch contributed by Joey Hess [email protected]

0.3.7

  • Bug fix: When registerering a new watch on a path which is already watched, don’t overwrite the event listener from the previous watch.

0.3.2

  • Make each WatchDescriptor contain its INotify. Changes to the function types:
 -removeWatch :: INotify -> WatchDescriptor -> IO ()
 +removeWatch :: WatchDescriptor -> IO ()
  • Fix typo in declaration of Deleted in data Event;
 - { isDirecotry :: Bool
 + { isDirectory :: Bool

0.3.1

  • Use inotify.h from glibc rather than from the linux headers, as recommended upstream.

0.3

  • Compiles with GHC 6.12, GHC 6.10.4, GHC 6.8.2 and GHC 6.6.1

0.2

  • Updates to the API
    • Function names is now in semiCamelCase
    • Restructure event parameters to make it more consistent
  • Small test suit in tests/
  • Compiles with GHC 6.8.2 and GHC 6.6.1
  • Requires Cabal 1.2

0.1

  • Initial release