fcntl.js

Author: rhodey

.gitignore

@@ -0,0 +1,5 @@
+.env*
+*\.swp
+.DS_Store
+node_modules/
+build/

README.md

@@ -0,0 +1,46 @@
+# fcntl.js
+fcntl is the POSIX standard way to do file locks. Now available to node.
+
+Tested on Linux, should work on Mac. Windows Subsystem for Linux => probably or easy to patch.
+
+```js
+const fs = require('fs')
+const fcntl = require('fcntl.js')
+
+const C = fcntl.constants()
+
+try {
+
+  const path = '/tmp/test.txt'
+  const fd = fs.openSync(path, 'w+')
+
+  // fcntlNum
+  const num1 = fcntl.fcntlNum(fd, C.F_GETFL)
+  const num2 = fcntl.fcntlNum(fd, C.F_SETFL, C.O_APPEND)
+  const num3 = fcntl.fcntlNum(fd, C.F_GETFL)
+  console.log(num1, num2, num3)
+
+  // fcntlObj
+  const out = fcntl.fcntlObj(fd, C.F_SETLK, { type: C.F_WRLCK, whence: C.SEEK_SET, start: 0, len: 0 })
+  console.log(out.rc, out)
+
+  fs.closeSync(fd)
+
+} catch (err) {
+  // errno comes from c
+  // err.message comes also from c
+  console.log(err.errno, err)
+}
+```
+
+## Docs
+The [tests](https://github.com/rhodey/fcntl.js/blob/master/test/test.js) are pretty good and show how to set and check a lock
+
+If you want docs google "fcntl linux" and you will find the info, these functions are just thin wrappers over C
+```
+npm install
+npm run test
+```
+
+## License
+MIT

binding.gyp

@@ -0,0 +1,24 @@
+{
+  "targets": [
+    {
+      "target_name": "fcntl",
+      "sources": [ "src/addon.cc" ],
+      "include_dirs": [
+        "<!@(node -p \"require('node-addon-api').include\")"
+      ],
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').gyp\")"
+      ],
+      "defines": [
+        "NAPI_DISABLE_CPP_EXCEPTIONS=0"
+      ],
+      "cflags!": [ "-fno-exceptions" ],
+      "cxxflags!": [ "-fno-exceptions" ],
+      "conditions": [
+        [ "OS=='linux' or OS=='freebsd' or OS=='darwin'", {
+          "libraries": []
+        }]
+      ]
+    }
+  ]
+}

index.js

@@ -0,0 +1,2 @@
+const load = require('node-gyp-build')
+module.exports = load(__dirname)