From 8347b59e0699804362e488e331820a51fd53df32 Mon Sep 17 00:00:00 2001 From: bnewbold Date: Mon, 17 Oct 2016 01:18:04 -0700 Subject: small tweaks to man pages --- doc/einhyrningsins.1.ronn | 17 +++++++++++------ doc/einhyrningsinsctl.1.ronn | 7 ++++++- doc/index.txt | 3 +++ 3 files changed, 20 insertions(+), 7 deletions(-) diff --git a/doc/einhyrningsins.1.ronn b/doc/einhyrningsins.1.ronn index 3a1d1c0..d148c9e 100644 --- a/doc/einhyrningsins.1.ronn +++ b/doc/einhyrningsins.1.ronn @@ -7,7 +7,7 @@ einhyrningsins(1) -- graceful restarts for socket-based daemons ## DESCRIPTION -`Einhyrningsins` is a socket multiplexer featuring graceful restarts. It runs +`einhyrningsins` is a socket multiplexer featuring graceful restarts. It runs multiple copies of a child program, each of which are passed a shared socket (or multiple shared sockets) to bind(2) to and accept(2) connections from. Graceful, rolling restarts enable updates of the child program with zero @@ -19,6 +19,8 @@ to bind to inherited file descriptors (as indicated by environment variables). Child programs must also be able to run in parallel: for example, each copy must not try to write to the same output file without some form of locking. +## OPTIONS + * `-n`, `--number` : How many child processes to spawn. @@ -58,13 +60,13 @@ must not try to write to the same output file without some form of locking. * `-d`, `--socket-path` : Where to create the control socket (default: `/tmp/einhorn.sock`). - * `-r`, `--retries` + * `-r`, `--retries` : How many times to attempt re-spawning before giving up. ## CHILD API -`Einhyrningsins` creates children by fork(1)-ing a new process and +`einhyrningsins` creates children by fork(1)-ing a new process and execve(1)-ing to run the proces itself. For every socket specified by a `-b` flag, a socket is bound in the main `einhyrningsins` process and then explicitly flagged to be passed on to the child processes. This means the child @@ -86,21 +88,24 @@ containing the child's PID number: ## HISTORY -`Einhyrningsins` is a partially-comparible re-implementation of einhorn(1) (a +`einhyrningsins` is a partially-comparible re-implementation of einhorn(1) (a Ruby program) in Rust. Einhorn itself derived from Unicorn. -The word "Einhyrningsins" is Icelandic for unicorn. +The word "einhyrningsins" is Icelandic for unicorn. ## STATUS -`Einhyrningsins` is a for-fun hobby project. It is not feature complete, fully +`einhyrningsins` is a for-fun hobby project. It is not feature complete, fully documented, or tested. ## COPYRIGHT + Copyright 2016 Bryan Newbold + License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. ## SEE ALSO + einhorn(1), einhyrningsinsctl(1), socket(7) diff --git a/doc/einhyrningsinsctl.1.ronn b/doc/einhyrningsinsctl.1.ronn index 37e8d70..f8de6b5 100644 --- a/doc/einhyrningsinsctl.1.ronn +++ b/doc/einhyrningsinsctl.1.ronn @@ -7,12 +7,14 @@ einhyrningsinsctl(1) -- control of einhyrningsins ## DESCRIPTION -`Einhyrningsinsctl` is a shell client for einhyrningsins(1), which connects to +`einhyrningsinsctl` is a shell client for einhyrningsins(1), which connects to a control socket (UNIX domain socket) and either sends a single command (via `-e`) or acts as an interactive shell. For a list of valid commands, start in shell mode and run `help`. +## OPTIONS + * `-e`, `--execute` : Instead of starting a shell, just execute the CMD. @@ -27,10 +29,13 @@ For a list of valid commands, start in shell mode and run `help`. Prints version number ## COPYRIGHT +# Copyright 2016 Bryan Newbold + License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. ## SEE ALSO +# einhorn(1), einhyrningsins(1) diff --git a/doc/index.txt b/doc/index.txt index d2a3714..781ba1a 100644 --- a/doc/index.txt +++ b/doc/index.txt @@ -3,5 +3,8 @@ einhyrningsins(1) einhyrningsins.1 einhyrningsinsctl(1) einhyrningsinsctl.1 +# man pages +socket(7) http://man7.org/linux/man-pages/man7/socket.7.html + # External links einhorn(1) https://github.com/stripe/einhorn -- cgit v1.2.3