bpo-36867: DOC update multiprocessing.rst (GH-13289)
authorPierre Glaser <pierreglaser@msn.com>
Mon, 13 May 2019 17:20:48 +0000 (19:20 +0200)
committerAntoine Pitrou <antoine@python.org>
Mon, 13 May 2019 17:20:48 +0000 (19:20 +0200)
Followup to bpo-36867.

Doc/library/multiprocessing.rst

index a5ecfa6cc1c70366e03b358d48e1c9fd5142e1a1..c6ffb00819c32cdfc4fd00a0ce3edd5fcee5468d 100644 (file)
@@ -131,13 +131,17 @@ to start a process.  These *start methods* are
    handles on Windows.
 
 On Unix using the *spawn* or *forkserver* start methods will also
-start a *semaphore tracker* process which tracks the unlinked named
-semaphores created by processes of the program.  When all processes
-have exited the semaphore tracker unlinks any remaining semaphores.
+start a *resource tracker* process which tracks the unlinked named
+system resources (such as named semaphores or
+:class:`~multiprocessing.shared_memory.SharedMemory` objects) created
+by processes of the program.  When all processes
+have exited the resource tracker unlinks any remaining tracked object.
 Usually there should be none, but if a process was killed by a signal
-there may be some "leaked" semaphores.  (Unlinking the named semaphores
-is a serious matter since the system allows only a limited number, and
-they will not be automatically unlinked until the next reboot.)
+there may be some "leaked" resources.  (Neither leaked semaphores nor shared
+memory segments will be automatically unlinked until the next reboot. This is
+problematic for both objects because the system allows only a limited number of
+named semaphores, and shared memory segments occupy some space in the main
+memory.)
 
 To select a start method you use the :func:`set_start_method` in
 the ``if __name__ == '__main__'`` clause of the main module.  For