{"id":13587155,"url":"https://github.com/mre/fcat","last_synced_at":"2025-04-04T22:07:01.022Z","repository":{"id":32801290,"uuid":"143030787","full_name":"mre/fcat","owner":"mre","description":"A 3x faster implementation of cat, using splice","archived":false,"fork":false,"pushed_at":"2023-05-24T04:58:01.000Z","size":458,"stargazers_count":273,"open_issues_count":8,"forks_count":8,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-28T21:06:45.062Z","etag":null,"topics":["android","cat","linux","splice","unix"],"latest_commit_sha":null,"homepage":"https://endler.dev/2018/fastcat","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"mre"}},"created_at":"2018-07-31T15:08:31.000Z","updated_at":"2025-02-11T08:34:03.000Z","dependencies_parsed_at":"2024-01-12T23:43:08.641Z","dependency_job_id":"b39432b8-61d8-46cb-b737-1fc27f5becf2","html_url":"https://github.com/mre/fcat","commit_stats":{"total_commits":74,"total_committers":6,"mean_commits":"12.333333333333334","dds":0.5945945945945945,"last_synced_commit":"43c3dd2e63bcb13675fef8cd0f115b26eddb9322"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Ffcat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Ffcat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Ffcat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Ffcat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mre","download_url":"https://codeload.github.com/mre/fcat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247256112,"owners_count":20909240,"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":["android","cat","linux","splice","unix"],"created_at":"2024-08-01T15:06:03.201Z","updated_at":"2025-04-04T22:07:00.996Z","avatar_url":"https://github.com/mre.png","language":"Rust","readme":"# 😼 fcat\n\n![Github Actions](https://action-badges.now.sh/mre/fcat?action=test)\n\n![fastcat logo](/fastcat.svg)\n\n`fcat`, short for *fastcat*, is a `cat` implementation in Rust using Linux's `splice` syscall.  \nWith that little trick, it's **more than three times as fast as the system `cat`** in our benchmarks.  \nRead the [announcement here](https://endler.dev/2018/fastcat).\n\n:warning: **This project is currently broken on newer Linux versions (5.9+) because of some changes  \nconcerning the `splice` system call. (See [here](http://archive.lwn.net:8080/linux-kernel/202105071116.638258236E@keescook/t/) and [here](https://cdn.kernel.org/pub/linux/kernel/v5.x/ChangeLog-5.9).) This can't be fixed unless changes to the kernel get made.**\n\n## Performance\n\n```\ncat myfile | pv -r \u003e /dev/null\n[1.90GiB/s]\n```\n\n```\nfcat myfile | pv -r \u003e /dev/null\n[5.90GiB/s]\n```\n\n## Installation\n\nNote: Only works on Linux.  \n(But you can send me a pull request for other operating systems.)\n\n```\ncargo install fcat\n```\n\n## Usage\n\n```\nfcat file1 file2 file3\n```\n\n## Project goals\n\n* Be the fastest cat in town.\n* Be a drop-in replacement for (POSIX) cat.\n\n## Non-goals\n\n* Provide any additional functionality other than what `cat` provides.  \n  If you're looking for a more *beautiful* cat, check out [bat](https://github.com/sharkdp/bat).\n\n## Known issues\n\nIf you run `fcat /dev/zero \u003e\u003e myfile`, it will fail with exit code `EINVAL` because, according to the [splice manpage](http://man7.org/linux/man-pages/man2/splice.2.html): \"The target file is opened in append mode.\"\n\n## Trivia\n\n* You probably won't ever need this, but it's a fun little experiment.  \n  Still, I wonder why this is not part of e.g. GNU cat...\n* What I like the most about the project is the logo.\n\n## License\n\nfcat is licensed under either of\n\n* Apache License, Version 2.0, (LICENSE-APACHE or\n  http://www.apache.org/licenses/LICENSE-2.0)\n* MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)\n\nat your option.\n","funding_links":["https://github.com/sponsors/mre"],"categories":["Rust","Other"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmre%2Ffcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmre%2Ffcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmre%2Ffcat/lists"}