{"id":17161791,"url":"https://github.com/catern/rsyscall","last_synced_at":"2025-04-13T13:23:44.774Z","repository":{"id":44609986,"uuid":"137142228","full_name":"catern/rsyscall","owner":"catern","description":"Process-independent interface to Linux system calls","archived":false,"fork":false,"pushed_at":"2022-07-25T13:43:07.000Z","size":11786,"stargazers_count":70,"open_issues_count":2,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-27T04:22:46.403Z","etag":null,"topics":["linux"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/catern.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-13T00:31:25.000Z","updated_at":"2025-03-06T12:12:11.000Z","dependencies_parsed_at":"2022-07-30T02:07:57.166Z","dependency_job_id":null,"html_url":"https://github.com/catern/rsyscall","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catern%2Frsyscall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catern%2Frsyscall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catern%2Frsyscall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catern%2Frsyscall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catern","download_url":"https://codeload.github.com/catern/rsyscall/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248718380,"owners_count":21150570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["linux"],"created_at":"2024-10-14T22:43:55.696Z","updated_at":"2025-04-13T13:23:44.747Z","avatar_url":"https://github.com/catern.png","language":"Python","readme":"* Summary\nrsyscall is a library which provides a interface to an ever-growing subset of Linux system calls.\nThis interface is:\n- *process-independent*: all system calls are called as methods on process objects,\n  which can refer to the \"local\" process or to other processes under our control, possibly on remote hosts.\n- *type-safe*: many Linux API constraints, which are usually left to user code to enforce,\n  are made explicit in the type system.\n- *low-level*: any action which is possible with the underlying Linux APIs,\n  is possible with rsyscall; nothing is forbidden or discouraged.\n\nFor more detail on the concepts and motivation behind rsyscall,\nread the [[file:docs/conceptual.org][conceptual introduction]].\n* Quick Start\nCheck out the docs at [[http://rsyscall.org/rsyscall][rsyscall.org]].\n\nNote that the rsyscall Python API uses some recent Python 3 features:\nasync/await and type annotations.\nIf you haven't seen those before, skim the [[file:docs/background.org][background tutorial]] first.\n* Installation\nThere's no official release of rsyscall yet.\n\nBut, if you want to try it, you can do so with Nix:\n#+begin_src bash\ngit clone https://github.com/catern/rsyscall\ncd rsyscall/python\nnix-shell\npython\n#+end_src\n\nOr you can build it by hand in a virtual environment:\n#+begin_src bash\ngit clone https://github.com/catern/rsyscall\ncd rsyscall\npython3 -m venv venv\n. venv/bin/activate\npip install -U pip\n\ncd c\nautoreconf -fvi\n./configure --prefix=$PWD/../venv\nmake install\ncd ..\nexport LD_LIBRARY_PATH=$PWD/venv/lib\nexport PKG_CONFIG_PATH=$PWD/venv/lib/pkgconfig\n\npip install -e python/\npython\n#+end_src\n* Getting started\nrsyscall is an async library that uses [[https://trio.readthedocs.io][Trio]], so the easiest way to\ntry it out is with an async Python REPL. [[https://ipython.org/][IPython]] provides a convenient\nREPL:\n#+begin_example\n$ pip install ipython\n$ ipython\nIn [1]: %autoawait trio\n\nIn [2]: import rsyscall\n\nIn [3]: t = await rsyscall.local_process.fork()\n\nIn [4]: await t.stdout.write(await t.ptr(\"Hello world!\\n\"))\nHello world!\n#+end_example\n* Discussion\nirc://irc.oftc.net/#rsyscall\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatern%2Frsyscall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatern%2Frsyscall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatern%2Frsyscall/lists"}