The hinotify-bytestring package

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.


This library provides a wrapper to the Linux Kernel's inotify feature, allowing applications to subscribe to notifications when a file is accessed or modified. Filepaths are represented as ByteStrings.

[Skip to ReadMe]


Dependenciesbase (>= && <5), bytestring, containers, directory, unix [details]
AuthorLennart Kolmodin
MaintainerJulian Ospald <>
Home page
Source repositoryhead: git clone git://
UploadedSun May 1 02:15:39 UTC 2016 by maerwald




Maintainers' corner

For package maintainers and hackage trustees

Readme for hinotify-bytestring-

hinotify-bytestring: inotify for Haskell using ByteString for filepaths

Build Status


hinotify-bytestring, a library to inotify which has been part of the Linux kernel since 2.6.13.

inotify provides file system event notification, simply add a watcher to a file or directory and get an event when it is accessed or modified.

This module is named hinotify-bytestring.

See example code in the examples directory, distributed with the source code.


hinotify 0.3.7

hinotify 0.3.2

 -removeWatch :: INotify -> WatchDescriptor -> IO ()
 +removeWatch :: WatchDescriptor -> IO ()
 - { isDirecotry :: Bool
 + { isDirectory :: Bool

hinotify 0.3.1

hinotify 0.3

hinotify 0.2

hinotify 0.1 : Initial release


The API basically consists of:

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

A sample program:

{-# LANGUAGE OverloadedStrings #-}

import System.Posix.Env.ByteString
import System.IO

import System.INotify

main :: IO ()
main = do
  inotify <- initINotify
  print inotify
  home <- getEnvDefault "HOME" "/home"
  wd <- addWatch
  print wd
  putStrLn "Listens to your home directory. Hit enter to terminate."
  removeWatch wd


The code is available via the homepage:

git clone

The API is available online.

I'm most grateful for feedback on the API, and what else you might have to suggest.


Lennart Kolmodin

kolmodin at


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

Copyright © 2007-2012 Lennart Kolmodin