suckless-quark/README.md

[![Build Status](https://drone.friedl.net/api/badges/playground/suckless-quark/status.svg)](https://drone.friedl.net/playground/suckless-quark)

This is my private tree of [quark](tools.suckless.org/quark/). Upstream can be
found at https://git.suckless.org/quark.

Quark is a small http server.

# Issues

## fork: Resource temporarily unavailable
When running [quark](http://tools.suckless.org/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](https://dirlist.friedl.net/suckless/quark/), 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](http://suckless.org/hacking/)
directly to [upstream](http://suckless.org/community/).

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.
Add drone build to README 2020-08-18 17:51:06 +00:00			`[![Build Status](https://drone.friedl.net/api/badges/playground/suckless-quark/status.svg)](https://drone.friedl.net/playground/suckless-quark)`

Add README 2020-08-16 21:05:04 +00:00			`This is my private tree of [quark](tools.suckless.org/quark/). Upstream can be`
			`found at https://git.suckless.org/quark.`

			`Quark is a small http server.`

			`# Issues`

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

Add patch to README 2020-08-18 19:27:53 +00:00			`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](https://dirlist.friedl.net/suckless/quark/), 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.

Add README 2020-08-16 21:05:04 +00:00			`# 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](http://suckless.org/hacking/)`
			`directly to [upstream](http://suckless.org/community/).`

			`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.`