mirror of
https://github.com/nodejs/node.git
synced 2024-11-30 23:43:09 +01:00
753 lines
17 KiB
JavaScript
753 lines
17 KiB
JavaScript
var sys = require('sys'),
|
|
events = require('events');
|
|
|
|
var binding = process.binding('fs');
|
|
var fs = exports;
|
|
|
|
fs.Stats = binding.Stats;
|
|
|
|
fs.Stats.prototype._checkModeProperty = function (property) {
|
|
return ((this.mode & property) === property);
|
|
};
|
|
|
|
fs.Stats.prototype.isDirectory = function () {
|
|
return this._checkModeProperty(process.S_IFDIR);
|
|
};
|
|
|
|
fs.Stats.prototype.isFile = function () {
|
|
return this._checkModeProperty(process.S_IFREG);
|
|
};
|
|
|
|
fs.Stats.prototype.isBlockDevice = function () {
|
|
return this._checkModeProperty(process.S_IFBLK);
|
|
};
|
|
|
|
fs.Stats.prototype.isCharacterDevice = function () {
|
|
return this._checkModeProperty(process.S_IFCHR);
|
|
};
|
|
|
|
fs.Stats.prototype.isSymbolicLink = function () {
|
|
return this._checkModeProperty(process.S_IFLNK);
|
|
};
|
|
|
|
fs.Stats.prototype.isFIFO = function () {
|
|
return this._checkModeProperty(process.S_IFIFO);
|
|
};
|
|
|
|
fs.Stats.prototype.isSocket = function () {
|
|
return this._checkModeProperty(process.S_IFSOCK);
|
|
};
|
|
|
|
|
|
function readAll (fd, pos, content, encoding, callback) {
|
|
binding.read(fd, 4*1024, pos, encoding, function (err, chunk, bytesRead) {
|
|
if (err) {
|
|
if (callback) callback(err);
|
|
} else if (chunk) {
|
|
content += chunk;
|
|
pos += bytesRead;
|
|
readAll(fd, pos, content, encoding, callback);
|
|
} else {
|
|
binding.close(fd, function (err) {
|
|
if (callback) callback(err, content);
|
|
});
|
|
}
|
|
});
|
|
}
|
|
|
|
fs.readFile = function (path, encoding_, callback) {
|
|
var encoding = typeof(encoding_) == 'string' ? encoding_ : 'utf8';
|
|
var callback_ = arguments[arguments.length - 1];
|
|
var callback = (typeof(callback_) == 'function' ? callback_ : null);
|
|
binding.open(path, process.O_RDONLY, 0666, function (err, fd) {
|
|
if (err) {
|
|
if (callback) callback(err);
|
|
} else {
|
|
readAll(fd, 0, "", encoding, callback);
|
|
}
|
|
});
|
|
};
|
|
|
|
fs.readFileSync = function (path, encoding) {
|
|
encoding = encoding || "utf8"; // default to utf8
|
|
|
|
var fd = binding.open(path, process.O_RDONLY, 0666);
|
|
var content = '';
|
|
var pos = 0;
|
|
var r;
|
|
|
|
while ((r = binding.read(fd, 4*1024, pos, encoding)) && r[0]) {
|
|
content += r[0];
|
|
pos += r[1]
|
|
}
|
|
|
|
binding.close(fd);
|
|
|
|
return content;
|
|
};
|
|
|
|
|
|
// Used by binding.open and friends
|
|
function stringToFlags(flag) {
|
|
// Only mess with strings
|
|
if (typeof flag !== 'string') {
|
|
return flag;
|
|
}
|
|
switch (flag) {
|
|
case "r": return process.O_RDONLY;
|
|
case "r+": return process.O_RDWR;
|
|
case "w": return process.O_CREAT | process.O_TRUNC | process.O_WRONLY;
|
|
case "w+": return process.O_CREAT | process.O_TRUNC | process.O_RDWR;
|
|
case "a": return process.O_APPEND | process.O_CREAT | process.O_WRONLY;
|
|
case "a+": return process.O_APPEND | process.O_CREAT | process.O_RDWR;
|
|
default: throw new Error("Unknown file open flag: " + flag);
|
|
}
|
|
}
|
|
|
|
function noop () {}
|
|
|
|
// Yes, the follow could be easily DRYed up but I provide the explicit
|
|
// list to make the arguments clear.
|
|
|
|
fs.close = function (fd, callback) {
|
|
binding.close(fd, callback || noop);
|
|
};
|
|
|
|
fs.closeSync = function (fd) {
|
|
return binding.close(fd);
|
|
};
|
|
|
|
fs.open = function (path, flags, mode, callback) {
|
|
if (mode === undefined) { mode = 0666; }
|
|
binding.open(path, stringToFlags(flags), mode, callback || noop);
|
|
};
|
|
|
|
fs.openSync = function (path, flags, mode) {
|
|
if (mode === undefined) { mode = 0666; }
|
|
return binding.open(path, stringToFlags(flags), mode);
|
|
};
|
|
|
|
fs.read = function (fd, length, position, encoding, callback) {
|
|
encoding = encoding || "binary";
|
|
binding.read(fd, length, position, encoding, callback || noop);
|
|
};
|
|
|
|
fs.readSync = function (fd, length, position, encoding) {
|
|
encoding = encoding || "binary";
|
|
return binding.read(fd, length, position, encoding);
|
|
};
|
|
|
|
fs.write = function (fd, data, position, encoding, callback) {
|
|
encoding = encoding || "binary";
|
|
binding.write(fd, data, position, encoding, callback || noop);
|
|
};
|
|
|
|
fs.writeSync = function (fd, data, position, encoding) {
|
|
encoding = encoding || "binary";
|
|
return binding.write(fd, data, position, encoding);
|
|
};
|
|
|
|
fs.rename = function (oldPath, newPath, callback) {
|
|
binding.rename(oldPath, newPath, callback || noop);
|
|
};
|
|
|
|
fs.renameSync = function (oldPath, newPath) {
|
|
return binding.rename(oldPath, newPath);
|
|
};
|
|
|
|
fs.truncate = function (fd, len, callback) {
|
|
binding.truncate(fd, len, callback || noop);
|
|
};
|
|
|
|
fs.truncateSync = function (fd, len) {
|
|
return binding.truncate(fd, len);
|
|
};
|
|
|
|
fs.rmdir = function (path, callback) {
|
|
binding.rmdir(path, callback || noop);
|
|
};
|
|
|
|
fs.rmdirSync = function (path) {
|
|
return binding.rmdir(path);
|
|
};
|
|
|
|
fs.mkdir = function (path, mode, callback) {
|
|
binding.mkdir(path, mode, callback || noop);
|
|
};
|
|
|
|
fs.mkdirSync = function (path, mode) {
|
|
return binding.mkdir(path, mode);
|
|
};
|
|
|
|
fs.sendfile = function (outFd, inFd, inOffset, length, callback) {
|
|
binding.sendfile(outFd, inFd, inOffset, length, callback || noop);
|
|
};
|
|
|
|
fs.sendfileSync = function (outFd, inFd, inOffset, length) {
|
|
return binding.sendfile(outFd, inFd, inOffset, length);
|
|
};
|
|
|
|
fs.readdir = function (path, callback) {
|
|
binding.readdir(path, callback || noop);
|
|
};
|
|
|
|
fs.readdirSync = function (path) {
|
|
return binding.readdir(path);
|
|
};
|
|
|
|
fs.lstat = function (path, callback) {
|
|
binding.lstat(path, callback || noop);
|
|
};
|
|
|
|
fs.stat = function (path, callback) {
|
|
binding.stat(path, callback || noop);
|
|
};
|
|
|
|
fs.lstatSync = function (path) {
|
|
return binding.lstat(path);
|
|
};
|
|
|
|
fs.statSync = function (path) {
|
|
return binding.stat(path);
|
|
};
|
|
|
|
fs.readlink = function (path, callback) {
|
|
binding.readlink(path, callback || noop);
|
|
};
|
|
|
|
fs.readlinkSync = function (path) {
|
|
return binding.readlink(path);
|
|
};
|
|
|
|
fs.symlink = function (destination, path, callback) {
|
|
binding.symlink(destination, path, callback || noop);
|
|
};
|
|
|
|
fs.symlinkSync = function (destination, path) {
|
|
return binding.symlink(destination, path);
|
|
};
|
|
|
|
fs.link = function (srcpath, dstpath, callback) {
|
|
binding.link(srcpath, dstpath, callback || noop);
|
|
};
|
|
|
|
fs.linkSync = function (srcpath, dstpath) {
|
|
return binding.link(srcpath, dstpath);
|
|
};
|
|
|
|
fs.unlink = function (path, callback) {
|
|
binding.unlink(path, callback || noop);
|
|
};
|
|
|
|
fs.unlinkSync = function (path) {
|
|
return binding.unlink(path);
|
|
};
|
|
|
|
fs.chmod = function (path, mode, callback) {
|
|
binding.chmod(path, mode, callback || noop);
|
|
};
|
|
|
|
fs.chmodSync = function (path, mode) {
|
|
return binding.chmod(path, mode);
|
|
};
|
|
|
|
function writeAll (fd, data, encoding, callback) {
|
|
fs.write(fd, data, 0, encoding, function (writeErr, written) {
|
|
if (writeErr) {
|
|
fs.close(fd, function () {
|
|
if (callback) callback(writeErr);
|
|
});
|
|
} else {
|
|
if (written === data.length) {
|
|
fs.close(fd, callback);
|
|
} else {
|
|
writeAll(fd, data.slice(written), encoding, callback);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
fs.writeFile = function (path, data, encoding_, callback) {
|
|
var encoding = (typeof(encoding_) == 'string' ? encoding_ : 'utf8');
|
|
var callback_ = arguments[arguments.length - 1];
|
|
var callback = (typeof(callback_) == 'function' ? callback_ : null);
|
|
fs.open(path, 'w', 0666, function (openErr, fd) {
|
|
if (openErr) {
|
|
if (callback) callback(openErr);
|
|
} else {
|
|
writeAll(fd, data, encoding, callback);
|
|
}
|
|
});
|
|
};
|
|
|
|
fs.writeFileSync = function (path, data, encoding) {
|
|
encoding = encoding || "utf8"; // default to utf8
|
|
var fd = fs.openSync(path, "w");
|
|
var written = 0;
|
|
while (written < data.length) {
|
|
written += fs.writeSync(fd, data, 0, encoding);
|
|
data = data.slice(written);
|
|
}
|
|
fs.closeSync(fd);
|
|
};
|
|
|
|
fs.cat = function () {
|
|
throw new Error("fs.cat is deprecated. Please use fs.readFile instead.");
|
|
};
|
|
|
|
|
|
fs.catSync = function () {
|
|
throw new Error("fs.catSync is deprecated. Please use fs.readFileSync instead.");
|
|
};
|
|
|
|
// Stat Change Watchers
|
|
|
|
var statWatchers = {};
|
|
|
|
fs.watchFile = function (filename) {
|
|
var stat;
|
|
var options;
|
|
var listener;
|
|
|
|
if ("object" == typeof arguments[1]) {
|
|
options = arguments[1];
|
|
listener = arguments[2];
|
|
} else {
|
|
options = {};
|
|
listener = arguments[1];
|
|
}
|
|
|
|
if (options.persistent === undefined) options.persistent = true;
|
|
if (options.interval === undefined) options.interval = 0;
|
|
|
|
if (statWatchers[filename]) {
|
|
stat = statWatchers[filename];
|
|
} else {
|
|
statWatchers[filename] = new binding.StatWatcher();
|
|
stat = statWatchers[filename];
|
|
stat.start(filename, options.persistent, options.interval);
|
|
}
|
|
stat.addListener("change", listener);
|
|
return stat;
|
|
};
|
|
|
|
fs.unwatchFile = function (filename) {
|
|
if (statWatchers[filename]) {
|
|
stat = statWatchers[filename];
|
|
stat.stop();
|
|
statWatchers[filename] = undefined;
|
|
}
|
|
};
|
|
|
|
// Realpath
|
|
|
|
var path = require('path');
|
|
var normalize = path.normalize
|
|
normalizeArray = path.normalizeArray;
|
|
|
|
fs.realpathSync = function (path) {
|
|
var seen_links = {}, knownHards = {}, buf, i = 0, part, x, stats;
|
|
if (path.charAt(0) !== '/') {
|
|
var cwd = process.cwd().split('/');
|
|
path = cwd.concat(path.split('/'));
|
|
path = normalizeArray(path);
|
|
i = cwd.length;
|
|
buf = [].concat(cwd);
|
|
} else {
|
|
path = normalizeArray(path.split('/'));
|
|
buf = [''];
|
|
}
|
|
for (; i<path.length; i++) {
|
|
part = path.slice(0, i+1).join('/');
|
|
if (part.length !== 0) {
|
|
if (part in knownHards) {
|
|
buf.push(path[i]);
|
|
} else {
|
|
stats = fs.lstatSync(part);
|
|
if (stats.isSymbolicLink()) {
|
|
x = stats.dev.toString(32)+":"+stats.ino.toString(32);
|
|
if (x in seen_links)
|
|
throw new Error("cyclic link at "+part);
|
|
seen_links[x] = true;
|
|
part = fs.readlinkSync(part);
|
|
if (part.charAt(0) === '/') {
|
|
// absolute
|
|
path = normalizeArray(part.split('/'));
|
|
buf = [''];
|
|
i = 0;
|
|
} else {
|
|
// relative
|
|
Array.prototype.splice.apply(path, [i, 1].concat(part.split('/')));
|
|
part = normalizeArray(path);
|
|
var y = 0, L = Math.max(path.length, part.length), delta;
|
|
for (; y<L && path[y] === part[y]; y++);
|
|
if (y !== L) {
|
|
path = part;
|
|
delta = i-y;
|
|
i = y-1;
|
|
if (delta > 0) buf.splice(y, delta);
|
|
} else {
|
|
i--;
|
|
}
|
|
}
|
|
} else {
|
|
buf.push(path[i]);
|
|
knownHards[buf.join('/')] = true;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return buf.join('/');
|
|
}
|
|
|
|
|
|
fs.realpath = function (path, callback) {
|
|
var seen_links = {}, knownHards = {}, buf = [''], i = 0, part, x;
|
|
if (path.charAt(0) !== '/') {
|
|
// assumes cwd is canonical
|
|
var cwd = process.cwd().split('/');
|
|
path = cwd.concat(path.split('/'));
|
|
path = normalizeArray(path);
|
|
i = cwd.length-1;
|
|
buf = [].concat(cwd);
|
|
} else {
|
|
path = normalizeArray(path.split('/'));
|
|
}
|
|
function done(err) {
|
|
if (callback) {
|
|
if (!err) callback(err, buf.join('/'));
|
|
else callback(err);
|
|
}
|
|
}
|
|
function next() {
|
|
if (++i === path.length) return done();
|
|
part = path.slice(0, i+1).join('/');
|
|
if (part.length === 0) return next();
|
|
if (part in knownHards) {
|
|
buf.push(path[i]);
|
|
next();
|
|
} else {
|
|
fs.lstat(part, function(err, stats){
|
|
if (err) return done(err);
|
|
if (stats.isSymbolicLink()) {
|
|
x = stats.dev.toString(32)+":"+stats.ino.toString(32);
|
|
if (x in seen_links)
|
|
return done(new Error("cyclic link at "+part));
|
|
seen_links[x] = true;
|
|
fs.readlink(part, function(err, npart){
|
|
if (err) return done(err);
|
|
part = npart;
|
|
if (part.charAt(0) === '/') {
|
|
// absolute
|
|
path = normalizeArray(part.split('/'));
|
|
buf = [''];
|
|
i = 0;
|
|
} else {
|
|
// relative
|
|
Array.prototype.splice.apply(path, [i, 1].concat(part.split('/')));
|
|
part = normalizeArray(path);
|
|
var y = 0, L = Math.max(path.length, part.length), delta;
|
|
for (; y<L && path[y] === part[y]; y++);
|
|
if (y !== L) {
|
|
path = part;
|
|
delta = i-y;
|
|
i = y-1; // resolve new node if needed
|
|
if (delta > 0) buf.splice(y, delta);
|
|
}
|
|
else {
|
|
i--; // resolve new node if needed
|
|
}
|
|
}
|
|
next();
|
|
}); // binding.readlink
|
|
}
|
|
else {
|
|
buf.push(path[i]);
|
|
knownHards[buf.join('/')] = true;
|
|
next();
|
|
}
|
|
}); // binding.lstat
|
|
}
|
|
}
|
|
next();
|
|
}
|
|
|
|
fs.createReadStream = function(path, options) {
|
|
return new FileReadStream(path, options);
|
|
};
|
|
|
|
var FileReadStream = fs.FileReadStream = function(path, options) {
|
|
events.EventEmitter.call(this);
|
|
|
|
this.path = path;
|
|
this.fd = null;
|
|
this.readable = true;
|
|
this.paused = false;
|
|
|
|
this.flags = 'r';
|
|
this.encoding = 'binary';
|
|
this.mode = 0666;
|
|
this.bufferSize = 4 * 1024;
|
|
|
|
options = options || {};
|
|
for (var i in options) this[i] = options[i];
|
|
|
|
var self = this;
|
|
|
|
fs.open(this.path, this.flags, this.mode, function(err, fd) {
|
|
if (err) {
|
|
self.emit('error', err);
|
|
self.readable = false;
|
|
return;
|
|
}
|
|
|
|
self.fd = fd;
|
|
self.emit('open', fd);
|
|
self._read();
|
|
});
|
|
};
|
|
sys.inherits(FileReadStream, events.EventEmitter);
|
|
|
|
|
|
FileReadStream.prototype._read = function () {
|
|
var self = this;
|
|
if (!self.readable || self.paused) return;
|
|
|
|
fs.read(self.fd,
|
|
self.bufferSize,
|
|
undefined,
|
|
self.encoding,
|
|
function(err, data, bytesRead) {
|
|
if (err) {
|
|
self.emit('error', err);
|
|
self.readable = false;
|
|
return;
|
|
}
|
|
|
|
if (bytesRead === 0) {
|
|
self.emit('end');
|
|
self.destroy();
|
|
return;
|
|
}
|
|
|
|
// do not emit events if the stream is paused
|
|
if (self.paused) {
|
|
self.buffer = data;
|
|
return;
|
|
}
|
|
|
|
// do not emit events anymore after we declared the stream unreadable
|
|
if (!self.readable) {
|
|
return;
|
|
}
|
|
|
|
self.emit('data', data);
|
|
self._read();
|
|
});
|
|
};
|
|
|
|
|
|
var readStreamForceCloseWarning;
|
|
|
|
FileReadStream.prototype.forceClose = function (cb) {
|
|
if (!readStreamForceCloseWarning) {
|
|
readStreamForceCloseWarning = "FileReadStream.prototype.forceClose renamed to destroy()";
|
|
sys.error(readStreamForceCloseWarning);
|
|
}
|
|
return this.destroy(cb);
|
|
}
|
|
|
|
|
|
FileReadStream.prototype.destroy = function (cb) {
|
|
var self = this;
|
|
this.readable = false;
|
|
|
|
function close() {
|
|
fs.close(self.fd, function(err) {
|
|
if (err) {
|
|
if (cb) {
|
|
cb(err);
|
|
}
|
|
self.emit('error', err);
|
|
return;
|
|
}
|
|
|
|
if (cb) {
|
|
cb(null);
|
|
}
|
|
self.emit('close');
|
|
});
|
|
}
|
|
|
|
if (this.fd) {
|
|
close();
|
|
} else {
|
|
this.addListener('open', close);
|
|
}
|
|
};
|
|
|
|
|
|
FileReadStream.prototype.pause = function() {
|
|
this.paused = true;
|
|
};
|
|
|
|
|
|
FileReadStream.prototype.resume = function() {
|
|
this.paused = false;
|
|
|
|
if (this.buffer) {
|
|
this.emit('data', this.buffer);
|
|
this.buffer = null;
|
|
}
|
|
|
|
this._read();
|
|
};
|
|
|
|
|
|
|
|
fs.createWriteStream = function(path, options) {
|
|
return new FileWriteStream(path, options);
|
|
};
|
|
|
|
var FileWriteStream = fs.FileWriteStream = function(path, options) {
|
|
events.EventEmitter.call(this);
|
|
|
|
this.path = path;
|
|
this.fd = null;
|
|
this.writeable = true;
|
|
|
|
this.flags = 'w';
|
|
this.encoding = 'binary';
|
|
this.mode = 0666;
|
|
|
|
options = options || {};
|
|
for (var i in options) this[i] = options[i];
|
|
|
|
this.busy = false;
|
|
this._queue = [];
|
|
|
|
this._queue.push([fs.open, this.path, this.flags, this.mode, undefined]);
|
|
this.flush();
|
|
};
|
|
sys.inherits(FileWriteStream, events.EventEmitter);
|
|
|
|
|
|
|
|
FileWriteStream.prototype.flush = function () {
|
|
if (this.busy) return;
|
|
var self = this;
|
|
|
|
var args = this._queue.shift();
|
|
if (!args) return self.emit('drain');
|
|
|
|
this.busy = true;
|
|
|
|
var
|
|
method = args.shift(),
|
|
cb = args.pop();
|
|
|
|
var self = this;
|
|
|
|
args.push(function(err) {
|
|
self.busy = false;
|
|
|
|
if (err) {
|
|
self.writeable = false;
|
|
if (cb) {
|
|
cb(err);
|
|
}
|
|
self.emit('error', err);
|
|
return;
|
|
}
|
|
|
|
// stop flushing after close
|
|
if (method === fs.close) {
|
|
if (cb) {
|
|
cb(null);
|
|
}
|
|
self.emit('close');
|
|
return;
|
|
}
|
|
|
|
// save reference for file pointer
|
|
if (method === fs.open) {
|
|
self.fd = arguments[1];
|
|
self.emit('open', self.fd);
|
|
} else if (cb) {
|
|
// write callback
|
|
cb(null, arguments[1]);
|
|
}
|
|
|
|
self.flush();
|
|
});
|
|
|
|
// Inject the file pointer
|
|
if (method !== fs.open) {
|
|
args.unshift(self.fd);
|
|
}
|
|
|
|
method.apply(this, args);
|
|
};
|
|
|
|
|
|
FileWriteStream.prototype.write = function(data, cb) {
|
|
if (!this.writeable) {
|
|
throw new Error('stream not writeable');
|
|
}
|
|
|
|
this._queue.push([fs.write, data, undefined, this.encoding, cb]);
|
|
this.flush();
|
|
|
|
return false;
|
|
};
|
|
|
|
|
|
var writeStreamCloseWarning;
|
|
|
|
FileWriteStream.prototype.close = function (cb) {
|
|
if (!writeStreamCloseWarning) {
|
|
writeStreamCloseWarning = "FileWriteStream.prototype.close renamed to end()";
|
|
sys.error(writeStreamCloseWarning);
|
|
}
|
|
return this.end(cb);
|
|
}
|
|
|
|
|
|
FileWriteStream.prototype.end = function (cb) {
|
|
this.writeable = false;
|
|
this._queue.push([fs.close, cb]);
|
|
this.flush();
|
|
};
|
|
|
|
|
|
var writeStreamForceCloseWarning;
|
|
|
|
FileWriteStream.prototype.forceClose = function (cb) {
|
|
if (!writeStreamForceCloseWarning) {
|
|
writeStreamForceCloseWarning = "FileWriteStream.prototype.forceClose renamed to destroy()";
|
|
sys.error(writeStreamForceCloseWarning);
|
|
}
|
|
return this.destroy(cb);
|
|
}
|
|
|
|
|
|
FileWriteStream.prototype.forceClose = function (cb) {
|
|
this.writeable = false;
|
|
fs.close(self.fd, function(err) {
|
|
if (err) {
|
|
if (cb) {
|
|
cb(err);
|
|
}
|
|
|
|
self.emit('error', err);
|
|
return;
|
|
}
|
|
|
|
if (cb) {
|
|
cb(null);
|
|
}
|
|
self.emit('close');
|
|
});
|
|
};
|
|
|