Skip to content

Commit f0fc4eb

Browse files
committed
Fux github and their org mode support
1 parent 4b63d6a commit f0fc4eb

2 files changed

Lines changed: 109 additions & 0 deletions

File tree

README

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2+
DISKDEVIL - DEVILISHLY FAST ISO TO USB
3+
4+
Soham S Gumaste
5+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
6+
7+
8+
Table of Contents
9+
─────────────────
10+
11+
1. Introduction
12+
.. 1. Installing
13+
2. FAQ
14+
.. 1. Doesn't DD already do this?
15+
.. 2. Can't you write a syscall wrapper in like 5 lines?
16+
.. 3. What's all this ./configure crap?
17+
.. 4. Why write it in Rust?
18+
.. 5. How can you get the safety of rust if theres a bunch of inline asm and everything is unsafe?
19+
3. LICENSE
20+
21+
22+
[https://github.com/SohamG/diskdevil/actions/workflows/tests.yml/badge.svg]
23+
24+
――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――
25+
26+
27+
[https://github.com/SohamG/diskdevil/actions/workflows/tests.yml/badge.svg]
28+
<https://github.com/SohamG/diskdevil/actions/workflows/tests.yml>
29+
30+
31+
1 Introduction
32+
══════════════
33+
34+
Diskdevil is a fancy wrapper for the `sendfile64' system call on
35+
linux, enabling super fast zero-copy file transfers. Learn more about
36+
sendfile by consulting your local `man` command.
37+
38+
39+
1.1 Installing
40+
──────────────
41+
42+
Grab a release tarball, and
43+
┌────
44+
│ ./configure && make && make install
45+
└────
46+
You will need rust target `x86_64-unknown-none'.
47+
48+
49+
2 FAQ
50+
═════
51+
52+
2.1 Doesn't DD already do this?
53+
───────────────────────────────
54+
55+
Well yes, and that is the inspiration for the name
56+
_d_​isk​_d_​evil. However, `dd' is approximately 25 centuries old and
57+
only uses read/write system calls [1]. Diskdevil does not (and
58+
probably will not) support all of the disk-destroying capabilities of
59+
`dd', but *should* be faster at what basically everyone uses `dd' for,
60+
to dump Linux ISOs to USBs.
61+
62+
63+
2.2 Can't you write a syscall wrapper in like 5 lines?
64+
──────────────────────────────────────────────────────
65+
66+
Also yes, but I wanted a challege (read: procrastinate) so I decided
67+
to make it `no_std' ie no rust standard lib apart from `core', no
68+
`libc', no nothing. Just me and some inline assembly.
69+
70+
I also wrote it _WITHOUT_ cargo for……reasons.
71+
72+
73+
2.3 What's all this ./configure crap?
74+
─────────────────────────────────────
75+
76+
What's [Cargo]?
77+
78+
79+
[Cargo] <./Cargo.toml>
80+
81+
82+
2.4 Why write it in Rust?
83+
─────────────────────────
84+
85+
The white house told me to? Safety or something.
86+
87+
88+
2.5 How can you get the safety of rust if theres a bunch of inline asm and everything is unsafe?
89+
────────────────────────────────────────────────────────────────────────────────────────────────
90+
91+
What's with all these questions?
92+
93+
――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――
94+
95+
96+
3 LICENSE
97+
═════════
98+
99+
[GPLv3] especially the "AS-IS" and "no warranty" parts.
100+
101+
102+
[GPLv3] <./LICENSE>
103+
104+
105+
106+
Footnotes
107+
─────────
108+
109+
[1] : Citation needed.
File renamed without changes.

0 commit comments

Comments
 (0)