Tweak WorkerTmpDir docs

This commit is contained in:
Berker Peksag 2016-12-22 22:00:27 +03:00
parent 9a9e3acb2c
commit 8fe132b39c
3 changed files with 17 additions and 4 deletions

View File

@ -161,6 +161,8 @@ How do I fix Django reporting an ``ImproperlyConfigured`` error?
With asynchronous workers, creating URLs with the ``reverse`` function of With asynchronous workers, creating URLs with the ``reverse`` function of
``django.core.urlresolvers`` may fail. Use ``reverse_lazy`` instead. ``django.core.urlresolvers`` may fail. Use ``reverse_lazy`` instead.
.. _blocking-os-fchmod:
How do I avoid Gunicorn excessively blocking in ``os.fchmod``? How do I avoid Gunicorn excessively blocking in ``os.fchmod``?
-------------------------------------------------------------- --------------------------------------------------------------

View File

@ -376,6 +376,14 @@ A directory to use for the worker heartbeat temporary file.
If not set, the default temporary directory will be used. If not set, the default temporary directory will be used.
.. note::
The current heartbeat system involves calling ``os.fchmod`` on
temporary file handlers and may block a worker for arbitrary time
if the directory is on a disk-backed filesystem.
See :ref:`blocking-os-fchmod` for more detailed information
and a solution for avoiding this problem.
user user
~~~~ ~~~~

View File

@ -982,10 +982,13 @@ class WorkerTmpDir(Setting):
If not set, the default temporary directory will be used. If not set, the default temporary directory will be used.
Warning: the current heartbeat system involves calling ``os.fchmod`` on .. note::
temporary file handlers and may block a worker for arbitrary time if the The current heartbeat system involves calling ``os.fchmod`` on
directory is on a disk-backed filesystem. See the :ref:`faq` for more temporary file handlers and may block a worker for arbitrary time
detailed information and a solution for avoiding this problem. if the directory is on a disk-backed filesystem.
See :ref:`blocking-os-fchmod` for more detailed information
and a solution for avoiding this problem.
""" """