Differences between revisions 7 and 8
Revision 7 as of 2008-03-17 22:27:35
Size: 2177
Editor: bos
Comment:
Revision 8 as of 2008-09-05 22:17:40
Size: 2076
Editor: tonfa
Comment: it is now distributed
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:

'''This extension is distributed with recent builds of Mercurial, but not in a formal release.'''

Inotify Extension

Author: Bryan O'Sullivan

Overview

This extension uses the Linux 2.6 inotify API to make status instantaneous for even very large repositories, by subscribing to the paths in the repository instead of having to check them all at every status command.

Installation and configuration

The inotify extension is now distributed with the Mercurial source, though it is not yet present in a formal release.

To enable it, edit your hgrc:

[extensions]
inotify =

You can either enable it for each individual repository you need it in, or globally.

The extension contains both a server and a client component. By default, you have to start the server by hand, using the hg inserve command. To make it start automatically, edit your hgrc:

[inotify]
autostart = True

Obsolete installation instructions

These instructions apply to older, out-of-tree versions of the inotify extension.

Installation

The inotify extension requires Bryan's [http://hg.kublai.com/python/inotify python bindings for inotify]. You can either install them the normal way (via setup.py) or do an in-place build setup.py build_ext -i, then create a symlink from the inotify directory into the inotify extension directory. For example:

$ hg clone http://hg.kublai.com/python/inotify python-inotify
$ cd python-inotify
$ python setup.py build_ext -i
$ cd ..
$ hg clone http://hg.kublai.com/mercurial/extensions/inotify
$ cd inotify
$ ln -s ../python-inotify/inotify .

The extension should now be ready to use.

Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
inotify=/path/to/inotify

You can either start up the inotify extension on a repository with hg inserve or have it autostart with the following .hgrc snippet (either global or in the repository .hg/hgrc in which you would like to use inotify:

[inotify]
autostart = true


CategoryExtension

InotifyExtension (last edited 2014-03-24 01:53:35 by Rain)