about summary refs log tree commit homepage
diff options
context:
space:
mode:
authorEric Wong <normalperson@yhbt.net>2009-09-30 23:51:13 -0700
committerEric Wong <normalperson@yhbt.net>2009-09-30 23:53:11 -0700
commita0384e6adeb4e9d072cc2fa39a47212ee784ecf8 (patch)
tree57a6e61bfc21b84f1b32c0799f82e9d4c20a2db5
parent6befcbc2457f6d6eebd836adc08ee34e696588bd (diff)
downloadunicorn-a0384e6adeb4e9d072cc2fa39a47212ee784ecf8.tar.gz
Mostly for `unicorn_rails`, but TMPDIR is universal.
-rw-r--r--Documentation/unicorn.1.txt9
-rw-r--r--Documentation/unicorn_rails.1.txt13
2 files changed, 22 insertions, 0 deletions
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: