{"id":51572042,"url":"https://github.com/jsavyasachi/beckon-ffm","last_synced_at":"2026-07-10T20:04:14.578Z","repository":{"id":363444264,"uuid":"1261051923","full_name":"jsavyasachi/beckon-ffm","owner":"jsavyasachi","description":"Experimental FFM signal backends for beckon (Linux signalfd, macOS kqueue)","archived":false,"fork":false,"pushed_at":"2026-07-06T16:07:26.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-06T16:19:55.444Z","etag":null,"topics":["clojure","clojure-library","foreign-function-memory","kqueue","signalfd","signals"],"latest_commit_sha":null,"homepage":"https://cljdoc.org/d/net.clojars.savya/beckon-ffm","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jsavyasachi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-06T07:13:17.000Z","updated_at":"2026-07-06T16:07:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jsavyasachi/beckon-ffm","commit_stats":null,"previous_names":["jsavyasachi/beckon-ffm"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/jsavyasachi/beckon-ffm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsavyasachi%2Fbeckon-ffm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsavyasachi%2Fbeckon-ffm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsavyasachi%2Fbeckon-ffm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsavyasachi%2Fbeckon-ffm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jsavyasachi","download_url":"https://codeload.github.com/jsavyasachi/beckon-ffm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsavyasachi%2Fbeckon-ffm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35341775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clojure","clojure-library","foreign-function-memory","kqueue","signalfd","signals"],"created_at":"2026-07-10T20:04:13.714Z","updated_at":"2026-07-10T20:04:14.567Z","avatar_url":"https://github.com/jsavyasachi.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# beckon-ffm\n\n[![Clojars Project](https://img.shields.io/clojars/v/net.clojars.savya/beckon-ffm.svg)](https://clojars.org/net.clojars.savya/beckon-ffm)\n[![cljdoc](https://cljdoc.org/badge/net.clojars.savya/beckon-ffm)](https://cljdoc.org/d/net.clojars.savya/beckon-ffm/CURRENT)\n[![test](https://github.com/jsavyasachi/beckon-ffm/actions/workflows/ci.yml/badge.svg)](https://github.com/jsavyasachi/beckon-ffm/actions/workflows/ci.yml)\n\nExperimental signal backends for [beckon](https://github.com/jsavyasachi/beckon)\nbuilt entirely on the Java Foreign Function \u0026 Memory API (JDK 22+), as an\nalternative to beckon's default `sun.misc.Signal` backend:\n\n- **Linux** - `signalfd(2)`\n- **macOS / BSD** - `kqueue(2)` with `EVFILT_SIGNAL`\n\nIt exists because `sun.misc.Signal` is an internal JDK API that may eventually be\nremoved; this proves out the supported modern replacement. It is **experimental**\nand shipped separately precisely because it needs JDK 22+, while beckon's core\njar targets JDK 8.\n\n## Stack\n\n\u003ca href=\"https://clojure.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Clojure-5881D8?style=flat\u0026logo=clojure\u0026logoColor=fff\" alt=\"Clojure\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://openjdk.org/jeps/454\"\u003e\u003cimg src=\"https://img.shields.io/badge/Java%20FFM-JDK%2022%2B-ED8B00?style=flat\u0026logo=openjdk\u0026logoColor=fff\" alt=\"Java FFM\" /\u003e\u003c/a\u003e\n\n## Installation\n\nUse [`beckon`](https://github.com/jsavyasachi/beckon) by default. Add\n`beckon-ffm` only when you want the experimental Foreign Function \u0026 Memory\nbackend and can run on JDK 22+.\n\nAdd both artifacts, then opt in with a system property.\n\n```clj\n[net.clojars.savya/beckon \"0.4.1\"]\n[net.clojars.savya/beckon-ffm \"0.1.3\"]\n```\n\nRun the JVM with:\n\n```\n-Dbeckon.signal.backend=ffm --enable-native-access=ALL-UNNAMED\n```\n\nThe right native mechanism is selected automatically for the platform. The\nbeckon API is unchanged - see the\n[beckon README](https://github.com/jsavyasachi/beckon).\n\n## Capabilities and limits\n\nThe two implementations differ, which is instructive:\n\n- **Linux (`signalfd`)** reliably handles beckon's own `raise!`, but not signals\n  from *outside* the process (e.g. `kill -HUP`): a JVM starts threads before\n  beckon loads, and `signalfd` only captures a signal blocked in every thread,\n  which cannot be arranged retroactively.\n- **macOS/BSD (`kqueue`)** sets each managed signal to `SIG_IGN` - a process-wide\n  disposition - so it also observes external signals.\n\nBecause of the Linux limitation and JEP 472 native-access restrictions\n(`--enable-native-access`, denied by default from JDK 26), this is not a drop-in\nreplacement; `sun.misc.Signal` remains beckon's default.\n\n## Compatibility\n\nRequires JDK 22 or later (Foreign Function \u0026 Memory API, JEP 454). Linux and\nmacOS/BSD only. Continuously tested on JDK 25 across Ubuntu and macOS.\n\n## License\n\nCopyright © 2026 Savyasachi.\n\nA companion to [beckon](https://github.com/jsavyasachi/beckon) (originally by Jean Niklas L'orange).\nDistributed under the [Eclipse Public License 1.0](https://www.eclipse.org/legal/epl-v10.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsavyasachi%2Fbeckon-ffm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjsavyasachi%2Fbeckon-ffm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsavyasachi%2Fbeckon-ffm/lists"}