.TH yahns 1 "" "yahns user manual" .SH NAME .PP yahns - multi-threaded, non-blocking application server for Ruby .SH SYNOPSYS .PP yahns -c CONFIG_FILE [-D|--daemonize] .SH DESCRIPTION .PP yahns(1) is the primary interface for launching a yahns application server. The configuration file is documented in yahns_config(5). yahns hosts Rack HTTP applications, but may support others in the future such as DRb. .SH SIGNALS .PP The following UNIX signals may be sent to the running yahns process. If yahns is configured for worker_processes (optional), signals should only be sent to the master process. .IP \[bu] 2 INT/TERM/QUIT - graceful shutdown. If repeated (any of these signals is sent twice), shutdown occurs immediately. .IP \[bu] 2 USR1 - reopen all logs owned by the master and all workers. This scans the Ruby ObjectSpace for all open File objects with the O_APPEND file flag and buffering disabled (IO#sync==false) .IP \[bu] 2 USR2 - reexecute the running binary. A separate QUIT should be sent to .IP \[bu] 2 HUP - if worker_processes are not used, this will reexecute the running binary and gracefully exit the running process. If worker_processes are used, this will reload config file, app, and gracefully restart all workers .IP \[bu] 2 WINCH - gracefully stops workers but keep the master running. This will only work for daemonized processes and only if the worker_processes configuration directive is used. .IP \[bu] 2 TTIN - increment the number of worker processes by one (only if the worker_processes directive is used) .IP \[bu] 2 TTOU - decrement the number of worker processes by one (only if the worker_processes directive is used) .SH ENVIRONMENT .PP yahns(1) itself requires no special environment variables. However, environment variables such as RACK_ENV and RAILS_ENV can affect Rack and Rails applications it hosts. Ruby and C library implementation-specific environment variables will also affect it. .PP yahns will update the PWD (current working directory) env if the working_directory directive is set (see yahns_config(5)). .PP LISTEN_FDS and LISTEN_PID variables are used in our emulation of sd_listen_fds(3) function. See sd_listen_fds(3) manpage for more details. .SH FILES .PP See yahns_config(5) for documentation on the configuration file format. .SH CONTACT .PP All feedback welcome via plain-text mail to .PD 0 .P .PD No subscription is necessary to post to the mailing list. .SH COPYRIGHT .PP Copyright (C) 2013-2015 all contributors License: GPLv3 or later .SH SEE ALSO .PP yahns-rackup(1), yahns_config(5), sd_listen_fds(3)