Sha256: c2314703d132284846ee2e230a52022d25c23b611f6293be7f0e20701ccb25f1

Contents?: true

Size: 1.2 KB

Versions: 28

Compression:

Stored size: 1.2 KB

Contents

# graceful-fs

graceful-fs functions as a drop-in replacement for the fs module,
making various improvements.

The improvements are meant to normalize behavior across different
platforms and environments, and to make filesystem access more
resilient to errors.

## Improvements over fs module

graceful-fs:

* keeps track of how many file descriptors are open, and by default
  limits this to 1024. Any further requests to open a file are put in a
  queue until new slots become available. If 1024 turns out to be too
  much, it decreases the limit further.
* fixes `lchmod` for Node versions prior to 0.6.2.
* implements `fs.lutimes` if possible. Otherwise it becomes a noop.
* ignores `EINVAL` and `EPERM` errors in `chown`, `fchown` or
  `lchown` if the user isn't root.
* makes `lchmod` and `lchown` become noops, if not available.
* retries reading a file if `read` results in EAGAIN error.

On Windows, it retries renaming a file for up to one second if `EACCESS`
or `EPERM` error occurs, likely because antivirus software has locked
the directory.

## Configuration

The maximum number of open file descriptors that graceful-fs manages may
be adjusted by setting `fs.MAX_OPEN` to a different number. The default
is 1024.

Version data entries

28 entries across 23 versions & 7 rubygems

Version Path
blackboard-3.1.9 lib/site_template/node_modules/globule/node_modules/graceful-fs/README.md
es6_tilt-0.1.2 test/dummy/app/assets/javascripts/node_modules/fsevents/node_modules/node-pre-gyp/node_modules/tar-pack/node_modules/graceful-fs/README.md
es6_tilt-0.1.1 test/dummy/app/assets/javascripts/node_modules/fsevents/node_modules/node-pre-gyp/node_modules/tar-pack/node_modules/graceful-fs/README.md
es6_tilt-0.1.0 test/dummy/app/assets/javascripts/node_modules/fsevents/node_modules/node-pre-gyp/node_modules/tar-pack/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.5 template/node_modules/gulp/node_modules/vinyl-fs/node_modules/glob-watcher/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.5 template/node_modules/gulp-sass/node_modules/node-sass/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.4 template/node_modules/gulp-sass/node_modules/node-sass/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.4 template/node_modules/gulp/node_modules/vinyl-fs/node_modules/glob-watcher/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.3 template/node_modules/gulp-sass/node_modules/node-sass/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
gulp_assets-1.0.0.pre.3 template/node_modules/gulp/node_modules/vinyl-fs/node_modules/glob-watcher/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.16 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.15 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.14 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.13 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.12 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.11 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
entangled-0.0.10 spec/dummy/public/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
trans-0.5.10 template/node_modules/gulp/node_modules/vinyl-fs/node_modules/glob-watcher/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md
trans-0.5.10 template/node_modules/grunt/node_modules/glob/node_modules/graceful-fs/README.md
trans-0.5.9 template/node_modules/gulp/node_modules/vinyl-fs/node_modules/glob-watcher/node_modules/gaze/node_modules/globule/node_modules/glob/node_modules/graceful-fs/README.md