incubator/dirl
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity
dirl/README.md
Armin Friedl e8bc00ffd2 Add dirl to README
2020-08-31 21:00:05 +02:00

2.8 KiB
Raw Blame History

Build Status

This is my private tree of quark. Upstream can be found at https://git.suckless.org/quark.

Quark is a small http server.

Feature Patches

Dirl: Customizable directory listing

dirl lets you serve a fully customizable directory listing.

You can compile dirl from the dirlist branch, download a pre-compiled musl binary or even pull a pre-made docker image.

You can find an example deployment of here. It uses the default template just with a custom css. You can define your own templates too for full customization. For details see the dirl README.md.

Issues

fork: Resource temporarily unavailable

When running quark (#6606994) on my system with sudo ./quark -p 9763 -u <user> -g <group> it dies with ./quark: fork: Resource temporarily unavailable at fork().

Reason being that by default quark sets the RLIMIT_NPROC to 512 processes. When running as a non-exclusive user this limit is easily reached before even starting quark.

resource-depletion-fix contains a small forkbomb (minibomb.c) to simulate a user with > 512 processes. Compile it with make minibomb. When running the minibomb and quark with the same user quark fails.

The resource-depletion-fix branch contains a fix by setting the RLIMIT_NPROC only if the current system limit is lower than what would be set by quark. You can download the patch, or compile from the resource-depletion-fix branch.

Note that quark also has a -n parameter with which the max number of processes can be set as an alternative to this patch.

Github Users

If you are visiting this repository on GitHub, you are on a mirror of https://git.friedl.net/playground/suckless-quark. This mirror is regularily updated with my other GitHub mirrors. In contrast to other projects I do not intend to move this tree to GitHub in the future. It is meant to stay a read-only mirror.

You are welcome to pull any changes from this repository into your quark tree. If you want to contribute consider contributing directly to upstream.

If you still - for whichever reasons - want to contribute to my tree directly, feel free to send patches to dev[at]friedl[dot]net. Alternatviely you can issue a pull request on GitHub which will be cherry picked into my tree.