aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFuwn <[email protected]>2024-06-24 13:19:59 +0000
committerFuwn <[email protected]>2024-06-24 13:19:59 +0000
commitda44ad0fe870d865250cafa9936c5a813ba39f8c (patch)
tree807fd404f9b6604a42e8272483dd23daccf0794e /README.md
downloadgigi-da44ad0fe870d865250cafa9936c5a813ba39f8c.tar.xz
gigi-da44ad0fe870d865250cafa9936c5a813ba39f8c.zip
feat: initial release
Diffstat (limited to 'README.md')
-rw-r--r--README.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..868dc43
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# 👧️ Gigi
+
+> A Finger protocol server for risk takers
+
+Gigi is a Finger protocol server with few features.
+
+- Gigi can respond to Finger requests statically
+- Gigi can respond to Finger requests dynamically
+
+## Usage
+
+### Local
+
+```bash
+$ git clone [email protected]:Fuwn/gigi.git
+$ cd gigi
+$ tup
+```
+
+### Configuration
+
+Gigi is configured through the `./gigi` directory.
+
+Dynamic response mode is disabled by default in [`gigi.c`](./gigi.c)
+because it is very unsafe. If you wish to live on the edge, uncomment the
+`GIGI_DYNAMIC` macro.
+
+Dynamic mode runs any and all executables located at the path `./gigi/do`, and
+passes any arguments from the Finger request to the executable.
+
+Static mode is enabled by default. A Finger request for `test` will return the
+contents of `./gigi/test`. A Finger request of nothing will return the contents
+of `./gigi/default`.
+
+## Licence
+
+Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or
+[MIT license](LICENSE-MIT) at your option.
+
+Unless you explicitly state otherwise, any contribution intentionally submitted
+for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
+be dual licensed as above, without any additional terms or conditions.