mirror of https://github.com/ethereum/go-ethereum
parent
ee1682ffe6
commit
ef63e9af55
@ -0,0 +1,88 @@ |
||||
# Created by https://www.gitignore.io |
||||
|
||||
### OSX ### |
||||
.DS_Store |
||||
.AppleDouble |
||||
.LSOverride |
||||
|
||||
# Icon must end with two \r |
||||
Icon
|
||||
|
||||
# Thumbnails |
||||
._* |
||||
|
||||
# Files that might appear on external disk |
||||
.Spotlight-V100 |
||||
.Trashes |
||||
|
||||
# Directories potentially created on remote AFP share |
||||
.AppleDB |
||||
.AppleDesktop |
||||
Network Trash Folder |
||||
Temporary Items |
||||
.apdisk |
||||
|
||||
|
||||
### Windows ### |
||||
# Windows image file caches |
||||
Thumbs.db |
||||
ehthumbs.db |
||||
|
||||
# Folder config file |
||||
Desktop.ini |
||||
|
||||
# Recycle Bin used on file shares |
||||
$RECYCLE.BIN/ |
||||
|
||||
# Windows Installer files |
||||
*.cab |
||||
*.msi |
||||
*.msm |
||||
*.msp |
||||
|
||||
# Windows shortcuts |
||||
*.lnk |
||||
|
||||
|
||||
### Linux ### |
||||
*~ |
||||
|
||||
# KDE directory preferences |
||||
.directory |
||||
|
||||
|
||||
### Go ### |
||||
# Compiled Object files, Static and Dynamic libs (Shared Objects) |
||||
*.o |
||||
*.a |
||||
*.so |
||||
|
||||
# Folders |
||||
_obj |
||||
_test |
||||
|
||||
# Architecture specific extensions/prefixes |
||||
*.[568vq] |
||||
[568vq].out |
||||
|
||||
*.cgo1.go |
||||
*.cgo2.c |
||||
_cgo_defun.c |
||||
_cgo_gotypes.go |
||||
_cgo_export.* |
||||
|
||||
_testmain.go |
||||
|
||||
*.exe |
||||
*.test |
||||
*.prof |
||||
|
||||
|
||||
### vim ### |
||||
[._]*.s[a-w][a-z] |
||||
[._]s[a-w][a-z] |
||||
*.un~ |
||||
Session.vim |
||||
.netrwhist |
||||
*~ |
||||
|
@ -0,0 +1,30 @@ |
||||
language: go |
||||
|
||||
go: |
||||
- 1.4.3 |
||||
- 1.6 |
||||
|
||||
os: |
||||
- linux |
||||
- osx |
||||
|
||||
matrix: |
||||
include: |
||||
- os: osx |
||||
go: 1.6 |
||||
env: |
||||
- GOFLAGS="-tags kqueue" |
||||
|
||||
env: |
||||
global: |
||||
- GOBIN=$HOME/bin |
||||
- PATH=$HOME/bin:$PATH |
||||
|
||||
install: |
||||
- go get golang.org/x/tools/cmd/vet |
||||
- go get -t -v ./... |
||||
|
||||
script: |
||||
- go tool vet -all . |
||||
- go install $GOFLAGS ./... |
||||
- go test -v -race $GOFLAGS ./... |
@ -0,0 +1,10 @@ |
||||
# List of individuals who contributed to the Notify package. |
||||
# |
||||
# The up-to-date list of the authors one may obtain with: |
||||
# |
||||
# ~ $ git shortlog -es | cut -f2 | rev | uniq -f1 | rev |
||||
# |
||||
|
||||
Pawel Blaszczyk <blaszczykpb@gmail.com> |
||||
Pawel Knap <pawelknap88@gmail.com> |
||||
Rafal Jeczalik <rjeczalik@gmail.com> |
@ -0,0 +1,21 @@ |
||||
The MIT License (MIT) |
||||
|
||||
Copyright (c) 2014-2015 The Notify Authors |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy |
||||
of this software and associated documentation files (the "Software"), to deal |
||||
in the Software without restriction, including without limitation the rights |
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||||
copies of the Software, and to permit persons to whom the Software is |
||||
furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included in all |
||||
copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
||||
SOFTWARE. |
@ -0,0 +1,21 @@ |
||||
notify [![GoDoc](https://godoc.org/github.com/rjeczalik/notify?status.svg)](https://godoc.org/github.com/rjeczalik/notify) [![Build Status](https://img.shields.io/travis/rjeczalik/notify/master.svg)](https://travis-ci.org/rjeczalik/notify "inotify + FSEvents + kqueue") [![Build status](https://img.shields.io/appveyor/ci/rjeczalik/notify-246.svg)](https://ci.appveyor.com/project/rjeczalik/notify-246 "ReadDirectoryChangesW") [![Coverage Status](https://img.shields.io/coveralls/rjeczalik/notify/master.svg)](https://coveralls.io/r/rjeczalik/notify?branch=master) |
||||
====== |
||||
|
||||
Filesystem event notification library on steroids. (under active development) |
||||
|
||||
*Documentation* |
||||
|
||||
[godoc.org/github.com/rjeczalik/notify](https://godoc.org/github.com/rjeczalik/notify) |
||||
|
||||
*Installation* |
||||
|
||||
``` |
||||
~ $ go get -u github.com/rjeczalik/notify |
||||
``` |
||||
|
||||
*Projects using notify* |
||||
|
||||
- [github.com/rjeczalik/cmd/notify](https://godoc.org/github.com/rjeczalik/cmd/notify) |
||||
- [github.com/cortesi/devd](https://github.com/cortesi/devd) |
||||
- [github.com/cortesi/modd](https://github.com/cortesi/modd) |
||||
|
@ -0,0 +1,24 @@ |
||||
version: "{build}" |
||||
|
||||
os: Windows Server 2012 R2 |
||||
|
||||
clone_folder: c:\projects\src\github.com\rjeczalik\notify |
||||
|
||||
environment: |
||||
PATH: c:\projects\bin;%PATH% |
||||
GOPATH: c:\projects |
||||
NOTIFY_TIMEOUT: 5s |
||||
|
||||
install: |
||||
- go version |
||||
- go get golang.org/x/tools/cmd/vet |
||||
- go get -v -t ./... |
||||
|
||||
build_script: |
||||
- go tool vet -all . |
||||
- go build ./... |
||||
- go test -v -race ./... |
||||
|
||||
test: off |
||||
|
||||
deploy: off |
@ -0,0 +1,11 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build !debug
|
||||
|
||||
package notify |
||||
|
||||
func dbgprint(...interface{}) {} |
||||
|
||||
func dbgprintf(string, ...interface{}) {} |
@ -0,0 +1,43 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build debug
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"fmt" |
||||
"os" |
||||
"runtime" |
||||
"strings" |
||||
) |
||||
|
||||
func dbgprint(v ...interface{}) { |
||||
fmt.Printf("[D] ") |
||||
fmt.Print(v...) |
||||
fmt.Printf("\n\n") |
||||
} |
||||
|
||||
func dbgprintf(format string, v ...interface{}) { |
||||
fmt.Printf("[D] ") |
||||
fmt.Printf(format, v...) |
||||
fmt.Printf("\n\n") |
||||
} |
||||
|
||||
func dbgcallstack(max int) []string { |
||||
pc, stack := make([]uintptr, max), make([]string, 0, max) |
||||
runtime.Callers(2, pc) |
||||
for _, pc := range pc { |
||||
if f := runtime.FuncForPC(pc); f != nil { |
||||
fname := f.Name() |
||||
idx := strings.LastIndex(fname, string(os.PathSeparator)) |
||||
if idx != -1 { |
||||
stack = append(stack, fname[idx+1:]) |
||||
} else { |
||||
stack = append(stack, fname) |
||||
} |
||||
} |
||||
} |
||||
return stack |
||||
} |
@ -0,0 +1,40 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// Package notify implements access to filesystem events.
|
||||
//
|
||||
// Notify is a high-level abstraction over filesystem watchers like inotify,
|
||||
// kqueue, FSEvents, FEN or ReadDirectoryChangesW. Watcher implementations are
|
||||
// split into two groups: ones that natively support recursive notifications
|
||||
// (FSEvents and ReadDirectoryChangesW) and ones that do not (inotify, kqueue, FEN).
|
||||
// For more details see watcher and recursiveWatcher interfaces in watcher.go
|
||||
// source file.
|
||||
//
|
||||
// On top of filesystem watchers notify maintains a watchpoint tree, which provides
|
||||
// strategy for creating and closing filesystem watches and dispatching filesystem
|
||||
// events to user channels.
|
||||
//
|
||||
// An event set is just an event list joint using bitwise OR operator
|
||||
// into a single event value.
|
||||
//
|
||||
// A filesystem watch or just a watch is platform-specific entity which represents
|
||||
// a single path registered for notifications for specific event set. Setting a watch
|
||||
// means using platform-specific API calls for creating / initializing said watch.
|
||||
// For each watcher the API call is:
|
||||
//
|
||||
// - FSEvents: FSEventStreamCreate
|
||||
// - inotify: notify_add_watch
|
||||
// - kqueue: kevent
|
||||
// - ReadDirectoryChangesW: CreateFile+ReadDirectoryChangesW
|
||||
// - FEN: port_get
|
||||
//
|
||||
// To rewatch means to either shrink or expand an event set that was previously
|
||||
// registered during watch operation for particular filesystem watch.
|
||||
//
|
||||
// A watchpoint is a list of user channel and event set pairs for particular
|
||||
// path (watchpoint tree's node). A single watchpoint can contain multiple
|
||||
// different user channels registered to listen for one or more events. A single
|
||||
// user channel can be registered in one or more watchpoints, recurisve and
|
||||
// non-recursive ones as well.
|
||||
package notify |
@ -0,0 +1,143 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"fmt" |
||||
"strings" |
||||
) |
||||
|
||||
// Event represents the type of filesystem action.
|
||||
//
|
||||
// Number of available event values is dependent on the target system or the
|
||||
// watcher implmenetation used (e.g. it's possible to use either kqueue or
|
||||
// FSEvents on Darwin).
|
||||
//
|
||||
// Please consult documentation for your target platform to see list of all
|
||||
// available events.
|
||||
type Event uint32 |
||||
|
||||
// Create, Remove, Write and Rename are the only event values guaranteed to be
|
||||
// present on all platforms.
|
||||
const ( |
||||
Create = osSpecificCreate |
||||
Remove = osSpecificRemove |
||||
Write = osSpecificWrite |
||||
Rename = osSpecificRename |
||||
|
||||
// All is handful alias for all platform-independent event values.
|
||||
All = Create | Remove | Write | Rename |
||||
) |
||||
|
||||
const internal = recursive | omit |
||||
|
||||
// String implements fmt.Stringer interface.
|
||||
func (e Event) String() string { |
||||
var s []string |
||||
for _, strmap := range []map[Event]string{estr, osestr} { |
||||
for ev, str := range strmap { |
||||
if e&ev == ev { |
||||
s = append(s, str) |
||||
} |
||||
} |
||||
} |
||||
return strings.Join(s, "|") |
||||
} |
||||
|
||||
// EventInfo describes an event reported by the underlying filesystem notification
|
||||
// subsystem.
|
||||
//
|
||||
// It always describes single event, even if the OS reported a coalesced action.
|
||||
// Reported path is absolute and clean.
|
||||
//
|
||||
// For non-recursive watchpoints its base is always equal to the path passed
|
||||
// to corresponding Watch call.
|
||||
//
|
||||
// The value of Sys if system-dependent and can be nil.
|
||||
//
|
||||
// Sys
|
||||
//
|
||||
// Under Darwin (FSEvents) Sys() always returns a non-nil *notify.FSEvent value,
|
||||
// which is defined as:
|
||||
//
|
||||
// type FSEvent struct {
|
||||
// Path string // real path of the file or directory
|
||||
// ID uint64 // ID of the event (FSEventStreamEventId)
|
||||
// Flags uint32 // joint FSEvents* flags (FSEventStreamEventFlags)
|
||||
// }
|
||||
//
|
||||
// For possible values of Flags see Darwin godoc for notify or FSEvents
|
||||
// documentation for FSEventStreamEventFlags constants:
|
||||
//
|
||||
// https://developer.apple.com/library/mac/documentation/Darwin/Reference/FSEvents_Ref/index.html#//apple_ref/doc/constant_group/FSEventStreamEventFlags
|
||||
//
|
||||
// Under Linux (inotify) Sys() always returns a non-nil *syscall.InotifyEvent
|
||||
// value, defined as:
|
||||
//
|
||||
// type InotifyEvent struct {
|
||||
// Wd int32 // Watch descriptor
|
||||
// Mask uint32 // Mask describing event
|
||||
// Cookie uint32 // Unique cookie associating related events (for rename(2))
|
||||
// Len uint32 // Size of name field
|
||||
// Name [0]uint8 // Optional null-terminated name
|
||||
// }
|
||||
//
|
||||
// More information about inotify masks and the usage of inotify_event structure
|
||||
// can be found at:
|
||||
//
|
||||
// http://man7.org/linux/man-pages/man7/inotify.7.html
|
||||
//
|
||||
// Under Darwin, DragonFlyBSD, FreeBSD, NetBSD, OpenBSD (kqueue) Sys() always
|
||||
// returns a non-nil *notify.Kevent value, which is defined as:
|
||||
//
|
||||
// type Kevent struct {
|
||||
// Kevent *syscall.Kevent_t // Kevent is a kqueue specific structure
|
||||
// FI os.FileInfo // FI describes file/dir
|
||||
// }
|
||||
//
|
||||
// More information about syscall.Kevent_t can be found at:
|
||||
//
|
||||
// https://www.freebsd.org/cgi/man.cgi?query=kqueue
|
||||
//
|
||||
// Under Windows (ReadDirectoryChangesW) Sys() always returns nil. The documentation
|
||||
// of watcher's WinAPI function can be found at:
|
||||
//
|
||||
// https://msdn.microsoft.com/en-us/library/windows/desktop/aa365465%28v=vs.85%29.aspx
|
||||
type EventInfo interface { |
||||
Event() Event // event value for the filesystem action
|
||||
Path() string // real path of the file or directory
|
||||
Sys() interface{} // underlying data source (can return nil)
|
||||
} |
||||
|
||||
type isDirer interface { |
||||
isDir() (bool, error) |
||||
} |
||||
|
||||
var _ fmt.Stringer = (*event)(nil) |
||||
var _ isDirer = (*event)(nil) |
||||
|
||||
// String implements fmt.Stringer interface.
|
||||
func (e *event) String() string { |
||||
return e.Event().String() + `: "` + e.Path() + `"` |
||||
} |
||||
|
||||
var estr = map[Event]string{ |
||||
Create: "notify.Create", |
||||
Remove: "notify.Remove", |
||||
Write: "notify.Write", |
||||
Rename: "notify.Rename", |
||||
// Display name for recursive event is added only for debugging
|
||||
// purposes. It's an internal event after all and won't be exposed to the
|
||||
// user. Having Recursive event printable is helpful, e.g. for reading
|
||||
// testing failure messages:
|
||||
//
|
||||
// --- FAIL: TestWatchpoint (0.00 seconds)
|
||||
// watchpoint_test.go:64: want diff=[notify.Remove notify.Create|notify.Remove];
|
||||
// got [notify.Remove notify.Remove|notify.Create] (i=1)
|
||||
//
|
||||
// Yup, here the diff have Recursive event inside. Go figure.
|
||||
recursive: "recursive", |
||||
omit: "omit", |
||||
} |
@ -0,0 +1,46 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build solaris
|
||||
|
||||
package notify |
||||
|
||||
const ( |
||||
osSpecificCreate Event = 0x00000100 << iota |
||||
osSpecificRemove |
||||
osSpecificWrite |
||||
osSpecificRename |
||||
// internal
|
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit |
||||
) |
||||
|
||||
const ( |
||||
FileAccess = fileAccess |
||||
FileModified = fileModified |
||||
FileAttrib = fileAttrib |
||||
FileDelete = fileDelete |
||||
FileRenameTo = fileRenameTo |
||||
FileRenameFrom = fileRenameFrom |
||||
FileTrunc = fileTrunc |
||||
FileNoFollow = fileNoFollow |
||||
Unmounted = unmounted |
||||
MountedOver = mountedOver |
||||
) |
||||
|
||||
var osestr = map[Event]string{ |
||||
FileAccess: "notify.FileAccess", |
||||
FileModified: "notify.FileModified", |
||||
FileAttrib: "notify.FileAttrib", |
||||
FileDelete: "notify.FileDelete", |
||||
FileRenameTo: "notify.FileRenameTo", |
||||
FileRenameFrom: "notify.FileRenameFrom", |
||||
FileTrunc: "notify.FileTrunc", |
||||
FileNoFollow: "notify.FileNoFollow", |
||||
Unmounted: "notify.Unmounted", |
||||
MountedOver: "notify.MountedOver", |
||||
} |
@ -0,0 +1,71 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,!kqueue
|
||||
|
||||
package notify |
||||
|
||||
const ( |
||||
osSpecificCreate = Event(FSEventsCreated) |
||||
osSpecificRemove = Event(FSEventsRemoved) |
||||
osSpecificWrite = Event(FSEventsModified) |
||||
osSpecificRename = Event(FSEventsRenamed) |
||||
// internal = Event(0x100000)
|
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive = Event(0x200000) |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit = Event(0x400000) |
||||
) |
||||
|
||||
// FSEvents specific event values.
|
||||
const ( |
||||
FSEventsMustScanSubDirs Event = 0x00001 |
||||
FSEventsUserDropped = 0x00002 |
||||
FSEventsKernelDropped = 0x00004 |
||||
FSEventsEventIdsWrapped = 0x00008 |
||||
FSEventsHistoryDone = 0x00010 |
||||
FSEventsRootChanged = 0x00020 |
||||
FSEventsMount = 0x00040 |
||||
FSEventsUnmount = 0x00080 |
||||
FSEventsCreated = 0x00100 |
||||
FSEventsRemoved = 0x00200 |
||||
FSEventsInodeMetaMod = 0x00400 |
||||
FSEventsRenamed = 0x00800 |
||||
FSEventsModified = 0x01000 |
||||
FSEventsFinderInfoMod = 0x02000 |
||||
FSEventsChangeOwner = 0x04000 |
||||
FSEventsXattrMod = 0x08000 |
||||
FSEventsIsFile = 0x10000 |
||||
FSEventsIsDir = 0x20000 |
||||
FSEventsIsSymlink = 0x40000 |
||||
) |
||||
|
||||
var osestr = map[Event]string{ |
||||
FSEventsMustScanSubDirs: "notify.FSEventsMustScanSubDirs", |
||||
FSEventsUserDropped: "notify.FSEventsUserDropped", |
||||
FSEventsKernelDropped: "notify.FSEventsKernelDropped", |
||||
FSEventsEventIdsWrapped: "notify.FSEventsEventIdsWrapped", |
||||
FSEventsHistoryDone: "notify.FSEventsHistoryDone", |
||||
FSEventsRootChanged: "notify.FSEventsRootChanged", |
||||
FSEventsMount: "notify.FSEventsMount", |
||||
FSEventsUnmount: "notify.FSEventsUnmount", |
||||
FSEventsInodeMetaMod: "notify.FSEventsInodeMetaMod", |
||||
FSEventsFinderInfoMod: "notify.FSEventsFinderInfoMod", |
||||
FSEventsChangeOwner: "notify.FSEventsChangeOwner", |
||||
FSEventsXattrMod: "notify.FSEventsXattrMod", |
||||
FSEventsIsFile: "notify.FSEventsIsFile", |
||||
FSEventsIsDir: "notify.FSEventsIsDir", |
||||
FSEventsIsSymlink: "notify.FSEventsIsSymlink", |
||||
} |
||||
|
||||
type event struct { |
||||
fse FSEvent |
||||
event Event |
||||
} |
||||
|
||||
func (ei *event) Event() Event { return ei.event } |
||||
func (ei *event) Path() string { return ei.fse.Path } |
||||
func (ei *event) Sys() interface{} { return &ei.fse } |
||||
func (ei *event) isDir() (bool, error) { return ei.fse.Flags&FSEventsIsDir != 0, nil } |
@ -0,0 +1,75 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build linux
|
||||
|
||||
package notify |
||||
|
||||
import "syscall" |
||||
|
||||
// Platform independent event values.
|
||||
const ( |
||||
osSpecificCreate Event = 0x100000 << iota |
||||
osSpecificRemove |
||||
osSpecificWrite |
||||
osSpecificRename |
||||
// internal
|
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit |
||||
) |
||||
|
||||
// Inotify specific masks are legal, implemented events that are guaranteed to
|
||||
// work with notify package on linux-based systems.
|
||||
const ( |
||||
InAccess = Event(syscall.IN_ACCESS) // File was accessed
|
||||
InModify = Event(syscall.IN_MODIFY) // File was modified
|
||||
InAttrib = Event(syscall.IN_ATTRIB) // Metadata changed
|
||||
InCloseWrite = Event(syscall.IN_CLOSE_WRITE) // Writtable file was closed
|
||||
InCloseNowrite = Event(syscall.IN_CLOSE_NOWRITE) // Unwrittable file closed
|
||||
InOpen = Event(syscall.IN_OPEN) // File was opened
|
||||
InMovedFrom = Event(syscall.IN_MOVED_FROM) // File was moved from X
|
||||
InMovedTo = Event(syscall.IN_MOVED_TO) // File was moved to Y
|
||||
InCreate = Event(syscall.IN_CREATE) // Subfile was created
|
||||
InDelete = Event(syscall.IN_DELETE) // Subfile was deleted
|
||||
InDeleteSelf = Event(syscall.IN_DELETE_SELF) // Self was deleted
|
||||
InMoveSelf = Event(syscall.IN_MOVE_SELF) // Self was moved
|
||||
) |
||||
|
||||
var osestr = map[Event]string{ |
||||
InAccess: "notify.InAccess", |
||||
InModify: "notify.InModify", |
||||
InAttrib: "notify.InAttrib", |
||||
InCloseWrite: "notify.InCloseWrite", |
||||
InCloseNowrite: "notify.InCloseNowrite", |
||||
InOpen: "notify.InOpen", |
||||
InMovedFrom: "notify.InMovedFrom", |
||||
InMovedTo: "notify.InMovedTo", |
||||
InCreate: "notify.InCreate", |
||||
InDelete: "notify.InDelete", |
||||
InDeleteSelf: "notify.InDeleteSelf", |
||||
InMoveSelf: "notify.InMoveSelf", |
||||
} |
||||
|
||||
// Inotify behavior events are not **currently** supported by notify package.
|
||||
const ( |
||||
inDontFollow = Event(syscall.IN_DONT_FOLLOW) |
||||
inExclUnlink = Event(syscall.IN_EXCL_UNLINK) |
||||
inMaskAdd = Event(syscall.IN_MASK_ADD) |
||||
inOneshot = Event(syscall.IN_ONESHOT) |
||||
inOnlydir = Event(syscall.IN_ONLYDIR) |
||||
) |
||||
|
||||
type event struct { |
||||
sys syscall.InotifyEvent |
||||
path string |
||||
event Event |
||||
} |
||||
|
||||
func (e *event) Event() Event { return e.event } |
||||
func (e *event) Path() string { return e.path } |
||||
func (e *event) Sys() interface{} { return &e.sys } |
||||
func (e *event) isDir() (bool, error) { return e.sys.Mask&syscall.IN_ISDIR != 0, nil } |
@ -0,0 +1,59 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,kqueue dragonfly freebsd netbsd openbsd
|
||||
|
||||
package notify |
||||
|
||||
import "syscall" |
||||
|
||||
// TODO(pblaszczyk): ensure in runtime notify built-in event values do not
|
||||
// overlap with platform-defined ones.
|
||||
|
||||
// Platform independent event values.
|
||||
const ( |
||||
osSpecificCreate Event = 0x0100 << iota |
||||
osSpecificRemove |
||||
osSpecificWrite |
||||
osSpecificRename |
||||
// internal
|
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit |
||||
) |
||||
|
||||
const ( |
||||
// NoteDelete is an even reported when the unlink() system call was called
|
||||
// on the file referenced by the descriptor.
|
||||
NoteDelete = Event(syscall.NOTE_DELETE) |
||||
// NoteWrite is an event reported when a write occurred on the file
|
||||
// referenced by the descriptor.
|
||||
NoteWrite = Event(syscall.NOTE_WRITE) |
||||
// NoteExtend is an event reported when the file referenced by the
|
||||
// descriptor was extended.
|
||||
NoteExtend = Event(syscall.NOTE_EXTEND) |
||||
// NoteAttrib is an event reported when the file referenced
|
||||
// by the descriptor had its attributes changed.
|
||||
NoteAttrib = Event(syscall.NOTE_ATTRIB) |
||||
// NoteLink is an event reported when the link count on the file changed.
|
||||
NoteLink = Event(syscall.NOTE_LINK) |
||||
// NoteRename is an event reported when the file referenced
|
||||
// by the descriptor was renamed.
|
||||
NoteRename = Event(syscall.NOTE_RENAME) |
||||
// NoteRevoke is an event reported when access to the file was revoked via
|
||||
// revoke(2) or the underlying file system was unmounted.
|
||||
NoteRevoke = Event(syscall.NOTE_REVOKE) |
||||
) |
||||
|
||||
var osestr = map[Event]string{ |
||||
NoteDelete: "notify.NoteDelete", |
||||
NoteWrite: "notify.NoteWrite", |
||||
NoteExtend: "notify.NoteExtend", |
||||
NoteAttrib: "notify.NoteAttrib", |
||||
NoteLink: "notify.NoteLink", |
||||
NoteRename: "notify.NoteRename", |
||||
NoteRevoke: "notify.NoteRevoke", |
||||
} |
@ -0,0 +1,108 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build windows
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"os" |
||||
"path/filepath" |
||||
"syscall" |
||||
) |
||||
|
||||
// Platform independent event values.
|
||||
const ( |
||||
osSpecificCreate Event = 1 << (20 + iota) |
||||
osSpecificRemove |
||||
osSpecificWrite |
||||
osSpecificRename |
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit |
||||
// dirmarker TODO(pknap)
|
||||
dirmarker |
||||
) |
||||
|
||||
// ReadDirectoryChangesW filters.
|
||||
const ( |
||||
FileNotifyChangeFileName = Event(syscall.FILE_NOTIFY_CHANGE_FILE_NAME) |
||||
FileNotifyChangeDirName = Event(syscall.FILE_NOTIFY_CHANGE_DIR_NAME) |
||||
FileNotifyChangeAttributes = Event(syscall.FILE_NOTIFY_CHANGE_ATTRIBUTES) |
||||
FileNotifyChangeSize = Event(syscall.FILE_NOTIFY_CHANGE_SIZE) |
||||
FileNotifyChangeLastWrite = Event(syscall.FILE_NOTIFY_CHANGE_LAST_WRITE) |
||||
FileNotifyChangeLastAccess = Event(syscall.FILE_NOTIFY_CHANGE_LAST_ACCESS) |
||||
FileNotifyChangeCreation = Event(syscall.FILE_NOTIFY_CHANGE_CREATION) |
||||
FileNotifyChangeSecurity = Event(syscallFileNotifyChangeSecurity) |
||||
) |
||||
|
||||
const ( |
||||
fileNotifyChangeAll = 0x17f // logical sum of all FileNotifyChange* events.
|
||||
fileNotifyChangeModified = fileNotifyChangeAll &^ (FileNotifyChangeFileName | FileNotifyChangeDirName) |
||||
) |
||||
|
||||
// according to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa365465(v=vs.85).aspx
|
||||
// this flag should be declared in: http://golang.org/src/pkg/syscall/ztypes_windows.go
|
||||
const syscallFileNotifyChangeSecurity = 0x00000100 |
||||
|
||||
// ReadDirectoryChangesW actions.
|
||||
const ( |
||||
FileActionAdded = Event(syscall.FILE_ACTION_ADDED) << 12 |
||||
FileActionRemoved = Event(syscall.FILE_ACTION_REMOVED) << 12 |
||||
FileActionModified = Event(syscall.FILE_ACTION_MODIFIED) << 14 |
||||
FileActionRenamedOldName = Event(syscall.FILE_ACTION_RENAMED_OLD_NAME) << 15 |
||||
FileActionRenamedNewName = Event(syscall.FILE_ACTION_RENAMED_NEW_NAME) << 16 |
||||
) |
||||
|
||||
const fileActionAll = 0x7f000 // logical sum of all FileAction* events.
|
||||
|
||||
var osestr = map[Event]string{ |
||||
FileNotifyChangeFileName: "notify.FileNotifyChangeFileName", |
||||
FileNotifyChangeDirName: "notify.FileNotifyChangeDirName", |
||||
FileNotifyChangeAttributes: "notify.FileNotifyChangeAttributes", |
||||
FileNotifyChangeSize: "notify.FileNotifyChangeSize", |
||||
FileNotifyChangeLastWrite: "notify.FileNotifyChangeLastWrite", |
||||
FileNotifyChangeLastAccess: "notify.FileNotifyChangeLastAccess", |
||||
FileNotifyChangeCreation: "notify.FileNotifyChangeCreation", |
||||
FileNotifyChangeSecurity: "notify.FileNotifyChangeSecurity", |
||||
|
||||
FileActionAdded: "notify.FileActionAdded", |
||||
FileActionRemoved: "notify.FileActionRemoved", |
||||
FileActionModified: "notify.FileActionModified", |
||||
FileActionRenamedOldName: "notify.FileActionRenamedOldName", |
||||
FileActionRenamedNewName: "notify.FileActionRenamedNewName", |
||||
} |
||||
|
||||
const ( |
||||
fTypeUnknown uint8 = iota |
||||
fTypeFile |
||||
fTypeDirectory |
||||
) |
||||
|
||||
// TODO(ppknap) : doc.
|
||||
type event struct { |
||||
pathw []uint16 |
||||
name string |
||||
ftype uint8 |
||||
action uint32 |
||||
filter uint32 |
||||
e Event |
||||
} |
||||
|
||||
func (e *event) Event() Event { return e.e } |
||||
func (e *event) Path() string { return filepath.Join(syscall.UTF16ToString(e.pathw), e.name) } |
||||
func (e *event) Sys() interface{} { return e.ftype } |
||||
|
||||
func (e *event) isDir() (bool, error) { |
||||
if e.ftype != fTypeUnknown { |
||||
return e.ftype == fTypeDirectory, nil |
||||
} |
||||
fi, err := os.Stat(e.Path()) |
||||
if err != nil { |
||||
return false, err |
||||
} |
||||
return fi.IsDir(), nil |
||||
} |
@ -0,0 +1,31 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build !darwin,!linux,!freebsd,!dragonfly,!netbsd,!openbsd,!windows
|
||||
// +build !kqueue,!solaris
|
||||
|
||||
package notify |
||||
|
||||
// Platform independent event values.
|
||||
const ( |
||||
osSpecificCreate Event = 1 << iota |
||||
osSpecificRemove |
||||
osSpecificWrite |
||||
osSpecificRename |
||||
// internal
|
||||
// recursive is used to distinguish recursive eventsets from non-recursive ones
|
||||
recursive |
||||
// omit is used for dispatching internal events; only those events are sent
|
||||
// for which both the event and the watchpoint has omit in theirs event sets.
|
||||
omit |
||||
) |
||||
|
||||
var osestr = map[Event]string{} |
||||
|
||||
type event struct{} |
||||
|
||||
func (e *event) Event() (_ Event) { return } |
||||
func (e *event) Path() (_ string) { return } |
||||
func (e *event) Sys() (_ interface{}) { return } |
||||
func (e *event) isDir() (_ bool, _ error) { return } |
@ -0,0 +1,22 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,kqueue dragonfly freebsd netbsd openbsd solaris
|
||||
|
||||
package notify |
||||
|
||||
type event struct { |
||||
p string |
||||
e Event |
||||
d bool |
||||
pe interface{} |
||||
} |
||||
|
||||
func (e *event) Event() Event { return e.e } |
||||
|
||||
func (e *event) Path() string { return e.p } |
||||
|
||||
func (e *event) Sys() interface{} { return e.pe } |
||||
|
||||
func (e *event) isDir() (bool, error) { return e.d, nil } |
@ -0,0 +1,271 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"errors" |
||||
"io/ioutil" |
||||
"os" |
||||
"path/filepath" |
||||
) |
||||
|
||||
var errSkip = errors.New("notify: skip") |
||||
|
||||
type walkPathFunc func(nd node, isbase bool) error |
||||
|
||||
type walkFunc func(node) error |
||||
|
||||
func errnotexist(name string) error { |
||||
return &os.PathError{ |
||||
Op: "Node", |
||||
Path: name, |
||||
Err: os.ErrNotExist, |
||||
} |
||||
} |
||||
|
||||
type node struct { |
||||
Name string |
||||
Watch watchpoint |
||||
Child map[string]node |
||||
} |
||||
|
||||
func newnode(name string) node { |
||||
return node{ |
||||
Name: name, |
||||
Watch: make(watchpoint), |
||||
Child: make(map[string]node), |
||||
} |
||||
} |
||||
|
||||
func (nd node) addchild(name, base string) node { |
||||
child, ok := nd.Child[base] |
||||
if !ok { |
||||
child = newnode(name) |
||||
nd.Child[base] = child |
||||
} |
||||
return child |
||||
} |
||||
|
||||
func (nd node) Add(name string) node { |
||||
i := indexbase(nd.Name, name) |
||||
if i == -1 { |
||||
return node{} |
||||
} |
||||
for j := indexSep(name[i:]); j != -1; j = indexSep(name[i:]) { |
||||
nd = nd.addchild(name[:i+j], name[i:i+j]) |
||||
i += j + 1 |
||||
} |
||||
return nd.addchild(name, name[i:]) |
||||
} |
||||
|
||||
func (nd node) AddDir(fn walkFunc) error { |
||||
stack := []node{nd} |
||||
Traverse: |
||||
for n := len(stack); n != 0; n = len(stack) { |
||||
nd, stack = stack[n-1], stack[:n-1] |
||||
switch err := fn(nd); err { |
||||
case nil: |
||||
case errSkip: |
||||
continue Traverse |
||||
default: |
||||
return err |
||||
} |
||||
// TODO(rjeczalik): tolerate open failures - add failed names to
|
||||
// AddDirError and notify users which names are not added to the tree.
|
||||
fi, err := ioutil.ReadDir(nd.Name) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
for _, fi := range fi { |
||||
if fi.Mode()&(os.ModeSymlink|os.ModeDir) == os.ModeDir { |
||||
name := filepath.Join(nd.Name, fi.Name()) |
||||
stack = append(stack, nd.addchild(name, name[len(nd.Name)+1:])) |
||||
} |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (nd node) Get(name string) (node, error) { |
||||
i := indexbase(nd.Name, name) |
||||
if i == -1 { |
||||
return node{}, errnotexist(name) |
||||
} |
||||
ok := false |
||||
for j := indexSep(name[i:]); j != -1; j = indexSep(name[i:]) { |
||||
if nd, ok = nd.Child[name[i:i+j]]; !ok { |
||||
return node{}, errnotexist(name) |
||||
} |
||||
i += j + 1 |
||||
} |
||||
if nd, ok = nd.Child[name[i:]]; !ok { |
||||
return node{}, errnotexist(name) |
||||
} |
||||
return nd, nil |
||||
} |
||||
|
||||
func (nd node) Del(name string) error { |
||||
i := indexbase(nd.Name, name) |
||||
if i == -1 { |
||||
return errnotexist(name) |
||||
} |
||||
stack := []node{nd} |
||||
ok := false |
||||
for j := indexSep(name[i:]); j != -1; j = indexSep(name[i:]) { |
||||
if nd, ok = nd.Child[name[i:i+j]]; !ok { |
||||
return errnotexist(name[:i+j]) |
||||
} |
||||
stack = append(stack, nd) |
||||
} |
||||
if nd, ok = nd.Child[name[i:]]; !ok { |
||||
return errnotexist(name) |
||||
} |
||||
nd.Child = nil |
||||
nd.Watch = nil |
||||
for name, i = base(nd.Name), len(stack); i != 0; name, i = base(nd.Name), i-1 { |
||||
nd = stack[i-1] |
||||
if nd := nd.Child[name]; len(nd.Watch) > 1 || len(nd.Child) != 0 { |
||||
break |
||||
} else { |
||||
nd.Child = nil |
||||
nd.Watch = nil |
||||
} |
||||
delete(nd.Child, name) |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (nd node) Walk(fn walkFunc) error { |
||||
stack := []node{nd} |
||||
Traverse: |
||||
for n := len(stack); n != 0; n = len(stack) { |
||||
nd, stack = stack[n-1], stack[:n-1] |
||||
switch err := fn(nd); err { |
||||
case nil: |
||||
case errSkip: |
||||
continue Traverse |
||||
default: |
||||
return err |
||||
} |
||||
for name, nd := range nd.Child { |
||||
if name == "" { |
||||
// Node storing inactive watchpoints has empty name, skip it
|
||||
// form traversing. Root node has also an empty name, but it
|
||||
// never has a parent node.
|
||||
continue |
||||
} |
||||
stack = append(stack, nd) |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (nd node) WalkPath(name string, fn walkPathFunc) error { |
||||
i := indexbase(nd.Name, name) |
||||
if i == -1 { |
||||
return errnotexist(name) |
||||
} |
||||
ok := false |
||||
for j := indexSep(name[i:]); j != -1; j = indexSep(name[i:]) { |
||||
switch err := fn(nd, false); err { |
||||
case nil: |
||||
case errSkip: |
||||
return nil |
||||
default: |
||||
return err |
||||
} |
||||
if nd, ok = nd.Child[name[i:i+j]]; !ok { |
||||
return errnotexist(name[:i+j]) |
||||
} |
||||
i += j + 1 |
||||
} |
||||
switch err := fn(nd, false); err { |
||||
case nil: |
||||
case errSkip: |
||||
return nil |
||||
default: |
||||
return err |
||||
} |
||||
if nd, ok = nd.Child[name[i:]]; !ok { |
||||
return errnotexist(name) |
||||
} |
||||
switch err := fn(nd, true); err { |
||||
case nil, errSkip: |
||||
return nil |
||||
default: |
||||
return err |
||||
} |
||||
} |
||||
|
||||
type root struct { |
||||
nd node |
||||
} |
||||
|
||||
func (r root) addroot(name string) node { |
||||
if vol := filepath.VolumeName(name); vol != "" { |
||||
root, ok := r.nd.Child[vol] |
||||
if !ok { |
||||
root = r.nd.addchild(vol, vol) |
||||
} |
||||
return root |
||||
} |
||||
return r.nd |
||||
} |
||||
|
||||
func (r root) root(name string) (node, error) { |
||||
if vol := filepath.VolumeName(name); vol != "" { |
||||
nd, ok := r.nd.Child[vol] |
||||
if !ok { |
||||
return node{}, errnotexist(name) |
||||
} |
||||
return nd, nil |
||||
} |
||||
return r.nd, nil |
||||
} |
||||
|
||||
func (r root) Add(name string) node { |
||||
return r.addroot(name).Add(name) |
||||
} |
||||
|
||||
func (r root) AddDir(dir string, fn walkFunc) error { |
||||
return r.Add(dir).AddDir(fn) |
||||
} |
||||
|
||||
func (r root) Del(name string) error { |
||||
nd, err := r.root(name) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
return nd.Del(name) |
||||
} |
||||
|
||||
func (r root) Get(name string) (node, error) { |
||||
nd, err := r.root(name) |
||||
if err != nil { |
||||
return node{}, err |
||||
} |
||||
if nd.Name != name { |
||||
if nd, err = nd.Get(name); err != nil { |
||||
return node{}, err |
||||
} |
||||
} |
||||
return nd, nil |
||||
} |
||||
|
||||
func (r root) Walk(name string, fn walkFunc) error { |
||||
nd, err := r.Get(name) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
return nd.Walk(fn) |
||||
} |
||||
|
||||
func (r root) WalkPath(name string, fn walkPathFunc) error { |
||||
nd, err := r.root(name) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
return nd.WalkPath(name, fn) |
||||
} |
@ -0,0 +1,74 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// BUG(rjeczalik): Notify does not collect watchpoints, when underlying watches
|
||||
// were removed by their os-specific watcher implementations. Instead users are
|
||||
// advised to listen on persistant paths to have guarantee they receive events
|
||||
// for the whole lifetime of their applications (to discuss see #69).
|
||||
|
||||
// BUG(ppknap): Linux (inotify) does not support watcher behavior masks like
|
||||
// InOneshot, InOnlydir etc. Instead users are advised to perform the filtering
|
||||
// themselves (to discuss see #71).
|
||||
|
||||
// BUG(ppknap): Notify was not tested for short path name support under Windows
|
||||
// (ReadDirectoryChangesW).
|
||||
|
||||
// BUG(ppknap): Windows (ReadDirectoryChangesW) cannot recognize which notification
|
||||
// triggers FileActionModified event. (to discuss see #75).
|
||||
|
||||
package notify |
||||
|
||||
var defaultTree = newTree() |
||||
|
||||
// Watch sets up a watchpoint on path listening for events given by the events
|
||||
// argument.
|
||||
//
|
||||
// File or directory given by the path must exist, otherwise Watch will fail
|
||||
// with non-nil error. Notify resolves, for its internal purpose, any symlinks
|
||||
// the provided path may contain, so it may fail if the symlinks form a cycle.
|
||||
// It does so, since not all watcher implementations treat passed paths as-is.
|
||||
// E.g. FSEvents reports a real path for every event, setting a watchpoint
|
||||
// on /tmp will report events with paths rooted at /private/tmp etc.
|
||||
//
|
||||
// The c almost always is a buffered channel. Watch will not block sending to c
|
||||
// - the caller must ensure that c has sufficient buffer space to keep up with
|
||||
// the expected event rate.
|
||||
//
|
||||
// It is allowed to pass the same channel multiple times with different event
|
||||
// list or different paths. Calling Watch with different event lists for a single
|
||||
// watchpoint expands its event set. The only way to shrink it, is to call
|
||||
// Stop on its channel.
|
||||
//
|
||||
// Calling Watch with empty event list does expand nor shrink watchpoint's event
|
||||
// set. If c is the first channel to listen for events on the given path, Watch
|
||||
// will seamlessly create a watch on the filesystem.
|
||||
//
|
||||
// Notify dispatches copies of single filesystem event to all channels registered
|
||||
// for each path. If a single filesystem event contains multiple coalesced events,
|
||||
// each of them is dispatched separately. E.g. the following filesystem change:
|
||||
//
|
||||
// ~ $ echo Hello > Notify.txt
|
||||
//
|
||||
// dispatches two events - notify.Create and notify.Write. However, it may depend
|
||||
// on the underlying watcher implementation whether OS reports both of them.
|
||||
//
|
||||
// Windows and recursive watches
|
||||
//
|
||||
// If a directory which path was used to create recursive watch under Windows
|
||||
// gets deleted, the OS will not report such event. It is advised to keep in
|
||||
// mind this limitation while setting recursive watchpoints for your application,
|
||||
// e.g. use persistant paths like %userprofile% or watch additionally parent
|
||||
// directory of a recursive watchpoint in order to receive delete events for it.
|
||||
func Watch(path string, c chan<- EventInfo, events ...Event) error { |
||||
return defaultTree.Watch(path, c, events...) |
||||
} |
||||
|
||||
// Stop removes all watchpoints registered for c. All underlying watches are
|
||||
// also removed, for which c was the last channel listening for events.
|
||||
//
|
||||
// Stop does not close c. When Stop returns, it is guranteed that c will
|
||||
// receive no more signals.
|
||||
func Stop(c chan<- EventInfo) { |
||||
defaultTree.Stop(c) |
||||
} |
@ -0,0 +1,22 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
const buffer = 128 |
||||
|
||||
type tree interface { |
||||
Watch(string, chan<- EventInfo, ...Event) error |
||||
Stop(chan<- EventInfo) |
||||
Close() error |
||||
} |
||||
|
||||
func newTree() tree { |
||||
c := make(chan EventInfo, buffer) |
||||
w := newWatcher(c) |
||||
if rw, ok := w.(recursiveWatcher); ok { |
||||
return newRecursiveTree(rw, c) |
||||
} |
||||
return newNonrecursiveTree(w, c, make(chan EventInfo, buffer)) |
||||
} |
@ -0,0 +1,292 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import "sync" |
||||
|
||||
// nonrecursiveTree TODO(rjeczalik)
|
||||
type nonrecursiveTree struct { |
||||
rw sync.RWMutex // protects root
|
||||
root root |
||||
w watcher |
||||
c chan EventInfo |
||||
rec chan EventInfo |
||||
} |
||||
|
||||
// newNonrecursiveTree TODO(rjeczalik)
|
||||
func newNonrecursiveTree(w watcher, c, rec chan EventInfo) *nonrecursiveTree { |
||||
if rec == nil { |
||||
rec = make(chan EventInfo, buffer) |
||||
} |
||||
t := &nonrecursiveTree{ |
||||
root: root{nd: newnode("")}, |
||||
w: w, |
||||
c: c, |
||||
rec: rec, |
||||
} |
||||
go t.dispatch(c) |
||||
go t.internal(rec) |
||||
return t |
||||
} |
||||
|
||||
// dispatch TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) dispatch(c <-chan EventInfo) { |
||||
for ei := range c { |
||||
dbgprintf("dispatching %v on %q", ei.Event(), ei.Path()) |
||||
go func(ei EventInfo) { |
||||
var nd node |
||||
var isrec bool |
||||
dir, base := split(ei.Path()) |
||||
fn := func(it node, isbase bool) error { |
||||
isrec = isrec || it.Watch.IsRecursive() |
||||
if isbase { |
||||
nd = it |
||||
} else { |
||||
it.Watch.Dispatch(ei, recursive) |
||||
} |
||||
return nil |
||||
} |
||||
t.rw.RLock() |
||||
// Notify recursive watchpoints found on the path.
|
||||
if err := t.root.WalkPath(dir, fn); err != nil { |
||||
dbgprint("dispatch did not reach leaf:", err) |
||||
t.rw.RUnlock() |
||||
return |
||||
} |
||||
// Notify parent watchpoint.
|
||||
nd.Watch.Dispatch(ei, 0) |
||||
isrec = isrec || nd.Watch.IsRecursive() |
||||
// If leaf watchpoint exists, notify it.
|
||||
if nd, ok := nd.Child[base]; ok { |
||||
isrec = isrec || nd.Watch.IsRecursive() |
||||
nd.Watch.Dispatch(ei, 0) |
||||
} |
||||
t.rw.RUnlock() |
||||
// If the event describes newly leaf directory created within
|
||||
if !isrec || ei.Event() != Create { |
||||
return |
||||
} |
||||
if ok, err := ei.(isDirer).isDir(); !ok || err != nil { |
||||
return |
||||
} |
||||
t.rec <- ei |
||||
}(ei) |
||||
} |
||||
} |
||||
|
||||
// internal TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) internal(rec <-chan EventInfo) { |
||||
for ei := range rec { |
||||
var nd node |
||||
var eset = internal |
||||
t.rw.Lock() |
||||
t.root.WalkPath(ei.Path(), func(it node, _ bool) error { |
||||
if e := it.Watch[t.rec]; e != 0 && e > eset { |
||||
eset = e |
||||
} |
||||
nd = it |
||||
return nil |
||||
}) |
||||
if eset == internal { |
||||
t.rw.Unlock() |
||||
continue |
||||
} |
||||
err := nd.Add(ei.Path()).AddDir(t.recFunc(eset)) |
||||
t.rw.Unlock() |
||||
if err != nil { |
||||
dbgprintf("internal(%p) error: %v", rec, err) |
||||
} |
||||
} |
||||
} |
||||
|
||||
// watchAdd TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) watchAdd(nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
if e&recursive != 0 { |
||||
diff := nd.Watch.Add(t.rec, e|Create|omit) |
||||
nd.Watch.Add(c, e) |
||||
return diff |
||||
} |
||||
return nd.Watch.Add(c, e) |
||||
} |
||||
|
||||
// watchDelMin TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) watchDelMin(min Event, nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
old, ok := nd.Watch[t.rec] |
||||
if ok { |
||||
nd.Watch[t.rec] = min |
||||
} |
||||
diff := nd.Watch.Del(c, e) |
||||
if ok { |
||||
switch old &^= diff[0] &^ diff[1]; { |
||||
case old|internal == internal: |
||||
delete(nd.Watch, t.rec) |
||||
if set, ok := nd.Watch[nil]; ok && len(nd.Watch) == 1 && set == 0 { |
||||
delete(nd.Watch, nil) |
||||
} |
||||
default: |
||||
nd.Watch.Add(t.rec, old|Create) |
||||
switch { |
||||
case diff == none: |
||||
case diff[1]|Create == diff[0]: |
||||
diff = none |
||||
default: |
||||
diff[1] |= Create |
||||
} |
||||
} |
||||
} |
||||
return diff |
||||
} |
||||
|
||||
// watchDel TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) watchDel(nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
return t.watchDelMin(0, nd, c, e) |
||||
} |
||||
|
||||
// Watch TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) Watch(path string, c chan<- EventInfo, events ...Event) error { |
||||
if c == nil { |
||||
panic("notify: Watch using nil channel") |
||||
} |
||||
// Expanding with empty event set is a nop.
|
||||
if len(events) == 0 { |
||||
return nil |
||||
} |
||||
path, isrec, err := cleanpath(path) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
eset := joinevents(events) |
||||
t.rw.Lock() |
||||
defer t.rw.Unlock() |
||||
nd := t.root.Add(path) |
||||
if isrec { |
||||
return t.watchrec(nd, c, eset|recursive) |
||||
} |
||||
return t.watch(nd, c, eset) |
||||
} |
||||
|
||||
func (t *nonrecursiveTree) watch(nd node, c chan<- EventInfo, e Event) (err error) { |
||||
diff := nd.Watch.Add(c, e) |
||||
switch { |
||||
case diff == none: |
||||
return nil |
||||
case diff[1] == 0: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("eset is empty: " + nd.Name) |
||||
case diff[0] == 0: |
||||
err = t.w.Watch(nd.Name, diff[1]) |
||||
default: |
||||
err = t.w.Rewatch(nd.Name, diff[0], diff[1]) |
||||
} |
||||
if err != nil { |
||||
nd.Watch.Del(c, diff.Event()) |
||||
return err |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (t *nonrecursiveTree) recFunc(e Event) walkFunc { |
||||
return func(nd node) error { |
||||
switch diff := nd.Watch.Add(t.rec, e|omit|Create); { |
||||
case diff == none: |
||||
case diff[1] == 0: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("eset is empty: " + nd.Name) |
||||
case diff[0] == 0: |
||||
t.w.Watch(nd.Name, diff[1]) |
||||
default: |
||||
t.w.Rewatch(nd.Name, diff[0], diff[1]) |
||||
} |
||||
return nil |
||||
} |
||||
} |
||||
|
||||
func (t *nonrecursiveTree) watchrec(nd node, c chan<- EventInfo, e Event) error { |
||||
var traverse func(walkFunc) error |
||||
// Non-recursive tree listens on Create event for every recursive
|
||||
// watchpoint in order to automagically set a watch for every
|
||||
// created directory.
|
||||
switch diff := nd.Watch.dryAdd(t.rec, e|Create); { |
||||
case diff == none: |
||||
t.watchAdd(nd, c, e) |
||||
nd.Watch.Add(t.rec, e|omit|Create) |
||||
return nil |
||||
case diff[1] == 0: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("eset is empty: " + nd.Name) |
||||
case diff[0] == 0: |
||||
// TODO(rjeczalik): BFS into directories and skip subtree as soon as first
|
||||
// recursive watchpoint is encountered.
|
||||
traverse = nd.AddDir |
||||
default: |
||||
traverse = nd.Walk |
||||
} |
||||
// TODO(rjeczalik): account every path that failed to be (re)watched
|
||||
// and retry.
|
||||
if err := traverse(t.recFunc(e)); err != nil { |
||||
return err |
||||
} |
||||
t.watchAdd(nd, c, e) |
||||
return nil |
||||
} |
||||
|
||||
type walkWatchpointFunc func(Event, node) error |
||||
|
||||
func (t *nonrecursiveTree) walkWatchpoint(nd node, fn walkWatchpointFunc) error { |
||||
type minode struct { |
||||
min Event |
||||
nd node |
||||
} |
||||
mnd := minode{nd: nd} |
||||
stack := []minode{mnd} |
||||
Traverse: |
||||
for n := len(stack); n != 0; n = len(stack) { |
||||
mnd, stack = stack[n-1], stack[:n-1] |
||||
// There must be no recursive watchpoints if the node has no watchpoints
|
||||
// itself (every node in subtree rooted at recursive watchpoints must
|
||||
// have at least nil (total) and t.rec watchpoints).
|
||||
if len(mnd.nd.Watch) != 0 { |
||||
switch err := fn(mnd.min, mnd.nd); err { |
||||
case nil: |
||||
case errSkip: |
||||
continue Traverse |
||||
default: |
||||
return err |
||||
} |
||||
} |
||||
for _, nd := range mnd.nd.Child { |
||||
stack = append(stack, minode{mnd.nd.Watch[t.rec], nd}) |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// Stop TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) Stop(c chan<- EventInfo) { |
||||
fn := func(min Event, nd node) error { |
||||
// TODO(rjeczalik): aggregate watcher errors and retry; in worst case
|
||||
// forward to the user.
|
||||
switch diff := t.watchDelMin(min, nd, c, all); { |
||||
case diff == none: |
||||
return nil |
||||
case diff[1] == 0: |
||||
t.w.Unwatch(nd.Name) |
||||
default: |
||||
t.w.Rewatch(nd.Name, diff[0], diff[1]) |
||||
} |
||||
return nil |
||||
} |
||||
t.rw.Lock() |
||||
err := t.walkWatchpoint(t.root.nd, fn) // TODO(rjeczalik): store max root per c
|
||||
t.rw.Unlock() |
||||
dbgprintf("Stop(%p) error: %v\n", c, err) |
||||
} |
||||
|
||||
// Close TODO(rjeczalik)
|
||||
func (t *nonrecursiveTree) Close() error { |
||||
err := t.w.Close() |
||||
close(t.c) |
||||
return err |
||||
} |
@ -0,0 +1,354 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import "sync" |
||||
|
||||
// watchAdd TODO(rjeczalik)
|
||||
func watchAdd(nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
diff := nd.Watch.Add(c, e) |
||||
if wp := nd.Child[""].Watch; len(wp) != 0 { |
||||
e = wp.Total() |
||||
diff[0] |= e |
||||
diff[1] |= e |
||||
if diff[0] == diff[1] { |
||||
return none |
||||
} |
||||
} |
||||
return diff |
||||
} |
||||
|
||||
// watchAddInactive TODO(rjeczalik)
|
||||
func watchAddInactive(nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
wp := nd.Child[""].Watch |
||||
if wp == nil { |
||||
wp = make(watchpoint) |
||||
nd.Child[""] = node{Watch: wp} |
||||
} |
||||
diff := wp.Add(c, e) |
||||
e = nd.Watch.Total() |
||||
diff[0] |= e |
||||
diff[1] |= e |
||||
if diff[0] == diff[1] { |
||||
return none |
||||
} |
||||
return diff |
||||
} |
||||
|
||||
// watchCopy TODO(rjeczalik)
|
||||
func watchCopy(src, dst node) { |
||||
for c, e := range src.Watch { |
||||
if c == nil { |
||||
continue |
||||
} |
||||
watchAddInactive(dst, c, e) |
||||
} |
||||
if wpsrc := src.Child[""].Watch; len(wpsrc) != 0 { |
||||
wpdst := dst.Child[""].Watch |
||||
for c, e := range wpsrc { |
||||
if c == nil { |
||||
continue |
||||
} |
||||
wpdst.Add(c, e) |
||||
} |
||||
} |
||||
} |
||||
|
||||
// watchDel TODO(rjeczalik)
|
||||
func watchDel(nd node, c chan<- EventInfo, e Event) eventDiff { |
||||
diff := nd.Watch.Del(c, e) |
||||
if wp := nd.Child[""].Watch; len(wp) != 0 { |
||||
diffInactive := wp.Del(c, e) |
||||
e = wp.Total() |
||||
// TODO(rjeczalik): add e if e != all?
|
||||
diff[0] |= diffInactive[0] | e |
||||
diff[1] |= diffInactive[1] | e |
||||
if diff[0] == diff[1] { |
||||
return none |
||||
} |
||||
} |
||||
return diff |
||||
} |
||||
|
||||
// watchTotal TODO(rjeczalik)
|
||||
func watchTotal(nd node) Event { |
||||
e := nd.Watch.Total() |
||||
if wp := nd.Child[""].Watch; len(wp) != 0 { |
||||
e |= wp.Total() |
||||
} |
||||
return e |
||||
} |
||||
|
||||
// watchIsRecursive TODO(rjeczalik)
|
||||
func watchIsRecursive(nd node) bool { |
||||
ok := nd.Watch.IsRecursive() |
||||
// TODO(rjeczalik): add a test for len(wp) != 0 change the condition.
|
||||
if wp := nd.Child[""].Watch; len(wp) != 0 { |
||||
// If a watchpoint holds inactive watchpoints, it means it's a parent
|
||||
// one, which is recursive by nature even though it may be not recursive
|
||||
// itself.
|
||||
ok = true |
||||
} |
||||
return ok |
||||
} |
||||
|
||||
// recursiveTree TODO(rjeczalik)
|
||||
type recursiveTree struct { |
||||
rw sync.RWMutex // protects root
|
||||
root root |
||||
// TODO(rjeczalik): merge watcher + recursiveWatcher after #5 and #6
|
||||
w interface { |
||||
watcher |
||||
recursiveWatcher |
||||
} |
||||
c chan EventInfo |
||||
} |
||||
|
||||
// newRecursiveTree TODO(rjeczalik)
|
||||
func newRecursiveTree(w recursiveWatcher, c chan EventInfo) *recursiveTree { |
||||
t := &recursiveTree{ |
||||
root: root{nd: newnode("")}, |
||||
w: struct { |
||||
watcher |
||||
recursiveWatcher |
||||
}{w.(watcher), w}, |
||||
c: c, |
||||
} |
||||
go t.dispatch() |
||||
return t |
||||
} |
||||
|
||||
// dispatch TODO(rjeczalik)
|
||||
func (t *recursiveTree) dispatch() { |
||||
for ei := range t.c { |
||||
dbgprintf("dispatching %v on %q", ei.Event(), ei.Path()) |
||||
go func(ei EventInfo) { |
||||
nd, ok := node{}, false |
||||
dir, base := split(ei.Path()) |
||||
fn := func(it node, isbase bool) error { |
||||
if isbase { |
||||
nd = it |
||||
} else { |
||||
it.Watch.Dispatch(ei, recursive) |
||||
} |
||||
return nil |
||||
} |
||||
t.rw.RLock() |
||||
defer t.rw.RUnlock() |
||||
// Notify recursive watchpoints found on the path.
|
||||
if err := t.root.WalkPath(dir, fn); err != nil { |
||||
dbgprint("dispatch did not reach leaf:", err) |
||||
return |
||||
} |
||||
// Notify parent watchpoint.
|
||||
nd.Watch.Dispatch(ei, 0) |
||||
// If leaf watchpoint exists, notify it.
|
||||
if nd, ok = nd.Child[base]; ok { |
||||
nd.Watch.Dispatch(ei, 0) |
||||
} |
||||
}(ei) |
||||
} |
||||
} |
||||
|
||||
// Watch TODO(rjeczalik)
|
||||
func (t *recursiveTree) Watch(path string, c chan<- EventInfo, events ...Event) error { |
||||
if c == nil { |
||||
panic("notify: Watch using nil channel") |
||||
} |
||||
// Expanding with empty event set is a nop.
|
||||
if len(events) == 0 { |
||||
return nil |
||||
} |
||||
path, isrec, err := cleanpath(path) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
eventset := joinevents(events) |
||||
if isrec { |
||||
eventset |= recursive |
||||
} |
||||
t.rw.Lock() |
||||
defer t.rw.Unlock() |
||||
// case 1: cur is a child
|
||||
//
|
||||
// Look for parent watch which already covers the given path.
|
||||
parent := node{} |
||||
self := false |
||||
err = t.root.WalkPath(path, func(nd node, isbase bool) error { |
||||
if watchTotal(nd) != 0 { |
||||
parent = nd |
||||
self = isbase |
||||
return errSkip |
||||
} |
||||
return nil |
||||
}) |
||||
cur := t.root.Add(path) // add after the walk, so it's less to traverse
|
||||
if err == nil && parent.Watch != nil { |
||||
// Parent watch found. Register inactive watchpoint, so we have enough
|
||||
// information to shrink the eventset on eventual Stop.
|
||||
// return t.resetwatchpoint(parent, parent, c, eventset|inactive)
|
||||
var diff eventDiff |
||||
if self { |
||||
diff = watchAdd(cur, c, eventset) |
||||
} else { |
||||
diff = watchAddInactive(parent, c, eventset) |
||||
} |
||||
switch { |
||||
case diff == none: |
||||
// the parent watchpoint already covers requested subtree with its
|
||||
// eventset
|
||||
case diff[0] == 0: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("dangling watchpoint: " + parent.Name) |
||||
default: |
||||
if isrec || watchIsRecursive(parent) { |
||||
err = t.w.RecursiveRewatch(parent.Name, parent.Name, diff[0], diff[1]) |
||||
} else { |
||||
err = t.w.Rewatch(parent.Name, diff[0], diff[1]) |
||||
} |
||||
if err != nil { |
||||
watchDel(parent, c, diff.Event()) |
||||
return err |
||||
} |
||||
watchAdd(cur, c, eventset) |
||||
// TODO(rjeczalik): account top-most path for c
|
||||
return nil |
||||
} |
||||
if !self { |
||||
watchAdd(cur, c, eventset) |
||||
} |
||||
return nil |
||||
} |
||||
// case 2: cur is new parent
|
||||
//
|
||||
// Look for children nodes, unwatch n-1 of them and rewatch the last one.
|
||||
var children []node |
||||
fn := func(nd node) error { |
||||
if len(nd.Watch) == 0 { |
||||
return nil |
||||
} |
||||
children = append(children, nd) |
||||
return errSkip |
||||
} |
||||
switch must(cur.Walk(fn)); len(children) { |
||||
case 0: |
||||
// no child watches, cur holds a new watch
|
||||
case 1: |
||||
watchAdd(cur, c, eventset) // TODO(rjeczalik): update cache c subtree root?
|
||||
watchCopy(children[0], cur) |
||||
err = t.w.RecursiveRewatch(children[0].Name, cur.Name, watchTotal(children[0]), |
||||
watchTotal(cur)) |
||||
if err != nil { |
||||
// Clean inactive watchpoint. The c chan did not exist before.
|
||||
cur.Child[""] = node{} |
||||
delete(cur.Watch, c) |
||||
return err |
||||
} |
||||
return nil |
||||
default: |
||||
watchAdd(cur, c, eventset) |
||||
// Copy children inactive watchpoints to the new parent.
|
||||
for _, nd := range children { |
||||
watchCopy(nd, cur) |
||||
} |
||||
// Watch parent subtree.
|
||||
if err = t.w.RecursiveWatch(cur.Name, watchTotal(cur)); err != nil { |
||||
// Clean inactive watchpoint. The c chan did not exist before.
|
||||
cur.Child[""] = node{} |
||||
delete(cur.Watch, c) |
||||
return err |
||||
} |
||||
// Unwatch children subtrees.
|
||||
var e error |
||||
for _, nd := range children { |
||||
if watchIsRecursive(nd) { |
||||
e = t.w.RecursiveUnwatch(nd.Name) |
||||
} else { |
||||
e = t.w.Unwatch(nd.Name) |
||||
} |
||||
if e != nil { |
||||
err = nonil(err, e) |
||||
// TODO(rjeczalik): child is still watched, warn all its watchpoints
|
||||
// about possible duplicate events via Error event
|
||||
} |
||||
} |
||||
return err |
||||
} |
||||
// case 3: cur is new, alone node
|
||||
switch diff := watchAdd(cur, c, eventset); { |
||||
case diff == none: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("watch requested but no parent watchpoint found: " + cur.Name) |
||||
case diff[0] == 0: |
||||
if isrec { |
||||
err = t.w.RecursiveWatch(cur.Name, diff[1]) |
||||
} else { |
||||
err = t.w.Watch(cur.Name, diff[1]) |
||||
} |
||||
if err != nil { |
||||
watchDel(cur, c, diff.Event()) |
||||
return err |
||||
} |
||||
default: |
||||
// TODO(rjeczalik): cleanup this panic after implementation is stable
|
||||
panic("watch requested but no parent watchpoint found: " + cur.Name) |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// Stop TODO(rjeczalik)
|
||||
//
|
||||
// TODO(rjeczalik): Split parent watchpoint - transfer watches to children
|
||||
// if parent is no longer needed. This carries a risk that underlying
|
||||
// watcher calls could fail - reconsider if it's worth the effort.
|
||||
func (t *recursiveTree) Stop(c chan<- EventInfo) { |
||||
var err error |
||||
fn := func(nd node) (e error) { |
||||
diff := watchDel(nd, c, all) |
||||
switch { |
||||
case diff == none && watchTotal(nd) == 0: |
||||
// TODO(rjeczalik): There's no watchpoints deeper in the tree,
|
||||
// probably we should remove the nodes as well.
|
||||
return nil |
||||
case diff == none: |
||||
// Removing c from nd does not require shrinking its eventset.
|
||||
case diff[1] == 0: |
||||
if watchIsRecursive(nd) { |
||||
e = t.w.RecursiveUnwatch(nd.Name) |
||||
} else { |
||||
e = t.w.Unwatch(nd.Name) |
||||
} |
||||
default: |
||||
if watchIsRecursive(nd) { |
||||
e = t.w.RecursiveRewatch(nd.Name, nd.Name, diff[0], diff[1]) |
||||
} else { |
||||
e = t.w.Rewatch(nd.Name, diff[0], diff[1]) |
||||
} |
||||
} |
||||
fn := func(nd node) error { |
||||
watchDel(nd, c, all) |
||||
return nil |
||||
} |
||||
err = nonil(err, e, nd.Walk(fn)) |
||||
// TODO(rjeczalik): if e != nil store dummy chan in nd.Watch just to
|
||||
// retry un/rewatching next time and/or let the user handle the failure
|
||||
// vie Error event?
|
||||
return errSkip |
||||
} |
||||
t.rw.Lock() |
||||
e := t.root.Walk("", fn) // TODO(rjeczalik): use max root per c
|
||||
t.rw.Unlock() |
||||
if e != nil { |
||||
err = nonil(err, e) |
||||
} |
||||
dbgprintf("Stop(%p) error: %v\n", c, err) |
||||
} |
||||
|
||||
// Close TODO(rjeczalik)
|
||||
func (t *recursiveTree) Close() error { |
||||
err := t.w.Close() |
||||
close(t.c) |
||||
return err |
||||
} |
@ -0,0 +1,150 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"errors" |
||||
"os" |
||||
"path/filepath" |
||||
"strings" |
||||
) |
||||
|
||||
const all = ^Event(0) |
||||
const sep = string(os.PathSeparator) |
||||
|
||||
var errDepth = errors.New("exceeded allowed iteration count (circular symlink?)") |
||||
|
||||
func min(i, j int) int { |
||||
if i > j { |
||||
return j |
||||
} |
||||
return i |
||||
} |
||||
|
||||
func max(i, j int) int { |
||||
if i < j { |
||||
return j |
||||
} |
||||
return i |
||||
} |
||||
|
||||
// must panics if err is non-nil.
|
||||
func must(err error) { |
||||
if err != nil { |
||||
panic(err) |
||||
} |
||||
} |
||||
|
||||
// nonil gives first non-nil error from the given arguments.
|
||||
func nonil(err ...error) error { |
||||
for _, err := range err { |
||||
if err != nil { |
||||
return err |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func cleanpath(path string) (realpath string, isrec bool, err error) { |
||||
if strings.HasSuffix(path, "...") { |
||||
isrec = true |
||||
path = path[:len(path)-3] |
||||
} |
||||
if path, err = filepath.Abs(path); err != nil { |
||||
return "", false, err |
||||
} |
||||
if path, err = canonical(path); err != nil { |
||||
return "", false, err |
||||
} |
||||
return path, isrec, nil |
||||
} |
||||
|
||||
// canonical resolves any symlink in the given path and returns it in a clean form.
|
||||
// It expects the path to be absolute. It fails to resolve circular symlinks by
|
||||
// maintaining a simple iteration limit.
|
||||
func canonical(p string) (string, error) { |
||||
p, err := filepath.Abs(p) |
||||
if err != nil { |
||||
return "", err |
||||
} |
||||
for i, j, depth := 1, 0, 1; i < len(p); i, depth = i+1, depth+1 { |
||||
if depth > 128 { |
||||
return "", &os.PathError{Op: "canonical", Path: p, Err: errDepth} |
||||
} |
||||
if j = strings.IndexRune(p[i:], '/'); j == -1 { |
||||
j, i = i, len(p) |
||||
} else { |
||||
j, i = i, i+j |
||||
} |
||||
fi, err := os.Lstat(p[:i]) |
||||
if err != nil { |
||||
return "", err |
||||
} |
||||
if fi.Mode()&os.ModeSymlink == os.ModeSymlink { |
||||
s, err := os.Readlink(p[:i]) |
||||
if err != nil { |
||||
return "", err |
||||
} |
||||
if filepath.IsAbs(s) { |
||||
p = "/" + s + p[i:] |
||||
} else { |
||||
p = p[:j] + s + p[i:] |
||||
} |
||||
i = 1 // no guarantee s is canonical, start all over
|
||||
} |
||||
} |
||||
return filepath.Clean(p), nil |
||||
} |
||||
|
||||
func joinevents(events []Event) (e Event) { |
||||
if len(events) == 0 { |
||||
e = All |
||||
} else { |
||||
for _, event := range events { |
||||
e |= event |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
func split(s string) (string, string) { |
||||
if i := lastIndexSep(s); i != -1 { |
||||
return s[:i], s[i+1:] |
||||
} |
||||
return "", s |
||||
} |
||||
|
||||
func base(s string) string { |
||||
if i := lastIndexSep(s); i != -1 { |
||||
return s[i+1:] |
||||
} |
||||
return s |
||||
} |
||||
|
||||
func indexbase(root, name string) int { |
||||
if n, m := len(root), len(name); m >= n && name[:n] == root && |
||||
(n == m || name[n] == os.PathSeparator) { |
||||
return min(n+1, m) |
||||
} |
||||
return -1 |
||||
} |
||||
|
||||
func indexSep(s string) int { |
||||
for i := 0; i < len(s); i++ { |
||||
if s[i] == os.PathSeparator { |
||||
return i |
||||
} |
||||
} |
||||
return -1 |
||||
} |
||||
|
||||
func lastIndexSep(s string) int { |
||||
for i := len(s) - 1; i >= 0; i-- { |
||||
if s[i] == os.PathSeparator { |
||||
return i |
||||
} |
||||
} |
||||
return -1 |
||||
} |
@ -0,0 +1,85 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
import "errors" |
||||
|
||||
var ( |
||||
errAlreadyWatched = errors.New("path is already watched") |
||||
errNotWatched = errors.New("path is not being watched") |
||||
errInvalidEventSet = errors.New("invalid event set provided") |
||||
) |
||||
|
||||
// Watcher is a intermediate interface for wrapping inotify, ReadDirChangesW,
|
||||
// FSEvents, kqueue and poller implementations.
|
||||
//
|
||||
// The watcher implementation is expected to do its own mapping between paths and
|
||||
// create watchers if underlying event notification does not support it. For
|
||||
// the ease of implementation it is guaranteed that paths provided via Watch and
|
||||
// Unwatch methods are absolute and clean.
|
||||
type watcher interface { |
||||
// Watch requests a watcher creation for the given path and given event set.
|
||||
Watch(path string, event Event) error |
||||
|
||||
// Unwatch requests a watcher deletion for the given path and given event set.
|
||||
Unwatch(path string) error |
||||
|
||||
// Rewatch provides a functionality for modifying existing watch-points, like
|
||||
// expanding its event set.
|
||||
//
|
||||
// Rewatch modifies existing watch-point under for the given path. It passes
|
||||
// the existing event set currently registered for the given path, and the
|
||||
// new, requested event set.
|
||||
//
|
||||
// It is guaranteed that Tree will not pass to Rewatch zero value for any
|
||||
// of its arguments. If old == new and watcher can be upgraded to
|
||||
// recursiveWatcher interface, a watch for the corresponding path is expected
|
||||
// to be changed from recursive to the non-recursive one.
|
||||
Rewatch(path string, old, new Event) error |
||||
|
||||
// Close unwatches all paths that are registered. When Close returns, it
|
||||
// is expected it will report no more events.
|
||||
Close() error |
||||
} |
||||
|
||||
// RecursiveWatcher is an interface for a Watcher for those OS, which do support
|
||||
// recursive watching over directories.
|
||||
type recursiveWatcher interface { |
||||
RecursiveWatch(path string, event Event) error |
||||
|
||||
// RecursiveUnwatch removes a recursive watch-point given by the path. For
|
||||
// native recursive implementation there is no difference in functionality
|
||||
// between Unwatch and RecursiveUnwatch, however for those platforms, that
|
||||
// requires emulation for recursive watch-points, the implementation differs.
|
||||
RecursiveUnwatch(path string) error |
||||
|
||||
// RecursiveRewatcher provides a functionality for modifying and/or relocating
|
||||
// existing recursive watch-points.
|
||||
//
|
||||
// To relocate a watch-point means to unwatch oldpath and set a watch-point on
|
||||
// newpath.
|
||||
//
|
||||
// To modify a watch-point means either to expand or shrink its event set.
|
||||
//
|
||||
// Tree can want to either relocate, modify or relocate and modify a watch-point
|
||||
// via single RecursiveRewatch call.
|
||||
//
|
||||
// If oldpath == newpath, the watch-point is expected to change its event set value
|
||||
// from oldevent to newevent.
|
||||
//
|
||||
// If oldevent == newevent, the watch-point is expected to relocate from oldpath
|
||||
// to the newpath.
|
||||
//
|
||||
// If oldpath != newpath and oldevent != newevent, the watch-point is expected
|
||||
// to relocate from oldpath to the newpath first and then change its event set
|
||||
// value from oldevent to the newevent. In other words the end result must be
|
||||
// a watch-point set on newpath with newevent value of its event set.
|
||||
//
|
||||
// It is guaranteed that Tree will not pass to RecurisveRewatcha zero value
|
||||
// for any of its arguments. If oldpath == newpath and oldevent == newevent,
|
||||
// a watch for the corresponding path is expected to be changed for
|
||||
// non-recursive to the recursive one.
|
||||
RecursiveRewatch(oldpath, newpath string, oldevent, newevent Event) error |
||||
} |
@ -0,0 +1,170 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build solaris
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"fmt" |
||||
"os" |
||||
"syscall" |
||||
) |
||||
|
||||
// newTrigger returns implementation of trigger.
|
||||
func newTrigger(pthLkp map[string]*watched) trigger { |
||||
return &fen{ |
||||
pthLkp: pthLkp, |
||||
cf: newCfen(), |
||||
} |
||||
} |
||||
|
||||
// fen is a structure implementing trigger for FEN.
|
||||
type fen struct { |
||||
// p is a FEN port identifier
|
||||
p int |
||||
// pthLkp is a structure mapping monitored files/dir with data about them,
|
||||
// shared with parent trg structure
|
||||
pthLkp map[string]*watched |
||||
// cf wraps C operations for FEN
|
||||
cf cfen |
||||
} |
||||
|
||||
// watched is a data structure representing watched file/directory.
|
||||
type watched struct { |
||||
// p is a path to watched file/directory
|
||||
p string |
||||
// fi provides information about watched file/dir
|
||||
fi os.FileInfo |
||||
// eDir represents events watched directly
|
||||
eDir Event |
||||
// eNonDir represents events watched indirectly
|
||||
eNonDir Event |
||||
} |
||||
|
||||
// Stop implements trigger.
|
||||
func (f *fen) Stop() error { |
||||
return f.cf.port_alert(f.p) |
||||
} |
||||
|
||||
// Close implements trigger.
|
||||
func (f *fen) Close() (err error) { |
||||
return syscall.Close(f.p) |
||||
} |
||||
|
||||
// NewWatched implements trigger.
|
||||
func (*fen) NewWatched(p string, fi os.FileInfo) (*watched, error) { |
||||
return &watched{p: p, fi: fi}, nil |
||||
} |
||||
|
||||
// Record implements trigger.
|
||||
func (f *fen) Record(w *watched) { |
||||
f.pthLkp[w.p] = w |
||||
} |
||||
|
||||
// Del implements trigger.
|
||||
func (f *fen) Del(w *watched) { |
||||
delete(f.pthLkp, w.p) |
||||
} |
||||
|
||||
func inter2pe(n interface{}) PortEvent { |
||||
pe, ok := n.(PortEvent) |
||||
if !ok { |
||||
panic(fmt.Sprintf("fen: type should be PortEvent, %T instead", n)) |
||||
} |
||||
return pe |
||||
} |
||||
|
||||
// Watched implements trigger.
|
||||
func (f *fen) Watched(n interface{}) (*watched, int64, error) { |
||||
pe := inter2pe(n) |
||||
fo, ok := pe.PortevObject.(*FileObj) |
||||
if !ok || fo == nil { |
||||
panic(fmt.Sprintf("fen: type should be *FileObj, %T instead", fo)) |
||||
} |
||||
w, ok := f.pthLkp[fo.Name] |
||||
if !ok { |
||||
return nil, 0, errNotWatched |
||||
} |
||||
return w, int64(pe.PortevEvents), nil |
||||
} |
||||
|
||||
// init initializes FEN.
|
||||
func (f *fen) Init() (err error) { |
||||
f.p, err = f.cf.port_create() |
||||
return |
||||
} |
||||
|
||||
func fi2fo(fi os.FileInfo, p string) FileObj { |
||||
st, ok := fi.Sys().(*syscall.Stat_t) |
||||
if !ok { |
||||
panic(fmt.Sprintf("fen: type should be *syscall.Stat_t, %T instead", st)) |
||||
} |
||||
return FileObj{Name: p, Atim: st.Atim, Mtim: st.Mtim, Ctim: st.Ctim} |
||||
} |
||||
|
||||
// Unwatch implements trigger.
|
||||
func (f *fen) Unwatch(w *watched) error { |
||||
return f.cf.port_dissociate(f.p, FileObj{Name: w.p}) |
||||
} |
||||
|
||||
// Watch implements trigger.
|
||||
func (f *fen) Watch(fi os.FileInfo, w *watched, e int64) error { |
||||
return f.cf.port_associate(f.p, fi2fo(fi, w.p), int(e)) |
||||
} |
||||
|
||||
// Wait implements trigger.
|
||||
func (f *fen) Wait() (interface{}, error) { |
||||
var ( |
||||
pe PortEvent |
||||
err error |
||||
) |
||||
err = f.cf.port_get(f.p, &pe) |
||||
return pe, err |
||||
} |
||||
|
||||
// IsStop implements trigger.
|
||||
func (f *fen) IsStop(n interface{}, err error) bool { |
||||
return err == syscall.EBADF || inter2pe(n).PortevSource == srcAlert |
||||
} |
||||
|
||||
func init() { |
||||
encode = func(e Event) (o int64) { |
||||
// Create event is not supported by FEN. Instead FileModified event will
|
||||
// be registered. If this event will be reported on dir which is to be
|
||||
// monitored for Create, dir will be rescanned and Create events will
|
||||
// be generated and returned for new files. In case of files,
|
||||
// if not requested FileModified event is reported, it will be ignored.
|
||||
if e&Create != 0 { |
||||
o = (o &^ int64(Create)) | int64(FileModified) |
||||
} |
||||
if e&Write != 0 { |
||||
o = (o &^ int64(Write)) | int64(FileModified) |
||||
} |
||||
// Following events are 'exception events' and as such cannot be requested
|
||||
// explicitly for monitoring or filtered out. If the will be reported
|
||||
// by FEN and not subscribed with by user, they will be filtered out by
|
||||
// watcher's logic.
|
||||
o &= int64(^Rename & ^Remove &^ FileDelete &^ FileRenameTo &^ |
||||
FileRenameFrom &^ Unmounted &^ MountedOver) |
||||
return |
||||
} |
||||
nat2not = map[Event]Event{ |
||||
FileModified: Write, |
||||
FileRenameFrom: Rename, |
||||
FileDelete: Remove, |
||||
FileAccess: Event(0), |
||||
FileAttrib: Event(0), |
||||
FileRenameTo: Event(0), |
||||
FileTrunc: Event(0), |
||||
FileNoFollow: Event(0), |
||||
Unmounted: Event(0), |
||||
MountedOver: Event(0), |
||||
} |
||||
not2nat = map[Event]Event{ |
||||
Write: FileModified, |
||||
Rename: FileRenameFrom, |
||||
Remove: FileDelete, |
||||
} |
||||
} |
@ -0,0 +1,141 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build solaris
|
||||
|
||||
package notify |
||||
|
||||
// #include <port.h>
|
||||
// #include <stdio.h>
|
||||
// #include <stdlib.h>
|
||||
// struct file_obj* newFo() { return (struct file_obj*) malloc(sizeof(struct file_obj)); }
|
||||
// port_event_t* newPe() { return (port_event_t*) malloc(sizeof(port_event_t)); }
|
||||
// uintptr_t conv(struct file_obj* fo) { return (uintptr_t) fo; }
|
||||
// struct file_obj* dconv(uintptr_t fo) { return (struct file_obj*) fo; }
|
||||
import "C" |
||||
|
||||
import ( |
||||
"syscall" |
||||
"unsafe" |
||||
) |
||||
|
||||
const ( |
||||
fileAccess = Event(C.FILE_ACCESS) |
||||
fileModified = Event(C.FILE_MODIFIED) |
||||
fileAttrib = Event(C.FILE_ATTRIB) |
||||
fileDelete = Event(C.FILE_DELETE) |
||||
fileRenameTo = Event(C.FILE_RENAME_TO) |
||||
fileRenameFrom = Event(C.FILE_RENAME_FROM) |
||||
fileTrunc = Event(C.FILE_TRUNC) |
||||
fileNoFollow = Event(C.FILE_NOFOLLOW) |
||||
unmounted = Event(C.UNMOUNTED) |
||||
mountedOver = Event(C.MOUNTEDOVER) |
||||
) |
||||
|
||||
// PortEvent is a notify's equivalent of port_event_t.
|
||||
type PortEvent struct { |
||||
PortevEvents int // PortevEvents is an equivalent of portev_events.
|
||||
PortevSource uint8 // PortevSource is an equivalent of portev_source.
|
||||
PortevPad uint8 // Portevpad is an equivalent of portev_pad.
|
||||
PortevObject interface{} // PortevObject is an equivalent of portev_object.
|
||||
PortevUser uintptr // PortevUser is an equivalent of portev_user.
|
||||
} |
||||
|
||||
// FileObj is a notify's equivalent of file_obj.
|
||||
type FileObj struct { |
||||
Atim syscall.Timespec // Atim is an equivalent of fo_atime.
|
||||
Mtim syscall.Timespec // Mtim is an equivalent of fo_mtime.
|
||||
Ctim syscall.Timespec // Ctim is an equivalent of fo_ctime.
|
||||
Pad [3]uintptr // Pad is an equivalent of fo_pad.
|
||||
Name string // Name is an equivalent of fo_name.
|
||||
} |
||||
|
||||
type cfen struct { |
||||
p2pe map[string]*C.port_event_t |
||||
p2fo map[string]*C.struct_file_obj |
||||
} |
||||
|
||||
func newCfen() cfen { |
||||
return cfen{ |
||||
p2pe: make(map[string]*C.port_event_t), |
||||
p2fo: make(map[string]*C.struct_file_obj), |
||||
} |
||||
} |
||||
|
||||
func unix2C(sec int64, nsec int64) (C.time_t, C.long) { |
||||
return C.time_t(sec), C.long(nsec) |
||||
} |
||||
|
||||
func (c *cfen) port_associate(p int, fo FileObj, e int) (err error) { |
||||
cfo := C.newFo() |
||||
cfo.fo_atime.tv_sec, cfo.fo_atime.tv_nsec = unix2C(fo.Atim.Unix()) |
||||
cfo.fo_mtime.tv_sec, cfo.fo_mtime.tv_nsec = unix2C(fo.Mtim.Unix()) |
||||
cfo.fo_ctime.tv_sec, cfo.fo_ctime.tv_nsec = unix2C(fo.Ctim.Unix()) |
||||
cfo.fo_name = C.CString(fo.Name) |
||||
c.p2fo[fo.Name] = cfo |
||||
_, err = C.port_associate(C.int(p), srcFile, C.conv(cfo), C.int(e), nil) |
||||
return |
||||
} |
||||
|
||||
func (c *cfen) port_dissociate(port int, fo FileObj) (err error) { |
||||
cfo, ok := c.p2fo[fo.Name] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
_, err = C.port_dissociate(C.int(port), srcFile, C.conv(cfo)) |
||||
C.free(unsafe.Pointer(cfo.fo_name)) |
||||
C.free(unsafe.Pointer(cfo)) |
||||
delete(c.p2fo, fo.Name) |
||||
return |
||||
} |
||||
|
||||
const srcAlert = C.PORT_SOURCE_ALERT |
||||
const srcFile = C.PORT_SOURCE_FILE |
||||
const alertSet = C.PORT_ALERT_SET |
||||
|
||||
func cfo2fo(cfo *C.struct_file_obj) *FileObj { |
||||
// Currently remaining attributes are not used.
|
||||
if cfo == nil { |
||||
return nil |
||||
} |
||||
var fo FileObj |
||||
fo.Name = C.GoString(cfo.fo_name) |
||||
return &fo |
||||
} |
||||
|
||||
func (c *cfen) port_get(port int, pe *PortEvent) (err error) { |
||||
cpe := C.newPe() |
||||
if _, err = C.port_get(C.int(port), cpe, nil); err != nil { |
||||
C.free(unsafe.Pointer(cpe)) |
||||
return |
||||
} |
||||
pe.PortevEvents, pe.PortevSource, pe.PortevPad = |
||||
int(cpe.portev_events), uint8(cpe.portev_source), uint8(cpe.portev_pad) |
||||
pe.PortevObject = cfo2fo(C.dconv(cpe.portev_object)) |
||||
pe.PortevUser = uintptr(cpe.portev_user) |
||||
C.free(unsafe.Pointer(cpe)) |
||||
return |
||||
} |
||||
|
||||
func (c *cfen) port_create() (int, error) { |
||||
p, err := C.port_create() |
||||
return int(p), err |
||||
} |
||||
|
||||
func (c *cfen) port_alert(p int) (err error) { |
||||
_, err = C.port_alert(C.int(p), alertSet, C.int(666), nil) |
||||
return |
||||
} |
||||
|
||||
func (c *cfen) free() { |
||||
for i := range c.p2fo { |
||||
C.free(unsafe.Pointer(c.p2fo[i].fo_name)) |
||||
C.free(unsafe.Pointer(c.p2fo[i])) |
||||
} |
||||
for i := range c.p2pe { |
||||
C.free(unsafe.Pointer(c.p2pe[i])) |
||||
} |
||||
c.p2fo = make(map[string]*C.struct_file_obj) |
||||
c.p2pe = make(map[string]*C.port_event_t) |
||||
} |
@ -0,0 +1,319 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,!kqueue
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"errors" |
||||
"strings" |
||||
"sync/atomic" |
||||
) |
||||
|
||||
// TODO(rjeczalik): get rid of calls to canonical, it's tree responsibility
|
||||
|
||||
const ( |
||||
failure = uint32(FSEventsMustScanSubDirs | FSEventsUserDropped | FSEventsKernelDropped) |
||||
filter = uint32(FSEventsCreated | FSEventsRemoved | FSEventsRenamed | |
||||
FSEventsModified | FSEventsInodeMetaMod) |
||||
) |
||||
|
||||
// FSEvent represents single file event. It is created out of values passed by
|
||||
// FSEvents to FSEventStreamCallback function.
|
||||
type FSEvent struct { |
||||
Path string // real path of the file or directory
|
||||
ID uint64 // ID of the event (FSEventStreamEventId)
|
||||
Flags uint32 // joint FSEvents* flags (FSEventStreamEventFlags)
|
||||
} |
||||
|
||||
// splitflags separates event flags from single set into slice of flags.
|
||||
func splitflags(set uint32) (e []uint32) { |
||||
for i := uint32(1); set != 0; i, set = i<<1, set>>1 { |
||||
if (set & 1) != 0 { |
||||
e = append(e, i) |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
// watch represents a filesystem watchpoint. It is a higher level abstraction
|
||||
// over FSEvents' stream, which implements filtering of file events based
|
||||
// on path and event set. It emulates non-recursive watch-point by filtering out
|
||||
// events which paths are more than 1 level deeper than the watched path.
|
||||
type watch struct { |
||||
// prev stores last event set per path in order to filter out old flags
|
||||
// for new events, which appratenly FSEvents likes to retain. It's a disgusting
|
||||
// hack, it should be researched how to get rid of it.
|
||||
prev map[string]uint32 |
||||
c chan<- EventInfo |
||||
stream *stream |
||||
path string |
||||
events uint32 |
||||
isrec int32 |
||||
flushed bool |
||||
} |
||||
|
||||
// Example format:
|
||||
//
|
||||
// ~ $ (trigger command) # (event set) -> (effective event set)
|
||||
//
|
||||
// Heuristics:
|
||||
//
|
||||
// 1. Create event is removed when it was present in previous event set.
|
||||
// Example:
|
||||
//
|
||||
// ~ $ echo > file # Create|Write -> Create|Write
|
||||
// ~ $ echo > file # Create|Write|InodeMetaMod -> Write|InodeMetaMod
|
||||
//
|
||||
// 2. Remove event is removed if it was present in previouse event set.
|
||||
// Example:
|
||||
//
|
||||
// ~ $ touch file # Create -> Create
|
||||
// ~ $ rm file # Create|Remove -> Remove
|
||||
// ~ $ touch file # Create|Remove -> Create
|
||||
//
|
||||
// 3. Write event is removed if not followed by InodeMetaMod on existing
|
||||
// file. Example:
|
||||
//
|
||||
// ~ $ echo > file # Create|Write -> Create|Write
|
||||
// ~ $ chmod +x file # Create|Write|ChangeOwner -> ChangeOwner
|
||||
//
|
||||
// 4. Write&InodeMetaMod is removed when effective event set contain Remove event.
|
||||
// Example:
|
||||
//
|
||||
// ~ $ echo > file # Write|InodeMetaMod -> Write|InodeMetaMod
|
||||
// ~ $ rm file # Remove|Write|InodeMetaMod -> Remove
|
||||
//
|
||||
func (w *watch) strip(base string, set uint32) uint32 { |
||||
const ( |
||||
write = FSEventsModified | FSEventsInodeMetaMod |
||||
both = FSEventsCreated | FSEventsRemoved |
||||
) |
||||
switch w.prev[base] { |
||||
case FSEventsCreated: |
||||
set &^= FSEventsCreated |
||||
if set&FSEventsRemoved != 0 { |
||||
w.prev[base] = FSEventsRemoved |
||||
set &^= write |
||||
} |
||||
case FSEventsRemoved: |
||||
set &^= FSEventsRemoved |
||||
if set&FSEventsCreated != 0 { |
||||
w.prev[base] = FSEventsCreated |
||||
} |
||||
default: |
||||
switch set & both { |
||||
case FSEventsCreated: |
||||
w.prev[base] = FSEventsCreated |
||||
case FSEventsRemoved: |
||||
w.prev[base] = FSEventsRemoved |
||||
set &^= write |
||||
} |
||||
} |
||||
dbgprintf("split()=%v\n", Event(set)) |
||||
return set |
||||
} |
||||
|
||||
// Dispatch is a stream function which forwards given file events for the watched
|
||||
// path to underlying FileInfo channel.
|
||||
func (w *watch) Dispatch(ev []FSEvent) { |
||||
events := atomic.LoadUint32(&w.events) |
||||
isrec := (atomic.LoadInt32(&w.isrec) == 1) |
||||
for i := range ev { |
||||
if ev[i].Flags&FSEventsHistoryDone != 0 { |
||||
w.flushed = true |
||||
continue |
||||
} |
||||
if !w.flushed { |
||||
continue |
||||
} |
||||
dbgprintf("%v (0x%x) (%s, i=%d, ID=%d, len=%d)\n", Event(ev[i].Flags), |
||||
ev[i].Flags, ev[i].Path, i, ev[i].ID, len(ev)) |
||||
if ev[i].Flags&failure != 0 { |
||||
// TODO(rjeczalik): missing error handling
|
||||
panic("unhandled error: " + Event(ev[i].Flags).String()) |
||||
} |
||||
if !strings.HasPrefix(ev[i].Path, w.path) { |
||||
continue |
||||
} |
||||
n := len(w.path) |
||||
base := "" |
||||
if len(ev[i].Path) > n { |
||||
if ev[i].Path[n] != '/' { |
||||
continue |
||||
} |
||||
base = ev[i].Path[n+1:] |
||||
if !isrec && strings.IndexByte(base, '/') != -1 { |
||||
continue |
||||
} |
||||
} |
||||
// TODO(rjeczalik): get diff only from filtered events?
|
||||
e := w.strip(string(base), ev[i].Flags) & events |
||||
if e == 0 { |
||||
continue |
||||
} |
||||
for _, e := range splitflags(e) { |
||||
dbgprintf("%d: single event: %v", ev[i].ID, Event(e)) |
||||
w.c <- &event{ |
||||
fse: ev[i], |
||||
event: Event(e), |
||||
} |
||||
} |
||||
} |
||||
} |
||||
|
||||
// Stop closes underlying FSEvents stream and stops dispatching events.
|
||||
func (w *watch) Stop() { |
||||
w.stream.Stop() |
||||
// TODO(rjeczalik): make (*stream).Stop flush synchronously undelivered events,
|
||||
// so the following hack can be removed. It should flush all the streams
|
||||
// concurrently as we care not to block too much here.
|
||||
atomic.StoreUint32(&w.events, 0) |
||||
atomic.StoreInt32(&w.isrec, 0) |
||||
} |
||||
|
||||
// fsevents implements Watcher and RecursiveWatcher interfaces backed by FSEvents
|
||||
// framework.
|
||||
type fsevents struct { |
||||
watches map[string]*watch |
||||
c chan<- EventInfo |
||||
} |
||||
|
||||
func newWatcher(c chan<- EventInfo) watcher { |
||||
return &fsevents{ |
||||
watches: make(map[string]*watch), |
||||
c: c, |
||||
} |
||||
} |
||||
|
||||
func (fse *fsevents) watch(path string, event Event, isrec int32) (err error) { |
||||
if path, err = canonical(path); err != nil { |
||||
return err |
||||
} |
||||
if _, ok := fse.watches[path]; ok { |
||||
return errAlreadyWatched |
||||
} |
||||
w := &watch{ |
||||
prev: make(map[string]uint32), |
||||
c: fse.c, |
||||
path: path, |
||||
events: uint32(event), |
||||
isrec: isrec, |
||||
} |
||||
w.stream = newStream(path, w.Dispatch) |
||||
if err = w.stream.Start(); err != nil { |
||||
return err |
||||
} |
||||
fse.watches[path] = w |
||||
return nil |
||||
} |
||||
|
||||
func (fse *fsevents) unwatch(path string) (err error) { |
||||
if path, err = canonical(path); err != nil { |
||||
return |
||||
} |
||||
w, ok := fse.watches[path] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
w.stream.Stop() |
||||
delete(fse.watches, path) |
||||
return nil |
||||
} |
||||
|
||||
// Watch implements Watcher interface. It fails with non-nil error when setting
|
||||
// the watch-point by FSEvents fails or with errAlreadyWatched error when
|
||||
// the given path is already watched.
|
||||
func (fse *fsevents) Watch(path string, event Event) error { |
||||
return fse.watch(path, event, 0) |
||||
} |
||||
|
||||
// Unwatch implements Watcher interface. It fails with errNotWatched when
|
||||
// the given path is not being watched.
|
||||
func (fse *fsevents) Unwatch(path string) error { |
||||
return fse.unwatch(path) |
||||
} |
||||
|
||||
// Rewatch implements Watcher interface. It fails with errNotWatched when
|
||||
// the given path is not being watched or with errInvalidEventSet when oldevent
|
||||
// does not match event set the watch-point currently holds.
|
||||
func (fse *fsevents) Rewatch(path string, oldevent, newevent Event) error { |
||||
w, ok := fse.watches[path] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
if !atomic.CompareAndSwapUint32(&w.events, uint32(oldevent), uint32(newevent)) { |
||||
return errInvalidEventSet |
||||
} |
||||
atomic.StoreInt32(&w.isrec, 0) |
||||
return nil |
||||
} |
||||
|
||||
// RecursiveWatch implements RecursiveWatcher interface. It fails with non-nil
|
||||
// error when setting the watch-point by FSEvents fails or with errAlreadyWatched
|
||||
// error when the given path is already watched.
|
||||
func (fse *fsevents) RecursiveWatch(path string, event Event) error { |
||||
return fse.watch(path, event, 1) |
||||
} |
||||
|
||||
// RecursiveUnwatch implements RecursiveWatcher interface. It fails with
|
||||
// errNotWatched when the given path is not being watched.
|
||||
//
|
||||
// TODO(rjeczalik): fail if w.isrec == 0?
|
||||
func (fse *fsevents) RecursiveUnwatch(path string) error { |
||||
return fse.unwatch(path) |
||||
} |
||||
|
||||
// RecrusiveRewatch implements RecursiveWatcher interface. It fails:
|
||||
//
|
||||
// * with errNotWatched when the given path is not being watched
|
||||
// * with errInvalidEventSet when oldevent does not match the current event set
|
||||
// * with errAlreadyWatched when watch-point given by the oldpath was meant to
|
||||
// be relocated to newpath, but the newpath is already watched
|
||||
// * a non-nil error when setting the watch-point with FSEvents fails
|
||||
//
|
||||
// TODO(rjeczalik): Improve handling of watch-point relocation? See two TODOs
|
||||
// that follows.
|
||||
func (fse *fsevents) RecursiveRewatch(oldpath, newpath string, oldevent, newevent Event) error { |
||||
switch [2]bool{oldpath == newpath, oldevent == newevent} { |
||||
case [2]bool{true, true}: |
||||
w, ok := fse.watches[oldpath] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
atomic.StoreInt32(&w.isrec, 1) |
||||
return nil |
||||
case [2]bool{true, false}: |
||||
w, ok := fse.watches[oldpath] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
if !atomic.CompareAndSwapUint32(&w.events, uint32(oldevent), uint32(newevent)) { |
||||
return errors.New("invalid event state diff") |
||||
} |
||||
atomic.StoreInt32(&w.isrec, 1) |
||||
return nil |
||||
default: |
||||
// TODO(rjeczalik): rewatch newpath only if exists?
|
||||
// TODO(rjeczalik): migrate w.prev to new watch?
|
||||
if _, ok := fse.watches[newpath]; ok { |
||||
return errAlreadyWatched |
||||
} |
||||
if err := fse.Unwatch(oldpath); err != nil { |
||||
return err |
||||
} |
||||
// TODO(rjeczalik): revert unwatch if watch fails?
|
||||
return fse.watch(newpath, newevent, 1) |
||||
} |
||||
} |
||||
|
||||
// Close unwatches all watch-points.
|
||||
func (fse *fsevents) Close() error { |
||||
for _, w := range fse.watches { |
||||
w.Stop() |
||||
} |
||||
fse.watches = nil |
||||
return nil |
||||
} |
@ -0,0 +1,190 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,!kqueue
|
||||
|
||||
package notify |
||||
|
||||
/* |
||||
#include <CoreServices/CoreServices.h> |
||||
|
||||
typedef void (*CFRunLoopPerformCallBack)(void*); |
||||
|
||||
void gosource(void *); |
||||
void gostream(uintptr_t, uintptr_t, size_t, uintptr_t, uintptr_t, uintptr_t); |
||||
|
||||
static FSEventStreamRef EventStreamCreate(FSEventStreamContext * context, uintptr_t info, CFArrayRef paths, FSEventStreamEventId since, CFTimeInterval latency, FSEventStreamCreateFlags flags) { |
||||
context->info = (void*) info; |
||||
return FSEventStreamCreate(NULL, (FSEventStreamCallback) gostream, context, paths, since, latency, flags); |
||||
} |
||||
|
||||
#cgo LDFLAGS: -framework CoreServices |
||||
*/ |
||||
import "C" |
||||
|
||||
import ( |
||||
"errors" |
||||
"os" |
||||
"sync" |
||||
"sync/atomic" |
||||
"time" |
||||
"unsafe" |
||||
) |
||||
|
||||
var nilstream C.FSEventStreamRef |
||||
|
||||
// Default arguments for FSEventStreamCreate function.
|
||||
var ( |
||||
latency C.CFTimeInterval |
||||
flags = C.FSEventStreamCreateFlags(C.kFSEventStreamCreateFlagFileEvents | C.kFSEventStreamCreateFlagNoDefer) |
||||
since = uint64(C.FSEventsGetCurrentEventId()) |
||||
) |
||||
|
||||
var runloop C.CFRunLoopRef // global runloop which all streams are registered with
|
||||
var wg sync.WaitGroup // used to wait until the runloop starts
|
||||
|
||||
// source is used for synchronization purposes - it signals when runloop has
|
||||
// started and is ready via the wg. It also serves purpose of a dummy source,
|
||||
// thanks to it the runloop does not return as it also has at least one source
|
||||
// registered.
|
||||
var source = C.CFRunLoopSourceCreate(nil, 0, &C.CFRunLoopSourceContext{ |
||||
perform: (C.CFRunLoopPerformCallBack)(C.gosource), |
||||
}) |
||||
|
||||
// Errors returned when FSEvents functions fail.
|
||||
var ( |
||||
errCreate = os.NewSyscallError("FSEventStreamCreate", errors.New("NULL")) |
||||
errStart = os.NewSyscallError("FSEventStreamStart", errors.New("false")) |
||||
) |
||||
|
||||
// initializes the global runloop and ensures any created stream awaits its
|
||||
// readiness.
|
||||
func init() { |
||||
wg.Add(1) |
||||
go func() { |
||||
runloop = C.CFRunLoopGetCurrent() |
||||
C.CFRunLoopAddSource(runloop, source, C.kCFRunLoopDefaultMode) |
||||
C.CFRunLoopRun() |
||||
panic("runloop has just unexpectedly stopped") |
||||
}() |
||||
C.CFRunLoopSourceSignal(source) |
||||
} |
||||
|
||||
//export gosource
|
||||
func gosource(unsafe.Pointer) { |
||||
time.Sleep(time.Second) |
||||
wg.Done() |
||||
} |
||||
|
||||
//export gostream
|
||||
func gostream(_, info uintptr, n C.size_t, paths, flags, ids uintptr) { |
||||
const ( |
||||
offchar = unsafe.Sizeof((*C.char)(nil)) |
||||
offflag = unsafe.Sizeof(C.FSEventStreamEventFlags(0)) |
||||
offid = unsafe.Sizeof(C.FSEventStreamEventId(0)) |
||||
) |
||||
if n == 0 { |
||||
return |
||||
} |
||||
ev := make([]FSEvent, 0, int(n)) |
||||
for i := uintptr(0); i < uintptr(n); i++ { |
||||
switch flags := *(*uint32)(unsafe.Pointer((flags + i*offflag))); { |
||||
case flags&uint32(FSEventsEventIdsWrapped) != 0: |
||||
atomic.StoreUint64(&since, uint64(C.FSEventsGetCurrentEventId())) |
||||
default: |
||||
ev = append(ev, FSEvent{ |
||||
Path: C.GoString(*(**C.char)(unsafe.Pointer(paths + i*offchar))), |
||||
Flags: flags, |
||||
ID: *(*uint64)(unsafe.Pointer(ids + i*offid)), |
||||
}) |
||||
} |
||||
|
||||
} |
||||
streamFuncs.get(info)(ev) |
||||
} |
||||
|
||||
// StreamFunc is a callback called when stream receives file events.
|
||||
type streamFunc func([]FSEvent) |
||||
|
||||
var streamFuncs = streamFuncRegistry{m: map[uintptr]streamFunc{}} |
||||
|
||||
type streamFuncRegistry struct { |
||||
mu sync.Mutex |
||||
m map[uintptr]streamFunc |
||||
i uintptr |
||||
} |
||||
|
||||
func (r *streamFuncRegistry) get(id uintptr) streamFunc { |
||||
r.mu.Lock() |
||||
defer r.mu.Unlock() |
||||
return r.m[id] |
||||
} |
||||
|
||||
func (r *streamFuncRegistry) add(fn streamFunc) uintptr { |
||||
r.mu.Lock() |
||||
defer r.mu.Unlock() |
||||
r.i++ |
||||
r.m[r.i] = fn |
||||
return r.i |
||||
} |
||||
|
||||
func (r *streamFuncRegistry) delete(id uintptr) { |
||||
r.mu.Lock() |
||||
defer r.mu.Unlock() |
||||
delete(r.m, id) |
||||
} |
||||
|
||||
// Stream represents single watch-point which listens for events scheduled by
|
||||
// the global runloop.
|
||||
type stream struct { |
||||
path string |
||||
ref C.FSEventStreamRef |
||||
info uintptr |
||||
} |
||||
|
||||
// NewStream creates a stream for given path, listening for file events and
|
||||
// calling fn upon receving any.
|
||||
func newStream(path string, fn streamFunc) *stream { |
||||
return &stream{ |
||||
path: path, |
||||
info: streamFuncs.add(fn), |
||||
} |
||||
} |
||||
|
||||
// Start creates a FSEventStream for the given path and schedules it with
|
||||
// global runloop. It's a nop if the stream was already started.
|
||||
func (s *stream) Start() error { |
||||
if s.ref != nilstream { |
||||
return nil |
||||
} |
||||
wg.Wait() |
||||
p := C.CFStringCreateWithCStringNoCopy(nil, C.CString(s.path), C.kCFStringEncodingUTF8, nil) |
||||
path := C.CFArrayCreate(nil, (*unsafe.Pointer)(unsafe.Pointer(&p)), 1, nil) |
||||
ctx := C.FSEventStreamContext{} |
||||
ref := C.EventStreamCreate(&ctx, C.uintptr_t(s.info), path, C.FSEventStreamEventId(atomic.LoadUint64(&since)), latency, flags) |
||||
if ref == nilstream { |
||||
return errCreate |
||||
} |
||||
C.FSEventStreamScheduleWithRunLoop(ref, runloop, C.kCFRunLoopDefaultMode) |
||||
if C.FSEventStreamStart(ref) == C.Boolean(0) { |
||||
C.FSEventStreamInvalidate(ref) |
||||
return errStart |
||||
} |
||||
C.CFRunLoopWakeUp(runloop) |
||||
s.ref = ref |
||||
return nil |
||||
} |
||||
|
||||
// Stop stops underlying FSEventStream and unregisters it from global runloop.
|
||||
func (s *stream) Stop() { |
||||
if s.ref == nilstream { |
||||
return |
||||
} |
||||
wg.Wait() |
||||
C.FSEventStreamStop(s.ref) |
||||
C.FSEventStreamInvalidate(s.ref) |
||||
C.CFRunLoopWakeUp(runloop) |
||||
s.ref = nilstream |
||||
streamFuncs.delete(s.info) |
||||
} |
@ -0,0 +1,396 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build linux
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"bytes" |
||||
"errors" |
||||
"path/filepath" |
||||
"runtime" |
||||
"sync" |
||||
"sync/atomic" |
||||
"syscall" |
||||
"unsafe" |
||||
) |
||||
|
||||
// eventBufferSize defines the size of the buffer given to read(2) function. One
|
||||
// should not depend on this value, since it was arbitrary chosen and may be
|
||||
// changed in the future.
|
||||
const eventBufferSize = 64 * (syscall.SizeofInotifyEvent + syscall.PathMax + 1) |
||||
|
||||
// consumersCount defines the number of consumers in producer-consumer based
|
||||
// implementation. Each consumer is run in a separate goroutine and has read
|
||||
// access to watched files map.
|
||||
const consumersCount = 2 |
||||
|
||||
const invalidDescriptor = -1 |
||||
|
||||
// watched is a pair of file path and inotify mask used as a value in
|
||||
// watched files map.
|
||||
type watched struct { |
||||
path string |
||||
mask uint32 |
||||
} |
||||
|
||||
// inotify implements Watcher interface.
|
||||
type inotify struct { |
||||
sync.RWMutex // protects inotify.m map
|
||||
m map[int32]*watched // watch descriptor to watched object
|
||||
fd int32 // inotify file descriptor
|
||||
pipefd []int // pipe's read and write descriptors
|
||||
epfd int // epoll descriptor
|
||||
epes []syscall.EpollEvent // epoll events
|
||||
buffer [eventBufferSize]byte // inotify event buffer
|
||||
wg sync.WaitGroup // wait group used to close main loop
|
||||
c chan<- EventInfo // event dispatcher channel
|
||||
} |
||||
|
||||
// NewWatcher creates new non-recursive inotify backed by inotify.
|
||||
func newWatcher(c chan<- EventInfo) watcher { |
||||
i := &inotify{ |
||||
m: make(map[int32]*watched), |
||||
fd: invalidDescriptor, |
||||
pipefd: []int{invalidDescriptor, invalidDescriptor}, |
||||
epfd: invalidDescriptor, |
||||
epes: make([]syscall.EpollEvent, 0), |
||||
c: c, |
||||
} |
||||
runtime.SetFinalizer(i, func(i *inotify) { |
||||
i.epollclose() |
||||
if i.fd != invalidDescriptor { |
||||
syscall.Close(int(i.fd)) |
||||
} |
||||
}) |
||||
return i |
||||
} |
||||
|
||||
// Watch implements notify.watcher interface.
|
||||
func (i *inotify) Watch(path string, e Event) error { |
||||
return i.watch(path, e) |
||||
} |
||||
|
||||
// Rewatch implements notify.watcher interface.
|
||||
func (i *inotify) Rewatch(path string, _, newevent Event) error { |
||||
return i.watch(path, newevent) |
||||
} |
||||
|
||||
// watch adds a new watcher to the set of watched objects or modifies the existing
|
||||
// one. If called for the first time, this function initializes inotify filesystem
|
||||
// monitor and starts producer-consumers goroutines.
|
||||
func (i *inotify) watch(path string, e Event) (err error) { |
||||
if e&^(All|Event(syscall.IN_ALL_EVENTS)) != 0 { |
||||
return errors.New("notify: unknown event") |
||||
} |
||||
if err = i.lazyinit(); err != nil { |
||||
return |
||||
} |
||||
iwd, err := syscall.InotifyAddWatch(int(i.fd), path, encode(e)) |
||||
if err != nil { |
||||
return |
||||
} |
||||
i.RLock() |
||||
wd := i.m[int32(iwd)] |
||||
i.RUnlock() |
||||
if wd == nil { |
||||
i.Lock() |
||||
if i.m[int32(iwd)] == nil { |
||||
i.m[int32(iwd)] = &watched{path: path, mask: uint32(e)} |
||||
} |
||||
i.Unlock() |
||||
} else { |
||||
i.Lock() |
||||
wd.mask = uint32(e) |
||||
i.Unlock() |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// lazyinit sets up all required file descriptors and starts 1+consumersCount
|
||||
// goroutines. The producer goroutine blocks until file-system notifications
|
||||
// occur. Then, all events are read from system buffer and sent to consumer
|
||||
// goroutines which construct valid notify events. This method uses
|
||||
// Double-Checked Locking optimization.
|
||||
func (i *inotify) lazyinit() error { |
||||
if atomic.LoadInt32(&i.fd) == invalidDescriptor { |
||||
i.Lock() |
||||
defer i.Unlock() |
||||
if atomic.LoadInt32(&i.fd) == invalidDescriptor { |
||||
fd, err := syscall.InotifyInit() |
||||
if err != nil { |
||||
return err |
||||
} |
||||
i.fd = int32(fd) |
||||
if err = i.epollinit(); err != nil { |
||||
_, _ = i.epollclose(), syscall.Close(int(fd)) // Ignore errors.
|
||||
i.fd = invalidDescriptor |
||||
return err |
||||
} |
||||
esch := make(chan []*event) |
||||
go i.loop(esch) |
||||
i.wg.Add(consumersCount) |
||||
for n := 0; n < consumersCount; n++ { |
||||
go i.send(esch) |
||||
} |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// epollinit opens an epoll file descriptor and creates a pipe which will be
|
||||
// used to wake up the epoll_wait(2) function. Then, file descriptor associated
|
||||
// with inotify event queue and the read end of the pipe are added to epoll set.
|
||||
// Note that `fd` member must be set before this function is called.
|
||||
func (i *inotify) epollinit() (err error) { |
||||
if i.epfd, err = syscall.EpollCreate1(0); err != nil { |
||||
return |
||||
} |
||||
if err = syscall.Pipe(i.pipefd); err != nil { |
||||
return |
||||
} |
||||
i.epes = []syscall.EpollEvent{ |
||||
{Events: syscall.EPOLLIN, Fd: i.fd}, |
||||
{Events: syscall.EPOLLIN, Fd: int32(i.pipefd[0])}, |
||||
} |
||||
if err = syscall.EpollCtl(i.epfd, syscall.EPOLL_CTL_ADD, int(i.fd), &i.epes[0]); err != nil { |
||||
return |
||||
} |
||||
return syscall.EpollCtl(i.epfd, syscall.EPOLL_CTL_ADD, i.pipefd[0], &i.epes[1]) |
||||
} |
||||
|
||||
// epollclose closes the file descriptor created by the call to epoll_create(2)
|
||||
// and two file descriptors opened by pipe(2) function.
|
||||
func (i *inotify) epollclose() (err error) { |
||||
if i.epfd != invalidDescriptor { |
||||
if err = syscall.Close(i.epfd); err == nil { |
||||
i.epfd = invalidDescriptor |
||||
} |
||||
} |
||||
for n, fd := range i.pipefd { |
||||
if fd != invalidDescriptor { |
||||
switch e := syscall.Close(fd); { |
||||
case e != nil && err == nil: |
||||
err = e |
||||
case e == nil: |
||||
i.pipefd[n] = invalidDescriptor |
||||
} |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
// loop blocks until either inotify or pipe file descriptor is ready for I/O.
|
||||
// All read operations triggered by filesystem notifications are forwarded to
|
||||
// one of the event's consumers. If pipe fd became ready, loop function closes
|
||||
// all file descriptors opened by lazyinit method and returns afterwards.
|
||||
func (i *inotify) loop(esch chan<- []*event) { |
||||
epes := make([]syscall.EpollEvent, 1) |
||||
fd := atomic.LoadInt32(&i.fd) |
||||
for { |
||||
switch _, err := syscall.EpollWait(i.epfd, epes, -1); err { |
||||
case nil: |
||||
switch epes[0].Fd { |
||||
case fd: |
||||
esch <- i.read() |
||||
epes[0].Fd = 0 |
||||
case int32(i.pipefd[0]): |
||||
i.Lock() |
||||
defer i.Unlock() |
||||
if err = syscall.Close(int(fd)); err != nil && err != syscall.EINTR { |
||||
panic("notify: close(2) error " + err.Error()) |
||||
} |
||||
atomic.StoreInt32(&i.fd, invalidDescriptor) |
||||
if err = i.epollclose(); err != nil && err != syscall.EINTR { |
||||
panic("notify: epollclose error " + err.Error()) |
||||
} |
||||
close(esch) |
||||
return |
||||
} |
||||
case syscall.EINTR: |
||||
continue |
||||
default: // We should never reach this line.
|
||||
panic("notify: epoll_wait(2) error " + err.Error()) |
||||
} |
||||
} |
||||
} |
||||
|
||||
// read reads events from an inotify file descriptor. It does not handle errors
|
||||
// returned from read(2) function since they are not critical to watcher logic.
|
||||
func (i *inotify) read() (es []*event) { |
||||
n, err := syscall.Read(int(i.fd), i.buffer[:]) |
||||
if err != nil || n < syscall.SizeofInotifyEvent { |
||||
return |
||||
} |
||||
var sys *syscall.InotifyEvent |
||||
nmin := n - syscall.SizeofInotifyEvent |
||||
for pos, path := 0, ""; pos <= nmin; { |
||||
sys = (*syscall.InotifyEvent)(unsafe.Pointer(&i.buffer[pos])) |
||||
pos += syscall.SizeofInotifyEvent |
||||
if path = ""; sys.Len > 0 { |
||||
endpos := pos + int(sys.Len) |
||||
path = string(bytes.TrimRight(i.buffer[pos:endpos], "\x00")) |
||||
pos = endpos |
||||
} |
||||
es = append(es, &event{ |
||||
sys: syscall.InotifyEvent{ |
||||
Wd: sys.Wd, |
||||
Mask: sys.Mask, |
||||
Cookie: sys.Cookie, |
||||
}, |
||||
path: path, |
||||
}) |
||||
} |
||||
return |
||||
} |
||||
|
||||
// send is a consumer function which sends events to event dispatcher channel.
|
||||
// It is run in a separate goroutine in order to not block loop method when
|
||||
// possibly expensive write operations are performed on inotify map.
|
||||
func (i *inotify) send(esch <-chan []*event) { |
||||
for es := range esch { |
||||
for _, e := range i.transform(es) { |
||||
if e != nil { |
||||
i.c <- e |
||||
} |
||||
} |
||||
} |
||||
i.wg.Done() |
||||
} |
||||
|
||||
// transform prepares events read from inotify file descriptor for sending to
|
||||
// user. It removes invalid events and these which are no longer present in
|
||||
// inotify map. This method may also split one raw event into two different ones
|
||||
// when system-dependent result is required.
|
||||
func (i *inotify) transform(es []*event) []*event { |
||||
var multi []*event |
||||
i.RLock() |
||||
for idx, e := range es { |
||||
if e.sys.Mask&(syscall.IN_IGNORED|syscall.IN_Q_OVERFLOW) != 0 { |
||||
es[idx] = nil |
||||
continue |
||||
} |
||||
wd, ok := i.m[e.sys.Wd] |
||||
if !ok || e.sys.Mask&encode(Event(wd.mask)) == 0 { |
||||
es[idx] = nil |
||||
continue |
||||
} |
||||
if e.path == "" { |
||||
e.path = wd.path |
||||
} else { |
||||
e.path = filepath.Join(wd.path, e.path) |
||||
} |
||||
multi = append(multi, decode(Event(wd.mask), e)) |
||||
if e.event == 0 { |
||||
es[idx] = nil |
||||
} |
||||
} |
||||
i.RUnlock() |
||||
es = append(es, multi...) |
||||
return es |
||||
} |
||||
|
||||
// encode converts notify system-independent events to valid inotify mask
|
||||
// which can be passed to inotify_add_watch(2) function.
|
||||
func encode(e Event) uint32 { |
||||
if e&Create != 0 { |
||||
e = (e ^ Create) | InCreate | InMovedTo |
||||
} |
||||
if e&Remove != 0 { |
||||
e = (e ^ Remove) | InDelete | InDeleteSelf |
||||
} |
||||
if e&Write != 0 { |
||||
e = (e ^ Write) | InModify |
||||
} |
||||
if e&Rename != 0 { |
||||
e = (e ^ Rename) | InMovedFrom | InMoveSelf |
||||
} |
||||
return uint32(e) |
||||
} |
||||
|
||||
// decode uses internally stored mask to distinguish whether system-independent
|
||||
// or system-dependent event is requested. The first one is created by modifying
|
||||
// `e` argument. decode method sets e.event value to 0 when an event should be
|
||||
// skipped. System-dependent event is set as the function's return value which
|
||||
// can be nil when the event should not be passed on.
|
||||
func decode(mask Event, e *event) (syse *event) { |
||||
if sysmask := uint32(mask) & e.sys.Mask; sysmask != 0 { |
||||
syse = &event{sys: syscall.InotifyEvent{ |
||||
Wd: e.sys.Wd, |
||||
Mask: e.sys.Mask, |
||||
Cookie: e.sys.Cookie, |
||||
}, event: Event(sysmask), path: e.path} |
||||
} |
||||
imask := encode(mask) |
||||
switch { |
||||
case mask&Create != 0 && imask&uint32(InCreate|InMovedTo)&e.sys.Mask != 0: |
||||
e.event = Create |
||||
case mask&Remove != 0 && imask&uint32(InDelete|InDeleteSelf)&e.sys.Mask != 0: |
||||
e.event = Remove |
||||
case mask&Write != 0 && imask&uint32(InModify)&e.sys.Mask != 0: |
||||
e.event = Write |
||||
case mask&Rename != 0 && imask&uint32(InMovedFrom|InMoveSelf)&e.sys.Mask != 0: |
||||
e.event = Rename |
||||
default: |
||||
e.event = 0 |
||||
} |
||||
return |
||||
} |
||||
|
||||
// Unwatch implements notify.watcher interface. It looks for watch descriptor
|
||||
// related to registered path and if found, calls inotify_rm_watch(2) function.
|
||||
// This method is allowed to return EINVAL error when concurrently requested to
|
||||
// delete identical path.
|
||||
func (i *inotify) Unwatch(path string) (err error) { |
||||
iwd := int32(invalidDescriptor) |
||||
i.RLock() |
||||
for iwdkey, wd := range i.m { |
||||
if wd.path == path { |
||||
iwd = iwdkey |
||||
break |
||||
} |
||||
} |
||||
i.RUnlock() |
||||
if iwd == invalidDescriptor { |
||||
return errors.New("notify: path " + path + " is already watched") |
||||
} |
||||
fd := atomic.LoadInt32(&i.fd) |
||||
if _, err = syscall.InotifyRmWatch(int(fd), uint32(iwd)); err != nil { |
||||
return |
||||
} |
||||
i.Lock() |
||||
delete(i.m, iwd) |
||||
i.Unlock() |
||||
return nil |
||||
} |
||||
|
||||
// Close implements notify.watcher interface. It removes all existing watch
|
||||
// descriptors and wakes up producer goroutine by sending data to the write end
|
||||
// of the pipe. The function waits for a signal from producer which means that
|
||||
// all operations on current monitoring instance are done.
|
||||
func (i *inotify) Close() (err error) { |
||||
i.Lock() |
||||
if fd := atomic.LoadInt32(&i.fd); fd == invalidDescriptor { |
||||
i.Unlock() |
||||
return nil |
||||
} |
||||
for iwd := range i.m { |
||||
if _, e := syscall.InotifyRmWatch(int(i.fd), uint32(iwd)); e != nil && err == nil { |
||||
err = e |
||||
} |
||||
delete(i.m, iwd) |
||||
} |
||||
switch _, errwrite := syscall.Write(i.pipefd[1], []byte{0x00}); { |
||||
case errwrite != nil && err == nil: |
||||
err = errwrite |
||||
fallthrough |
||||
case errwrite != nil: |
||||
i.Unlock() |
||||
default: |
||||
i.Unlock() |
||||
i.wg.Wait() |
||||
} |
||||
return |
||||
} |
@ -0,0 +1,192 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,kqueue dragonfly freebsd netbsd openbsd
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"fmt" |
||||
"os" |
||||
"syscall" |
||||
) |
||||
|
||||
// newTrigger returns implementation of trigger.
|
||||
func newTrigger(pthLkp map[string]*watched) trigger { |
||||
return &kq{ |
||||
pthLkp: pthLkp, |
||||
idLkp: make(map[int]*watched), |
||||
} |
||||
} |
||||
|
||||
// kq is a structure implementing trigger for kqueue.
|
||||
type kq struct { |
||||
// fd is a kqueue file descriptor
|
||||
fd int |
||||
// pipefds are file descriptors used to stop `Kevent` call.
|
||||
pipefds [2]int |
||||
// idLkp is a data structure mapping file descriptors with data about watching
|
||||
// represented by them files/directories.
|
||||
idLkp map[int]*watched |
||||
// pthLkp is a structure mapping monitored files/dir with data about them,
|
||||
// shared with parent trg structure
|
||||
pthLkp map[string]*watched |
||||
} |
||||
|
||||
// watched is a data structure representing watched file/directory.
|
||||
type watched struct { |
||||
// p is a path to watched file/directory.
|
||||
p string |
||||
// fd is a file descriptor for watched file/directory.
|
||||
fd int |
||||
// fi provides information about watched file/dir.
|
||||
fi os.FileInfo |
||||
// eDir represents events watched directly.
|
||||
eDir Event |
||||
// eNonDir represents events watched indirectly.
|
||||
eNonDir Event |
||||
} |
||||
|
||||
// Stop implements trigger.
|
||||
func (k *kq) Stop() (err error) { |
||||
// trigger event used to interrupt Kevent call.
|
||||
_, err = syscall.Write(k.pipefds[1], []byte{0x00}) |
||||
return |
||||
} |
||||
|
||||
// Close implements trigger.
|
||||
func (k *kq) Close() error { |
||||
return syscall.Close(k.fd) |
||||
} |
||||
|
||||
// NewWatched implements trigger.
|
||||
func (*kq) NewWatched(p string, fi os.FileInfo) (*watched, error) { |
||||
fd, err := syscall.Open(p, syscall.O_NONBLOCK|syscall.O_RDONLY, 0) |
||||
if err != nil { |
||||
return nil, err |
||||
} |
||||
return &watched{fd: fd, p: p, fi: fi}, nil |
||||
} |
||||
|
||||
// Record implements trigger.
|
||||
func (k *kq) Record(w *watched) { |
||||
k.idLkp[w.fd], k.pthLkp[w.p] = w, w |
||||
} |
||||
|
||||
// Del implements trigger.
|
||||
func (k *kq) Del(w *watched) { |
||||
syscall.Close(w.fd) |
||||
delete(k.idLkp, w.fd) |
||||
delete(k.pthLkp, w.p) |
||||
} |
||||
|
||||
func inter2kq(n interface{}) syscall.Kevent_t { |
||||
kq, ok := n.(syscall.Kevent_t) |
||||
if !ok { |
||||
panic(fmt.Sprintf("kqueue: type should be Kevent_t, %T instead", n)) |
||||
} |
||||
return kq |
||||
} |
||||
|
||||
// Init implements trigger.
|
||||
func (k *kq) Init() (err error) { |
||||
if k.fd, err = syscall.Kqueue(); err != nil { |
||||
return |
||||
} |
||||
// Creates pipe used to stop `Kevent` call by registering it,
|
||||
// watching read end and writing to other end of it.
|
||||
if err = syscall.Pipe(k.pipefds[:]); err != nil { |
||||
return nonil(err, k.Close()) |
||||
} |
||||
var kevn [1]syscall.Kevent_t |
||||
syscall.SetKevent(&kevn[0], k.pipefds[0], syscall.EVFILT_READ, syscall.EV_ADD) |
||||
if _, err = syscall.Kevent(k.fd, kevn[:], nil, nil); err != nil { |
||||
return nonil(err, k.Close()) |
||||
} |
||||
return |
||||
} |
||||
|
||||
// Unwatch implements trigger.
|
||||
func (k *kq) Unwatch(w *watched) (err error) { |
||||
var kevn [1]syscall.Kevent_t |
||||
syscall.SetKevent(&kevn[0], w.fd, syscall.EVFILT_VNODE, syscall.EV_DELETE) |
||||
|
||||
_, err = syscall.Kevent(k.fd, kevn[:], nil, nil) |
||||
return |
||||
} |
||||
|
||||
// Watch implements trigger.
|
||||
func (k *kq) Watch(fi os.FileInfo, w *watched, e int64) (err error) { |
||||
var kevn [1]syscall.Kevent_t |
||||
syscall.SetKevent(&kevn[0], w.fd, syscall.EVFILT_VNODE, |
||||
syscall.EV_ADD|syscall.EV_CLEAR) |
||||
kevn[0].Fflags = uint32(e) |
||||
|
||||
_, err = syscall.Kevent(k.fd, kevn[:], nil, nil) |
||||
return |
||||
} |
||||
|
||||
// Wait implements trigger.
|
||||
func (k *kq) Wait() (interface{}, error) { |
||||
var ( |
||||
kevn [1]syscall.Kevent_t |
||||
err error |
||||
) |
||||
kevn[0] = syscall.Kevent_t{} |
||||
_, err = syscall.Kevent(k.fd, nil, kevn[:], nil) |
||||
|
||||
return kevn[0], err |
||||
} |
||||
|
||||
// Watched implements trigger.
|
||||
func (k *kq) Watched(n interface{}) (*watched, int64, error) { |
||||
kevn, ok := n.(syscall.Kevent_t) |
||||
if !ok { |
||||
panic(fmt.Sprintf("kq: type should be syscall.Kevent_t, %T instead", kevn)) |
||||
} |
||||
if _, ok = k.idLkp[int(kevn.Ident)]; !ok { |
||||
return nil, 0, errNotWatched |
||||
} |
||||
return k.idLkp[int(kevn.Ident)], int64(kevn.Fflags), nil |
||||
} |
||||
|
||||
// IsStop implements trigger.
|
||||
func (k *kq) IsStop(n interface{}, err error) bool { |
||||
return int(inter2kq(n).Ident) == k.pipefds[0] |
||||
} |
||||
|
||||
func init() { |
||||
encode = func(e Event) (o int64) { |
||||
// Create event is not supported by kqueue. Instead NoteWrite event will
|
||||
// be registered. If this event will be reported on dir which is to be
|
||||
// monitored for Create, dir will be rescanned and Create events will
|
||||
// be generated and returned for new files. In case of files,
|
||||
// if not requested NoteRename event is reported, it will be ignored.
|
||||
o = int64(e &^ Create) |
||||
if e&Write != 0 { |
||||
o = (o &^ int64(Write)) | int64(NoteWrite) |
||||
} |
||||
if e&Rename != 0 { |
||||
o = (o &^ int64(Rename)) | int64(NoteRename) |
||||
} |
||||
if e&Remove != 0 { |
||||
o = (o &^ int64(Remove)) | int64(NoteDelete) |
||||
} |
||||
return |
||||
} |
||||
nat2not = map[Event]Event{ |
||||
NoteWrite: Write, |
||||
NoteRename: Rename, |
||||
NoteDelete: Remove, |
||||
NoteExtend: Event(0), |
||||
NoteAttrib: Event(0), |
||||
NoteRevoke: Event(0), |
||||
NoteLink: Event(0), |
||||
} |
||||
not2nat = map[Event]Event{ |
||||
Write: NoteWrite, |
||||
Rename: NoteRename, |
||||
Remove: NoteDelete, |
||||
} |
||||
} |
@ -0,0 +1,574 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build windows
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"errors" |
||||
"runtime" |
||||
"sync" |
||||
"sync/atomic" |
||||
"syscall" |
||||
"unsafe" |
||||
) |
||||
|
||||
// readBufferSize defines the size of an array in which read statuses are stored.
|
||||
// The buffer have to be DWORD-aligned and, if notify is used in monitoring a
|
||||
// directory over the network, its size must not be greater than 64KB. Each of
|
||||
// watched directories uses its own buffer for storing events.
|
||||
const readBufferSize = 4096 |
||||
|
||||
// Since all operations which go through the Windows completion routine are done
|
||||
// asynchronously, filter may set one of the constants belor. They were defined
|
||||
// in order to distinguish whether current folder should be re-registered in
|
||||
// ReadDirectoryChangesW function or some control operations need to be executed.
|
||||
const ( |
||||
stateRewatch uint32 = 1 << (28 + iota) |
||||
stateUnwatch |
||||
stateCPClose |
||||
) |
||||
|
||||
// Filter used in current implementation was split into four segments:
|
||||
// - bits 0-11 store ReadDirectoryChangesW filters,
|
||||
// - bits 12-19 store File notify actions,
|
||||
// - bits 20-27 store notify specific events and flags,
|
||||
// - bits 28-31 store states which are used in loop's FSM.
|
||||
// Constants below are used as masks to retrieve only specific filter parts.
|
||||
const ( |
||||
onlyNotifyChanges uint32 = 0x00000FFF |
||||
onlyNGlobalEvents uint32 = 0x0FF00000 |
||||
onlyMachineStates uint32 = 0xF0000000 |
||||
) |
||||
|
||||
// grip represents a single watched directory. It stores the data required by
|
||||
// ReadDirectoryChangesW function. Only the filter, recursive, and handle members
|
||||
// may by modified by watcher implementation. Rest of the them have to remain
|
||||
// constant since they are used by Windows completion routine. This indicates that
|
||||
// grip can be removed only when all operations on the file handle are finished.
|
||||
type grip struct { |
||||
handle syscall.Handle |
||||
filter uint32 |
||||
recursive bool |
||||
pathw []uint16 |
||||
buffer [readBufferSize]byte |
||||
parent *watched |
||||
ovlapped *overlappedEx |
||||
} |
||||
|
||||
// overlappedEx stores information used in asynchronous input and output.
|
||||
// Additionally, overlappedEx contains a pointer to 'grip' item which is used in
|
||||
// order to gather the structure in which the overlappedEx object was created.
|
||||
type overlappedEx struct { |
||||
syscall.Overlapped |
||||
parent *grip |
||||
} |
||||
|
||||
// newGrip creates a new file handle that can be used in overlapped operations.
|
||||
// Then, the handle is associated with I/O completion port 'cph' and its value
|
||||
// is stored in newly created 'grip' object.
|
||||
func newGrip(cph syscall.Handle, parent *watched, filter uint32) (*grip, error) { |
||||
g := &grip{ |
||||
handle: syscall.InvalidHandle, |
||||
filter: filter, |
||||
recursive: parent.recursive, |
||||
pathw: parent.pathw, |
||||
parent: parent, |
||||
ovlapped: &overlappedEx{}, |
||||
} |
||||
if err := g.register(cph); err != nil { |
||||
return nil, err |
||||
} |
||||
g.ovlapped.parent = g |
||||
return g, nil |
||||
} |
||||
|
||||
// NOTE : Thread safe
|
||||
func (g *grip) register(cph syscall.Handle) (err error) { |
||||
if g.handle, err = syscall.CreateFile( |
||||
&g.pathw[0], |
||||
syscall.FILE_LIST_DIRECTORY, |
||||
syscall.FILE_SHARE_READ|syscall.FILE_SHARE_WRITE|syscall.FILE_SHARE_DELETE, |
||||
nil, |
||||
syscall.OPEN_EXISTING, |
||||
syscall.FILE_FLAG_BACKUP_SEMANTICS|syscall.FILE_FLAG_OVERLAPPED, |
||||
0, |
||||
); err != nil { |
||||
return |
||||
} |
||||
if _, err = syscall.CreateIoCompletionPort(g.handle, cph, 0, 0); err != nil { |
||||
syscall.CloseHandle(g.handle) |
||||
return |
||||
} |
||||
return g.readDirChanges() |
||||
} |
||||
|
||||
// readDirChanges tells the system to store file change information in grip's
|
||||
// buffer. Directory changes that occur between calls to this function are added
|
||||
// to the buffer and then, returned with the next call.
|
||||
func (g *grip) readDirChanges() error { |
||||
return syscall.ReadDirectoryChanges( |
||||
g.handle, |
||||
&g.buffer[0], |
||||
uint32(unsafe.Sizeof(g.buffer)), |
||||
g.recursive, |
||||
encode(g.filter), |
||||
nil, |
||||
(*syscall.Overlapped)(unsafe.Pointer(g.ovlapped)), |
||||
0, |
||||
) |
||||
} |
||||
|
||||
// encode transforms a generic filter, which contains platform independent and
|
||||
// implementation specific bit fields, to value that can be used as NotifyFilter
|
||||
// parameter in ReadDirectoryChangesW function.
|
||||
func encode(filter uint32) uint32 { |
||||
e := Event(filter & (onlyNGlobalEvents | onlyNotifyChanges)) |
||||
if e&dirmarker != 0 { |
||||
return uint32(FileNotifyChangeDirName) |
||||
} |
||||
if e&Create != 0 { |
||||
e = (e ^ Create) | FileNotifyChangeFileName |
||||
} |
||||
if e&Remove != 0 { |
||||
e = (e ^ Remove) | FileNotifyChangeFileName |
||||
} |
||||
if e&Write != 0 { |
||||
e = (e ^ Write) | FileNotifyChangeAttributes | FileNotifyChangeSize | |
||||
FileNotifyChangeCreation | FileNotifyChangeSecurity |
||||
} |
||||
if e&Rename != 0 { |
||||
e = (e ^ Rename) | FileNotifyChangeFileName |
||||
} |
||||
return uint32(e) |
||||
} |
||||
|
||||
// watched is made in order to check whether an action comes from a directory or
|
||||
// file. This approach requires two file handlers per single monitored folder. The
|
||||
// second grip handles actions which include creating or deleting a directory. If
|
||||
// these processes are not monitored, only the first grip is created.
|
||||
type watched struct { |
||||
filter uint32 |
||||
recursive bool |
||||
count uint8 |
||||
pathw []uint16 |
||||
digrip [2]*grip |
||||
} |
||||
|
||||
// newWatched creates a new watched instance. It splits the filter variable into
|
||||
// two parts. The first part is responsible for watching all events which can be
|
||||
// created for a file in watched directory structure and the second one watches
|
||||
// only directory Create/Remove actions. If all operations succeed, the Create
|
||||
// message is sent to I/O completion port queue for further processing.
|
||||
func newWatched(cph syscall.Handle, filter uint32, recursive bool, |
||||
path string) (wd *watched, err error) { |
||||
wd = &watched{ |
||||
filter: filter, |
||||
recursive: recursive, |
||||
} |
||||
if wd.pathw, err = syscall.UTF16FromString(path); err != nil { |
||||
return |
||||
} |
||||
if err = wd.recreate(cph); err != nil { |
||||
return |
||||
} |
||||
return wd, nil |
||||
} |
||||
|
||||
// TODO : doc
|
||||
func (wd *watched) recreate(cph syscall.Handle) (err error) { |
||||
filefilter := wd.filter &^ uint32(FileNotifyChangeDirName) |
||||
if err = wd.updateGrip(0, cph, filefilter == 0, filefilter); err != nil { |
||||
return |
||||
} |
||||
dirfilter := wd.filter & uint32(FileNotifyChangeDirName|Create|Remove) |
||||
if err = wd.updateGrip(1, cph, dirfilter == 0, wd.filter|uint32(dirmarker)); err != nil { |
||||
return |
||||
} |
||||
wd.filter &^= onlyMachineStates |
||||
return |
||||
} |
||||
|
||||
// TODO : doc
|
||||
func (wd *watched) updateGrip(idx int, cph syscall.Handle, reset bool, |
||||
newflag uint32) (err error) { |
||||
if reset { |
||||
wd.digrip[idx] = nil |
||||
} else { |
||||
if wd.digrip[idx] == nil { |
||||
if wd.digrip[idx], err = newGrip(cph, wd, newflag); err != nil { |
||||
wd.closeHandle() |
||||
return |
||||
} |
||||
} else { |
||||
wd.digrip[idx].filter = newflag |
||||
wd.digrip[idx].recursive = wd.recursive |
||||
if err = wd.digrip[idx].register(cph); err != nil { |
||||
wd.closeHandle() |
||||
return |
||||
} |
||||
} |
||||
wd.count++ |
||||
} |
||||
return |
||||
} |
||||
|
||||
// closeHandle closes handles that are stored in digrip array. Function always
|
||||
// tries to close all of the handlers before it exits, even when there are errors
|
||||
// returned from the operating system kernel.
|
||||
func (wd *watched) closeHandle() (err error) { |
||||
for _, g := range wd.digrip { |
||||
if g != nil && g.handle != syscall.InvalidHandle { |
||||
switch suberr := syscall.CloseHandle(g.handle); { |
||||
case suberr == nil: |
||||
g.handle = syscall.InvalidHandle |
||||
case err == nil: |
||||
err = suberr |
||||
} |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
// watcher implements Watcher interface. It stores a set of watched directories.
|
||||
// All operations which remove watched objects from map `m` must be performed in
|
||||
// loop goroutine since these structures are used internally by operating system.
|
||||
type readdcw struct { |
||||
sync.Mutex |
||||
m map[string]*watched |
||||
cph syscall.Handle |
||||
start bool |
||||
wg sync.WaitGroup |
||||
c chan<- EventInfo |
||||
} |
||||
|
||||
// NewWatcher creates new non-recursive watcher backed by ReadDirectoryChangesW.
|
||||
func newWatcher(c chan<- EventInfo) watcher { |
||||
r := &readdcw{ |
||||
m: make(map[string]*watched), |
||||
cph: syscall.InvalidHandle, |
||||
c: c, |
||||
} |
||||
runtime.SetFinalizer(r, func(r *readdcw) { |
||||
if r.cph != syscall.InvalidHandle { |
||||
syscall.CloseHandle(r.cph) |
||||
} |
||||
}) |
||||
return r |
||||
} |
||||
|
||||
// Watch implements notify.Watcher interface.
|
||||
func (r *readdcw) Watch(path string, event Event) error { |
||||
return r.watch(path, event, false) |
||||
} |
||||
|
||||
// RecursiveWatch implements notify.RecursiveWatcher interface.
|
||||
func (r *readdcw) RecursiveWatch(path string, event Event) error { |
||||
return r.watch(path, event, true) |
||||
} |
||||
|
||||
// watch inserts a directory to the group of watched folders. If watched folder
|
||||
// already exists, function tries to rewatch it with new filters(NOT VALID). Moreover,
|
||||
// watch starts the main event loop goroutine when called for the first time.
|
||||
func (r *readdcw) watch(path string, event Event, recursive bool) (err error) { |
||||
if event&^(All|fileNotifyChangeAll) != 0 { |
||||
return errors.New("notify: unknown event") |
||||
} |
||||
r.Lock() |
||||
wd, ok := r.m[path] |
||||
r.Unlock() |
||||
if !ok { |
||||
if err = r.lazyinit(); err != nil { |
||||
return |
||||
} |
||||
r.Lock() |
||||
if wd, ok = r.m[path]; ok { |
||||
r.Unlock() |
||||
return |
||||
} |
||||
if wd, err = newWatched(r.cph, uint32(event), recursive, path); err != nil { |
||||
r.Unlock() |
||||
return |
||||
} |
||||
r.m[path] = wd |
||||
r.Unlock() |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// lazyinit creates an I/O completion port and starts the main event processing
|
||||
// loop. This method uses Double-Checked Locking optimization.
|
||||
func (r *readdcw) lazyinit() (err error) { |
||||
invalid := uintptr(syscall.InvalidHandle) |
||||
if atomic.LoadUintptr((*uintptr)(&r.cph)) == invalid { |
||||
r.Lock() |
||||
defer r.Unlock() |
||||
if atomic.LoadUintptr((*uintptr)(&r.cph)) == invalid { |
||||
cph := syscall.InvalidHandle |
||||
if cph, err = syscall.CreateIoCompletionPort(cph, 0, 0, 0); err != nil { |
||||
return |
||||
} |
||||
r.cph, r.start = cph, true |
||||
go r.loop() |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
// TODO(pknap) : doc
|
||||
func (r *readdcw) loop() { |
||||
var n, key uint32 |
||||
var overlapped *syscall.Overlapped |
||||
for { |
||||
err := syscall.GetQueuedCompletionStatus(r.cph, &n, &key, &overlapped, syscall.INFINITE) |
||||
if key == stateCPClose { |
||||
r.Lock() |
||||
handle := r.cph |
||||
r.cph = syscall.InvalidHandle |
||||
r.Unlock() |
||||
syscall.CloseHandle(handle) |
||||
r.wg.Done() |
||||
return |
||||
} |
||||
if overlapped == nil { |
||||
// TODO: check key == rewatch delete or 0(panic)
|
||||
continue |
||||
} |
||||
overEx := (*overlappedEx)(unsafe.Pointer(overlapped)) |
||||
if n == 0 { |
||||
r.loopstate(overEx) |
||||
} else { |
||||
r.loopevent(n, overEx) |
||||
if err = overEx.parent.readDirChanges(); err != nil { |
||||
// TODO: error handling
|
||||
} |
||||
} |
||||
} |
||||
} |
||||
|
||||
// TODO(pknap) : doc
|
||||
func (r *readdcw) loopstate(overEx *overlappedEx) { |
||||
filter := atomic.LoadUint32(&overEx.parent.parent.filter) |
||||
if filter&onlyMachineStates == 0 { |
||||
return |
||||
} |
||||
if overEx.parent.parent.count--; overEx.parent.parent.count == 0 { |
||||
switch filter & onlyMachineStates { |
||||
case stateRewatch: |
||||
r.Lock() |
||||
overEx.parent.parent.recreate(r.cph) |
||||
r.Unlock() |
||||
case stateUnwatch: |
||||
r.Lock() |
||||
delete(r.m, syscall.UTF16ToString(overEx.parent.pathw)) |
||||
r.Unlock() |
||||
case stateCPClose: |
||||
default: |
||||
panic(`notify: windows loopstate logic error`) |
||||
} |
||||
} |
||||
} |
||||
|
||||
// TODO(pknap) : doc
|
||||
func (r *readdcw) loopevent(n uint32, overEx *overlappedEx) { |
||||
events := []*event{} |
||||
var currOffset uint32 |
||||
for { |
||||
raw := (*syscall.FileNotifyInformation)(unsafe.Pointer(&overEx.parent.buffer[currOffset])) |
||||
name := syscall.UTF16ToString((*[syscall.MAX_PATH]uint16)(unsafe.Pointer(&raw.FileName))[:raw.FileNameLength>>1]) |
||||
events = append(events, &event{ |
||||
pathw: overEx.parent.pathw, |
||||
filter: overEx.parent.filter, |
||||
action: raw.Action, |
||||
name: name, |
||||
}) |
||||
if raw.NextEntryOffset == 0 { |
||||
break |
||||
} |
||||
if currOffset += raw.NextEntryOffset; currOffset >= n { |
||||
break |
||||
} |
||||
} |
||||
r.send(events) |
||||
} |
||||
|
||||
// TODO(pknap) : doc
|
||||
func (r *readdcw) send(es []*event) { |
||||
for _, e := range es { |
||||
var syse Event |
||||
if e.e, syse = decode(e.filter, e.action); e.e == 0 && syse == 0 { |
||||
continue |
||||
} |
||||
switch { |
||||
case e.action == syscall.FILE_ACTION_MODIFIED: |
||||
e.ftype = fTypeUnknown |
||||
case e.filter&uint32(dirmarker) != 0: |
||||
e.ftype = fTypeDirectory |
||||
default: |
||||
e.ftype = fTypeFile |
||||
} |
||||
switch { |
||||
case e.e == 0: |
||||
e.e = syse |
||||
case syse != 0: |
||||
r.c <- &event{ |
||||
pathw: e.pathw, |
||||
name: e.name, |
||||
ftype: e.ftype, |
||||
action: e.action, |
||||
filter: e.filter, |
||||
e: syse, |
||||
} |
||||
} |
||||
r.c <- e |
||||
} |
||||
} |
||||
|
||||
// Rewatch implements notify.Rewatcher interface.
|
||||
func (r *readdcw) Rewatch(path string, oldevent, newevent Event) error { |
||||
return r.rewatch(path, uint32(oldevent), uint32(newevent), false) |
||||
} |
||||
|
||||
// RecursiveRewatch implements notify.RecursiveRewatcher interface.
|
||||
func (r *readdcw) RecursiveRewatch(oldpath, newpath string, oldevent, |
||||
newevent Event) error { |
||||
if oldpath != newpath { |
||||
if err := r.unwatch(oldpath); err != nil { |
||||
return err |
||||
} |
||||
return r.watch(newpath, newevent, true) |
||||
} |
||||
return r.rewatch(newpath, uint32(oldevent), uint32(newevent), true) |
||||
} |
||||
|
||||
// TODO : (pknap) doc.
|
||||
func (r *readdcw) rewatch(path string, oldevent, newevent uint32, recursive bool) (err error) { |
||||
if Event(newevent)&^(All|fileNotifyChangeAll) != 0 { |
||||
return errors.New("notify: unknown event") |
||||
} |
||||
var wd *watched |
||||
r.Lock() |
||||
if wd, err = r.nonStateWatched(path); err != nil { |
||||
r.Unlock() |
||||
return |
||||
} |
||||
if wd.filter&(onlyNotifyChanges|onlyNGlobalEvents) != oldevent { |
||||
panic(`notify: windows re-watcher logic error`) |
||||
} |
||||
wd.filter = stateRewatch | newevent |
||||
wd.recursive, recursive = recursive, wd.recursive |
||||
if err = wd.closeHandle(); err != nil { |
||||
wd.filter = oldevent |
||||
wd.recursive = recursive |
||||
r.Unlock() |
||||
return |
||||
} |
||||
r.Unlock() |
||||
return |
||||
} |
||||
|
||||
// TODO : pknap
|
||||
func (r *readdcw) nonStateWatched(path string) (wd *watched, err error) { |
||||
wd, ok := r.m[path] |
||||
if !ok || wd == nil { |
||||
err = errors.New(`notify: ` + path + ` path is unwatched`) |
||||
return |
||||
} |
||||
if filter := atomic.LoadUint32(&wd.filter); filter&onlyMachineStates != 0 { |
||||
err = errors.New(`notify: another re/unwatching operation in progress`) |
||||
return |
||||
} |
||||
return |
||||
} |
||||
|
||||
// Unwatch implements notify.Watcher interface.
|
||||
func (r *readdcw) Unwatch(path string) error { |
||||
return r.unwatch(path) |
||||
} |
||||
|
||||
// RecursiveUnwatch implements notify.RecursiveWatcher interface.
|
||||
func (r *readdcw) RecursiveUnwatch(path string) error { |
||||
return r.unwatch(path) |
||||
} |
||||
|
||||
// TODO : pknap
|
||||
func (r *readdcw) unwatch(path string) (err error) { |
||||
var wd *watched |
||||
r.Lock() |
||||
if wd, err = r.nonStateWatched(path); err != nil { |
||||
r.Unlock() |
||||
return |
||||
} |
||||
wd.filter |= stateUnwatch |
||||
if err = wd.closeHandle(); err != nil { |
||||
wd.filter &^= stateUnwatch |
||||
r.Unlock() |
||||
return |
||||
} |
||||
r.Unlock() |
||||
return |
||||
} |
||||
|
||||
// Close resets the whole watcher object, closes all existing file descriptors,
|
||||
// and sends stateCPClose state as completion key to the main watcher's loop.
|
||||
func (r *readdcw) Close() (err error) { |
||||
r.Lock() |
||||
if !r.start { |
||||
r.Unlock() |
||||
return nil |
||||
} |
||||
for _, wd := range r.m { |
||||
wd.filter &^= onlyMachineStates |
||||
wd.filter |= stateCPClose |
||||
if e := wd.closeHandle(); e != nil && err == nil { |
||||
err = e |
||||
} |
||||
} |
||||
r.start = false |
||||
r.Unlock() |
||||
r.wg.Add(1) |
||||
if e := syscall.PostQueuedCompletionStatus(r.cph, 0, stateCPClose, nil); e != nil && err == nil { |
||||
return e |
||||
} |
||||
r.wg.Wait() |
||||
return |
||||
} |
||||
|
||||
// decode creates a notify event from both non-raw filter and action which was
|
||||
// returned from completion routine. Function may return Event(0) in case when
|
||||
// filter was replaced by a new value which does not contain fields that are
|
||||
// valid with passed action.
|
||||
func decode(filter, action uint32) (Event, Event) { |
||||
switch action { |
||||
case syscall.FILE_ACTION_ADDED: |
||||
return gensys(filter, Create, FileActionAdded) |
||||
case syscall.FILE_ACTION_REMOVED: |
||||
return gensys(filter, Remove, FileActionRemoved) |
||||
case syscall.FILE_ACTION_MODIFIED: |
||||
return gensys(filter, Write, FileActionModified) |
||||
case syscall.FILE_ACTION_RENAMED_OLD_NAME: |
||||
return gensys(filter, Rename, FileActionRenamedOldName) |
||||
case syscall.FILE_ACTION_RENAMED_NEW_NAME: |
||||
return gensys(filter, Rename, FileActionRenamedNewName) |
||||
} |
||||
panic(`notify: cannot decode internal mask`) |
||||
} |
||||
|
||||
// gensys decides whether the Windows action, system-independent event or both
|
||||
// of them should be returned. Since the grip's filter may be atomically changed
|
||||
// during watcher lifetime, it is possible that neither Windows nor notify masks
|
||||
// are watched by the user when this function is called.
|
||||
func gensys(filter uint32, ge, se Event) (gene, syse Event) { |
||||
isdir := filter&uint32(dirmarker) != 0 |
||||
if isdir && filter&uint32(FileNotifyChangeDirName) != 0 || |
||||
!isdir && filter&uint32(FileNotifyChangeFileName) != 0 || |
||||
filter&uint32(fileNotifyChangeModified) != 0 { |
||||
syse = se |
||||
} |
||||
if filter&uint32(ge) != 0 { |
||||
gene = ge |
||||
} |
||||
return |
||||
} |
@ -0,0 +1,23 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build !darwin,!linux,!freebsd,!dragonfly,!netbsd,!openbsd,!windows
|
||||
// +build !kqueue,!solaris
|
||||
|
||||
package notify |
||||
|
||||
import "errors" |
||||
|
||||
type stub struct{ error } |
||||
|
||||
// newWatcher stub.
|
||||
func newWatcher(chan<- EventInfo) watcher { |
||||
return stub{errors.New("notify: not implemented")} |
||||
} |
||||
|
||||
// Following methods implement notify.watcher interface.
|
||||
func (s stub) Watch(string, Event) error { return s } |
||||
func (s stub) Rewatch(string, Event, Event) error { return s } |
||||
func (s stub) Unwatch(string) (err error) { return s } |
||||
func (s stub) Close() error { return s } |
@ -0,0 +1,438 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build darwin,kqueue dragonfly freebsd netbsd openbsd solaris
|
||||
|
||||
// watcher_trigger is used for FEN and kqueue which behave similarly:
|
||||
// only files and dirs can be watched directly, but not files inside dirs.
|
||||
// As a result Create events have to be generated by implementation when
|
||||
// after Write event is returned for watched dir, it is rescanned and Create
|
||||
// event is returned for new files and these are automatically added
|
||||
// to watchlist. In case of removal of watched directory, native system returns
|
||||
// events for all files, but for Rename, they also need to be generated.
|
||||
// As a result native system works as something like trigger for rescan,
|
||||
// but contains additional data about dir in which changes occurred. For files
|
||||
// detailed data is returned.
|
||||
// Usage of watcher_trigger requires:
|
||||
// - trigger implementation,
|
||||
// - encode func,
|
||||
// - not2nat, nat2not maps.
|
||||
// Required manual operations on filesystem can lead to loss of precision.
|
||||
|
||||
package notify |
||||
|
||||
import ( |
||||
"os" |
||||
"path/filepath" |
||||
"strings" |
||||
"sync" |
||||
"syscall" |
||||
) |
||||
|
||||
// trigger is to be implemented by platform implementation like FEN or kqueue.
|
||||
type trigger interface { |
||||
// Close closes watcher's main native file descriptor.
|
||||
Close() error |
||||
// Stop waiting for new events.
|
||||
Stop() error |
||||
// Create new instance of watched.
|
||||
NewWatched(string, os.FileInfo) (*watched, error) |
||||
// Record internally new *watched instance.
|
||||
Record(*watched) |
||||
// Del removes internal copy of *watched instance.
|
||||
Del(*watched) |
||||
// Watched returns *watched instance and native events for native type.
|
||||
Watched(interface{}) (*watched, int64, error) |
||||
// Init initializes native watcher call.
|
||||
Init() error |
||||
// Watch starts watching provided file/dir.
|
||||
Watch(os.FileInfo, *watched, int64) error |
||||
// Unwatch stops watching provided file/dir.
|
||||
Unwatch(*watched) error |
||||
// Wait for new events.
|
||||
Wait() (interface{}, error) |
||||
// IsStop checks if Wait finished because of request watcher's stop.
|
||||
IsStop(n interface{}, err error) bool |
||||
} |
||||
|
||||
// encode Event to native representation. Implementation is to be provided by
|
||||
// platform specific implementation.
|
||||
var encode func(Event) int64 |
||||
|
||||
var ( |
||||
// nat2not matches native events to notify's ones. To be initialized by
|
||||
// platform dependent implementation.
|
||||
nat2not map[Event]Event |
||||
// not2nat matches notify's events to native ones. To be initialized by
|
||||
// platform dependent implementation.
|
||||
not2nat map[Event]Event |
||||
) |
||||
|
||||
// trg is a main structure implementing watcher.
|
||||
type trg struct { |
||||
sync.Mutex |
||||
// s is a channel used to stop monitoring.
|
||||
s chan struct{} |
||||
// c is a channel used to pass events further.
|
||||
c chan<- EventInfo |
||||
// pthLkp is a data structure mapping file names with data about watching
|
||||
// represented by them files/directories.
|
||||
pthLkp map[string]*watched |
||||
// t is a platform dependent implementation of trigger.
|
||||
t trigger |
||||
} |
||||
|
||||
// newWatcher returns new watcher's implementation.
|
||||
func newWatcher(c chan<- EventInfo) watcher { |
||||
t := &trg{ |
||||
s: make(chan struct{}, 1), |
||||
pthLkp: make(map[string]*watched, 0), |
||||
c: c, |
||||
} |
||||
t.t = newTrigger(t.pthLkp) |
||||
if err := t.t.Init(); err != nil { |
||||
panic(err) |
||||
} |
||||
go t.monitor() |
||||
return t |
||||
} |
||||
|
||||
// Close implements watcher.
|
||||
func (t *trg) Close() (err error) { |
||||
t.Lock() |
||||
if err = t.t.Stop(); err != nil { |
||||
t.Unlock() |
||||
return |
||||
} |
||||
<-t.s |
||||
var e error |
||||
for _, w := range t.pthLkp { |
||||
if e = t.unwatch(w.p, w.fi); e != nil { |
||||
dbgprintf("trg: unwatch %q failed: %q\n", w.p, e) |
||||
err = nonil(err, e) |
||||
} |
||||
} |
||||
if e = t.t.Close(); e != nil { |
||||
dbgprintf("trg: closing native watch failed: %q\n", e) |
||||
err = nonil(err, e) |
||||
} |
||||
t.Unlock() |
||||
return |
||||
} |
||||
|
||||
// send reported events one by one through chan.
|
||||
func (t *trg) send(evn []event) { |
||||
for i := range evn { |
||||
t.c <- &evn[i] |
||||
} |
||||
} |
||||
|
||||
// singlewatch starts to watch given p file/directory.
|
||||
func (t *trg) singlewatch(p string, e Event, direct mode, fi os.FileInfo) (err error) { |
||||
w, ok := t.pthLkp[p] |
||||
if !ok { |
||||
if w, err = t.t.NewWatched(p, fi); err != nil { |
||||
return |
||||
} |
||||
} |
||||
switch direct { |
||||
case dir: |
||||
w.eDir |= e |
||||
case ndir: |
||||
w.eNonDir |= e |
||||
case both: |
||||
w.eDir |= e |
||||
w.eNonDir |= e |
||||
} |
||||
var ee int64 |
||||
// Native Write event is added to wait for Create events (Write event on
|
||||
// directory triggers it's rescan).
|
||||
if e&Create != 0 && fi.IsDir() { |
||||
ee = int64(not2nat[Write]) |
||||
} |
||||
if err = t.t.Watch(fi, w, encode(w.eDir|w.eNonDir)|ee); err != nil { |
||||
return |
||||
} |
||||
if !ok { |
||||
t.t.Record(w) |
||||
return nil |
||||
} |
||||
return errAlreadyWatched |
||||
} |
||||
|
||||
// decode converts event received from native to notify.Event
|
||||
// representation taking into account requested events (w).
|
||||
func decode(o int64, w Event) (e Event) { |
||||
for f, n := range nat2not { |
||||
if o&int64(f) != 0 { |
||||
if w&f != 0 { |
||||
e |= f |
||||
} |
||||
if w&n != 0 { |
||||
e |= n |
||||
} |
||||
} |
||||
} |
||||
|
||||
return |
||||
} |
||||
|
||||
func (t *trg) watch(p string, e Event, fi os.FileInfo) error { |
||||
if err := t.singlewatch(p, e, dir, fi); err != nil { |
||||
if err != errAlreadyWatched { |
||||
return nil |
||||
} |
||||
} |
||||
if fi.IsDir() { |
||||
err := t.walk(p, func(fi os.FileInfo) (err error) { |
||||
if err = t.singlewatch(filepath.Join(p, fi.Name()), e, ndir, |
||||
fi); err != nil { |
||||
if err != errAlreadyWatched { |
||||
return |
||||
} |
||||
} |
||||
return nil |
||||
}) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// walk runs f func on each file/dir from p directory.
|
||||
func (t *trg) walk(p string, fn func(os.FileInfo) error) error { |
||||
fp, err := os.Open(p) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
ls, err := fp.Readdir(0) |
||||
fp.Close() |
||||
if err != nil { |
||||
return err |
||||
} |
||||
for i := range ls { |
||||
if err := fn(ls[i]); err != nil { |
||||
return err |
||||
} |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (t *trg) unwatch(p string, fi os.FileInfo) error { |
||||
if fi.IsDir() { |
||||
err := t.walk(p, func(fi os.FileInfo) error { |
||||
err := t.singleunwatch(filepath.Join(p, fi.Name()), ndir) |
||||
if err != errNotWatched { |
||||
return err |
||||
} |
||||
return nil |
||||
}) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
} |
||||
return t.singleunwatch(p, dir) |
||||
} |
||||
|
||||
// Watch implements Watcher interface.
|
||||
func (t *trg) Watch(p string, e Event) error { |
||||
fi, err := os.Stat(p) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
t.Lock() |
||||
err = t.watch(p, e, fi) |
||||
t.Unlock() |
||||
return err |
||||
} |
||||
|
||||
// Unwatch implements Watcher interface.
|
||||
func (t *trg) Unwatch(p string) error { |
||||
fi, err := os.Stat(p) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
t.Lock() |
||||
err = t.unwatch(p, fi) |
||||
t.Unlock() |
||||
return err |
||||
} |
||||
|
||||
// Rewatch implements Watcher interface.
|
||||
//
|
||||
// TODO(rjeczalik): This is a naive hack. Rewrite might help.
|
||||
func (t *trg) Rewatch(p string, _, e Event) error { |
||||
fi, err := os.Stat(p) |
||||
if err != nil { |
||||
return err |
||||
} |
||||
t.Lock() |
||||
if err = t.unwatch(p, fi); err == nil { |
||||
// TODO(rjeczalik): If watch fails then we leave trigger in inconsistent
|
||||
// state. Handle? Panic? Native version of rewatch?
|
||||
err = t.watch(p, e, fi) |
||||
} |
||||
t.Unlock() |
||||
return nil |
||||
} |
||||
|
||||
func (*trg) file(w *watched, n interface{}, e Event) (evn []event) { |
||||
evn = append(evn, event{w.p, e, w.fi.IsDir(), n}) |
||||
return |
||||
} |
||||
|
||||
func (t *trg) dir(w *watched, n interface{}, e, ge Event) (evn []event) { |
||||
// If it's dir and delete we have to send it and continue, because
|
||||
// other processing relies on opening (in this case not existing) dir.
|
||||
// Events for contents of this dir are reported by native impl.
|
||||
// However events for rename must be generated for all monitored files
|
||||
// inside of moved directory, because native impl does not report it independently
|
||||
// for each file descriptor being moved in result of move action on
|
||||
// parent dirLiczba dostępnych dni urlopowych: 0ectory.
|
||||
if (ge & (not2nat[Rename] | not2nat[Remove])) != 0 { |
||||
// Write is reported also for Remove on directory. Because of that
|
||||
// we have to filter it out explicitly.
|
||||
evn = append(evn, event{w.p, e & ^Write & ^not2nat[Write], true, n}) |
||||
if ge¬2nat[Rename] != 0 { |
||||
for p := range t.pthLkp { |
||||
if strings.HasPrefix(p, w.p+string(os.PathSeparator)) { |
||||
if err := t.singleunwatch(p, both); err != nil && err != errNotWatched && |
||||
!os.IsNotExist(err) { |
||||
dbgprintf("trg: failed stop watching moved file (%q): %q\n", |
||||
p, err) |
||||
} |
||||
if (w.eDir|w.eNonDir)&(not2nat[Rename]|Rename) != 0 { |
||||
evn = append(evn, event{ |
||||
p, (w.eDir | w.eNonDir) & e &^ Write &^ not2nat[Write], |
||||
w.fi.IsDir(), nil, |
||||
}) |
||||
} |
||||
} |
||||
} |
||||
} |
||||
t.t.Del(w) |
||||
return |
||||
} |
||||
if (ge & not2nat[Write]) != 0 { |
||||
switch err := t.walk(w.p, func(fi os.FileInfo) error { |
||||
p := filepath.Join(w.p, fi.Name()) |
||||
switch err := t.singlewatch(p, w.eDir, ndir, fi); { |
||||
case os.IsNotExist(err) && ((w.eDir & Remove) != 0): |
||||
evn = append(evn, event{p, Remove, fi.IsDir(), n}) |
||||
case err == errAlreadyWatched: |
||||
case err != nil: |
||||
dbgprintf("trg: watching %q failed: %q", p, err) |
||||
case (w.eDir & Create) != 0: |
||||
evn = append(evn, event{p, Create, fi.IsDir(), n}) |
||||
default: |
||||
} |
||||
return nil |
||||
}); { |
||||
case os.IsNotExist(err): |
||||
return |
||||
case err != nil: |
||||
dbgprintf("trg: dir processing failed: %q", err) |
||||
default: |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
type mode uint |
||||
|
||||
const ( |
||||
dir mode = iota |
||||
ndir |
||||
both |
||||
) |
||||
|
||||
// unwatch stops watching p file/directory.
|
||||
func (t *trg) singleunwatch(p string, direct mode) error { |
||||
w, ok := t.pthLkp[p] |
||||
if !ok { |
||||
return errNotWatched |
||||
} |
||||
switch direct { |
||||
case dir: |
||||
w.eDir = 0 |
||||
case ndir: |
||||
w.eNonDir = 0 |
||||
case both: |
||||
w.eDir, w.eNonDir = 0, 0 |
||||
} |
||||
if err := t.t.Unwatch(w); err != nil { |
||||
return err |
||||
} |
||||
if w.eNonDir|w.eDir != 0 { |
||||
mod := dir |
||||
if w.eNonDir == 0 { |
||||
mod = ndir |
||||
} |
||||
if err := t.singlewatch(p, w.eNonDir|w.eDir, mod, |
||||
w.fi); err != nil && err != errAlreadyWatched { |
||||
return err |
||||
} |
||||
} else { |
||||
t.t.Del(w) |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
func (t *trg) monitor() { |
||||
var ( |
||||
n interface{} |
||||
err error |
||||
) |
||||
for { |
||||
switch n, err = t.t.Wait(); { |
||||
case err == syscall.EINTR: |
||||
case t.t.IsStop(n, err): |
||||
t.s <- struct{}{} |
||||
return |
||||
case err != nil: |
||||
dbgprintf("trg: failed to read events: %q\n", err) |
||||
default: |
||||
t.send(t.process(n)) |
||||
} |
||||
} |
||||
} |
||||
|
||||
// process event returned by port_get call.
|
||||
func (t *trg) process(n interface{}) (evn []event) { |
||||
t.Lock() |
||||
w, ge, err := t.t.Watched(n) |
||||
if err != nil { |
||||
t.Unlock() |
||||
dbgprintf("trg: %v event lookup failed: %q", Event(ge), err) |
||||
return |
||||
} |
||||
|
||||
e := decode(ge, w.eDir|w.eNonDir) |
||||
if ge&int64(not2nat[Remove]|not2nat[Rename]) == 0 { |
||||
switch fi, err := os.Stat(w.p); { |
||||
case err != nil: |
||||
default: |
||||
if err = t.t.Watch(fi, w, (encode(w.eDir | w.eNonDir))); err != nil { |
||||
dbgprintf("trg: %q is no longer watched: %q", w.p, err) |
||||
t.t.Del(w) |
||||
} |
||||
} |
||||
} |
||||
if e == Event(0) { |
||||
t.Unlock() |
||||
return |
||||
} |
||||
|
||||
if w.fi.IsDir() { |
||||
evn = append(evn, t.dir(w, n, e, Event(ge))...) |
||||
} else { |
||||
evn = append(evn, t.file(w, n, e)...) |
||||
} |
||||
if Event(ge)&(not2nat[Remove]|not2nat[Rename]) != 0 { |
||||
t.t.Del(w) |
||||
} |
||||
t.Unlock() |
||||
return |
||||
} |
@ -0,0 +1,103 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
package notify |
||||
|
||||
// EventDiff describes a change to an event set - EventDiff[0] is an old state,
|
||||
// while EventDiff[1] is a new state. If event set has not changed (old == new),
|
||||
// functions typically return the None value.
|
||||
type eventDiff [2]Event |
||||
|
||||
func (diff eventDiff) Event() Event { |
||||
return diff[1] &^ diff[0] |
||||
} |
||||
|
||||
// Watchpoint
|
||||
//
|
||||
// The nil key holds total event set - logical sum for all registered events.
|
||||
// It speeds up computing EventDiff for Add method.
|
||||
//
|
||||
// The rec key holds an event set for a watchpoints created by RecursiveWatch
|
||||
// for a Watcher implementation which is not natively recursive.
|
||||
type watchpoint map[chan<- EventInfo]Event |
||||
|
||||
// None is an empty event diff, think null object.
|
||||
var none eventDiff |
||||
|
||||
// rec is just a placeholder
|
||||
var rec = func() (ch chan<- EventInfo) { |
||||
ch = make(chan<- EventInfo) |
||||
close(ch) |
||||
return |
||||
}() |
||||
|
||||
func (wp watchpoint) dryAdd(ch chan<- EventInfo, e Event) eventDiff { |
||||
if e &^= internal; wp[ch]&e == e { |
||||
return none |
||||
} |
||||
total := wp[ch] &^ internal |
||||
return eventDiff{total, total | e} |
||||
} |
||||
|
||||
// Add assumes neither c nor e are nil or zero values.
|
||||
func (wp watchpoint) Add(c chan<- EventInfo, e Event) (diff eventDiff) { |
||||
wp[c] |= e |
||||
diff[0] = wp[nil] |
||||
diff[1] = diff[0] | e |
||||
wp[nil] = diff[1] &^ omit |
||||
// Strip diff from internal events.
|
||||
diff[0] &^= internal |
||||
diff[1] &^= internal |
||||
if diff[0] == diff[1] { |
||||
return none |
||||
} |
||||
return |
||||
} |
||||
|
||||
func (wp watchpoint) Del(c chan<- EventInfo, e Event) (diff eventDiff) { |
||||
wp[c] &^= e |
||||
if wp[c] == 0 { |
||||
delete(wp, c) |
||||
} |
||||
diff[0] = wp[nil] |
||||
delete(wp, nil) |
||||
if len(wp) != 0 { |
||||
// Recalculate total event set.
|
||||
for _, e := range wp { |
||||
diff[1] |= e |
||||
} |
||||
wp[nil] = diff[1] &^ omit |
||||
} |
||||
// Strip diff from internal events.
|
||||
diff[0] &^= internal |
||||
diff[1] &^= internal |
||||
if diff[0] == diff[1] { |
||||
return none |
||||
} |
||||
return |
||||
} |
||||
|
||||
func (wp watchpoint) Dispatch(ei EventInfo, extra Event) { |
||||
e := eventmask(ei, extra) |
||||
if !matches(wp[nil], e) { |
||||
return |
||||
} |
||||
for ch, eset := range wp { |
||||
if ch != nil && matches(eset, e) { |
||||
select { |
||||
case ch <- ei: |
||||
default: // Drop event if receiver is too slow
|
||||
dbgprintf("dropped %s on %q: receiver too slow", ei.Event(), ei.Path()) |
||||
} |
||||
} |
||||
} |
||||
} |
||||
|
||||
func (wp watchpoint) Total() Event { |
||||
return wp[nil] &^ internal |
||||
} |
||||
|
||||
func (wp watchpoint) IsRecursive() bool { |
||||
return wp[nil]&recursive != 0 |
||||
} |
@ -0,0 +1,23 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build !windows
|
||||
|
||||
package notify |
||||
|
||||
// eventmask uses ei to create a new event which contains internal flags used by
|
||||
// notify package logic.
|
||||
func eventmask(ei EventInfo, extra Event) Event { |
||||
return ei.Event() | extra |
||||
} |
||||
|
||||
// matches reports a match only when:
|
||||
//
|
||||
// - for user events, when event is present in the given set
|
||||
// - for internal events, when additionaly both event and set have omit bit set
|
||||
//
|
||||
// Internal events must not be sent to user channels and vice versa.
|
||||
func matches(set, event Event) bool { |
||||
return (set&omit)^(event&omit) == 0 && set&event == event |
||||
} |
@ -0,0 +1,38 @@ |
||||
// Copyright (c) 2014-2015 The Notify Authors. All rights reserved.
|
||||
// Use of this source code is governed by the MIT license that can be
|
||||
// found in the LICENSE file.
|
||||
|
||||
// +build windows
|
||||
|
||||
package notify |
||||
|
||||
// eventmask uses ei to create a new event which contains internal flags used by
|
||||
// notify package logic. If one of FileAction* masks is detected, this function
|
||||
// adds corresponding FileNotifyChange* values. This allows non registered
|
||||
// FileAction* events to be passed on.
|
||||
func eventmask(ei EventInfo, extra Event) (e Event) { |
||||
if e = ei.Event() | extra; e&fileActionAll != 0 { |
||||
if ev, ok := ei.(*event); ok { |
||||
switch ev.ftype { |
||||
case fTypeFile: |
||||
e |= FileNotifyChangeFileName |
||||
case fTypeDirectory: |
||||
e |= FileNotifyChangeDirName |
||||
case fTypeUnknown: |
||||
e |= fileNotifyChangeModified |
||||
} |
||||
return e &^ fileActionAll |
||||
} |
||||
} |
||||
return |
||||
} |
||||
|
||||
// matches reports a match only when:
|
||||
//
|
||||
// - for user events, when event is present in the given set
|
||||
// - for internal events, when additionally both event and set have omit bit set
|
||||
//
|
||||
// Internal events must not be sent to user channels and vice versa.
|
||||
func matches(set, event Event) bool { |
||||
return (set&omit)^(event&omit) == 0 && (set&event == event || set&fileNotifyChangeModified&event != 0) |
||||
} |
Loading…
Reference in new issue