From a0384e6adeb4e9d072cc2fa39a47212ee784ecf8 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Wed, 30 Sep 2009 23:51:13 -0700 Subject: manpages: document environment variables Mostly for `unicorn_rails`, but TMPDIR is universal. --- Documentation/unicorn.1.txt | 9 +++++++++ Documentation/unicorn_rails.1.txt | 13 +++++++++++++ 2 files changed, 22 insertions(+) (limited to 'Documentation') diff --git a/Documentation/unicorn.1.txt b/Documentation/unicorn.1.txt index 205912b..3cea079 100644 --- a/Documentation/unicorn.1.txt +++ b/Documentation/unicorn.1.txt @@ -143,6 +143,15 @@ are never loaded by default. If needed, they should be individually specified in the RACKUP_FILE, some frameworks do not require them. +# ENVIRONMENT VARIABLES + +All application or library-specific environment variables (e.g. TMPDIR) +may always be set in the Unicorn CONFIG_FILE in addition to the spawning +shell. When transparently upgrading Unicorn, all environment variables +set in the old master process are inherited by the new master process. +Unicorn only uses (and will overwrite) the UNICORN_FD environment +variable internally when doing transparent upgrades. + # SEE ALSO * unicorn_rails(1) diff --git a/Documentation/unicorn_rails.1.txt b/Documentation/unicorn_rails.1.txt index f612e18..5ffb4b4 100644 --- a/Documentation/unicorn_rails.1.txt +++ b/Documentation/unicorn_rails.1.txt @@ -120,6 +120,19 @@ of the default middleware for performance. Embedded command-line options are mostly parsed for compatibility with rackup(1) but strongly discouraged. +# ENVIRONMENT VARIABLES + +The RAILS_ENV variable is set by the aforementioned \-E switch. The +RAILS_RELATIVE_URL_ROOT is set by the aforementioned \--path switch. +Either of these variables may also be set in the shell or the Unicorn +CONFIG_FILE. All application or library-specific environment variables +(e.g. TMPDIR, RAILS_ASSET_ID) may always be set in the Unicorn +CONFIG_FILE in addition to the spawning shell. When transparently +upgrading Unicorn, all environment variables set in the old master +process are inherited by the new master process. Unicorn only uses (and +will overwrite) the UNICORN_FD environment variable internally when +doing transparent upgrades. + # SIGNALS The following UNIX signals may be sent to the master process: -- cgit v1.2.3-24-ge0c7