# `multiprocessing` — Process-based parallelism

소스 코드: Lib/multiprocessing/

가용성: not Android, not iOS, not WASI.

이 모듈은 모바일 플랫폼이나 웹어셈블리 플랫폼에서 지원되지 않습니다.

## 소개

`multiprocessing` is a package that supports spawning processes using an API similar to the `threading` module. The `multiprocessing` package offers both local and remote concurrency, effectively side-stepping the Global Interpreter Lock by using subprocesses instead of threads. Due to this, the `multiprocessing` module allows the programmer to fully leverage multiple processors on a given machine. It runs on both POSIX and Windows.

The `multiprocessing` module also introduces the `Pool` object which offers a convenient means of parallelizing the execution of a function across multiple input values, distributing the input data across processes (data parallelism). The following example demonstrates the common practice of defining such functions in a module so that child processes can successfully import that module. This basic example of data parallelism using `Pool`,

    from multiprocessing import Pool

    def f(x):
        return x*x

    if __name__ == '__main__':
        with Pool(5) as p:
            print(p.map(f, [1, 2, 3]))

표준 출력으로 다음과 같은 것을 인쇄합니다

    [1, 4, 9]

The `multiprocessing` module also introduces APIs which do not have analogs in the `threading` module, like the ability to `terminate`, `interrupt` or `kill` a running process.

더 보기

`concurrent.futures.ProcessPoolExecutor` offers a higher level interface to push tasks to a background process without blocking execution of the calling process. Compared to using the `Pool` interface directly, the `concurrent.futures` API more readily allows the submission of work to the underlying process pool to be separated from waiting for the results.

### `Process` 클래스

In `multiprocessing`, processes are spawned by creating a `Process` object and then calling its `start()` method. `Process` follows the API of `threading.Thread`. A trivial example of a multiprocess program is

    from multiprocessing import Process

    def f(name):
        print('hello', name)

    if __name__ == '__main__':
        p = Process(target=f, args=('bob',))
        p.start()
        p.join()

이 과정에 참여하는 개별 프로세스의 ID를 보기 위해, 이렇게 예제를 확장합니다:

    from multiprocessing import Process
    import os

    def info(title):
        print(title)
        print('module name:', __name__)
        print('parent process:', os.getppid())
        print('process id:', os.getpid())

    def f(name):
        info('function f')
        print('hello', name)

    if __name__ == '__main__':
        info('main line')
        p = Process(target=f, args=('bob',))
        p.start()
        p.join()

`if __name__ == '__main__'` 부분이 필요한 이유에 대한 설명은 프로그래밍 지침을 보십시오.

The arguments to `Process` usually need to be unpickleable from within the child process. If you tried typing the above example directly into a REPL it could lead to an `AttributeError` in the child process trying to locate the f function in the `__main__` module.

### 컨텍스트 및 시작 방법

Depending on the platform, `multiprocessing` supports three ways to start a process. These start methods are

> spawn

>   The parent process starts a fresh Python interpreter process. The child process will only inherit those resources necessary to run the process object’s `run()` method. In particular, unnecessary file descriptors and handles from the parent process will not be inherited. Starting a process using this method is rather slow compared to using fork or forkserver.

>   Available on POSIX and Windows platforms. The default on Windows and macOS.

> fork

>   부모 프로세스는 `os.fork()` 를 사용하여 파이썬 인터프리터를 포크 합니다. 자식 프로세스는, 시작될 때, 부모 프로세스와 실질적으로 같습니다. 부모의 모든 자원이 자식 프로세스에 의해 상속됩니다. 다중 스레드 프로세스를 안전하게 포크 하기 어렵다는 점에 주의하십시오.

>   Available on POSIX systems.

>   버전 3.14에서 변경: This is no longer the default start method on any platform. Code that requires fork must explicitly specify that via `get_context()` or `set_start_method()`.

>   버전 3.12에서 변경: If Python is able to detect that your process has multiple threads, the `os.fork()` function that this start method calls internally will raise a `DeprecationWarning`. Use a different start method. See the `os.fork()` documentation for further explanation.

> forkserver

>   When the program starts and selects the forkserver start method, a server process is spawned. From then on, whenever a new process is needed, the parent process connects to the server and requests that it fork a new process. The fork server process is single threaded unless system libraries or preloaded imports spawn threads as a side-effect so it is generally safe for it to use `os.fork()`. No unnecessary resources are inherited.

>   Available on POSIX platforms which support passing file descriptors over Unix pipes such as Linux. The default on those.

>   버전 3.14에서 변경: This became the default start method on POSIX platforms.

버전 3.4에서 변경: spawn added on all POSIX platforms, and forkserver added for some POSIX platforms. Child processes no longer inherit all of the parents inheritable handles on Windows.

버전 3.8에서 변경: On macOS, the spawn start method is now the default. The fork start method should be considered unsafe as it can lead to crashes of the subprocess as macOS system libraries may start threads. See bpo-33725.

버전 3.14에서 변경: On POSIX platforms the default start method was changed from fork to forkserver to retain the performance but avoid common multithreaded process incompatibilities. See gh-84559.

On POSIX using the spawn or forkserver start methods will also start a resource tracker process which tracks the unlinked named system resources (such as named semaphores or `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” 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.)

시작 방법을 선택하려면 메인 모듈의 `if __name__ == '__main__'` 절에서 `set_start_method()`를 사용하십시오. 예를 들면:

    import multiprocessing as mp

    def foo(q):
        q.put('hello')

    if __name__ == '__main__':
        mp.set_start_method('spawn')
        q = mp.Queue()
        p = mp.Process(target=foo, args=(q,))
        p.start()
        print(q.get())
        p.join()

`set_start_method()` 는 프로그램에서 한 번만 사용되어야 합니다.

또는, `get_context()`를 사용하여 컨텍스트 객체를 얻을 수 있습니다. 컨텍스트 객체는 multiprocessing 모듈과 같은 API를 제공하므로 한 프로그램에서 여러 시작 방법을 사용할 수 있습니다.

    import multiprocessing as mp

    def foo(q):
        q.put('hello')

    if __name__ == '__main__':
        ctx = mp.get_context('spawn')
        q = ctx.Queue()
        p = ctx.Process(target=foo, args=(q,))
        p.start()
        print(q.get())
        p.join()

한 컨텍스트와 관련된 객체는 다른 컨텍스트의 프로세스와 호환되지 않을 수 있음에 주의하십시오. 특히 fork 컨텍스트를 사용하여 생성된 록은 spawn 또는 forkserver 시작 방법을 사용하여 시작된 프로세스로 전달될 수 없습니다.

Libraries using `multiprocessing` or `ProcessPoolExecutor` should be designed to allow their users to provide their own multiprocessing context. Using a specific context of your own within a library can lead to incompatibilities with the rest of the library user’s application. Always document if your library requires a specific start method.

경고

The `'spawn'` and `'forkserver'` start methods generally cannot be used with “frozen” executables (i.e., binaries produced by packages like PyInstaller and cx_Freeze) on POSIX systems. The `'fork'` start method may work if code does not use threads.

### 프로세스 간 객체 교환

`multiprocessing` supports two types of communication channel between processes:

큐

> `Queue` 클래스는 `queue.Queue` 의 클론에 가깝습니다. 예를 들면:

>     from multiprocessing import Process, Queue

>     def f(q):
>         q.put([42, None, 'hello'])

>     if __name__ == '__main__':
>         q = Queue()
>         p = Process(target=f, args=(q,))
>         p.start()
>         print(q.get())    # prints "[42, None, 'hello']"
>         p.join()

> Queues are thread and process safe. Any object put into a `multiprocessing` queue will be serialized.

파이프

> `Pipe()` 함수는 파이프로 연결된 한 쌍의 연결 객체를 돌려주는데 기본적으로 양방향(duplex)입니다. 예를 들면:

>     from multiprocessing import Process, Pipe

>     def f(conn):
>         conn.send([42, None, 'hello'])
>         conn.close()

>     if __name__ == '__main__':
>         parent_conn, child_conn = Pipe()
>         p = Process(target=f, args=(child_conn,))
>         p.start()
>         print(parent_conn.recv())   # prints "[42, None, 'hello']"
>         p.join()

> `Pipe()` 가 반환하는 두 개의 연결 객체는 파이프의 두 끝을 나타냅니다. 각 연결 객체에는 (다른 것도 있지만) `send()` 및 `recv()` 메서드가 있습니다. 두 프로세스 (또는 스레드)가 파이프의 같은 끝에서 동시에 읽거나 쓰려고 하면 파이프의 데이터가 손상될 수 있습니다. 물론 파이프의 다른 끝을 동시에 사용하는 프로세스로 인해 손상될 위험은 없습니다.

> The `send()` method serializes the object and `recv()` re-creates the object.

### 프로세스 간 동기화

`multiprocessing` contains equivalents of all the synchronization primitives from `threading`. For instance one can use a lock to ensure that only one process prints to standard output at a time:

    from multiprocessing import Process, Lock

    def f(l, i):
        l.acquire()
        try:
            print('hello world', i)
        finally:
            l.release()

    if __name__ == '__main__':
        lock = Lock()

        for num in range(10):
            Process(target=f, args=(lock, num)).start()

록을 사용하지 않으면 다른 프로세스의 출력들이 모두 섞일 수 있습니다.

### 프로세스 간 상태 공유

위에서 언급했듯이, 동시성 프로그래밍을 할 때 보통 가능한 한 공유된 상태를 사용하지 않는 것이 최선입니다. 여러 프로세스를 사용할 때 특히 그렇습니다.

However, if you really do need to use some shared data then `multiprocessing` provides a couple of ways of doing so.

공유 메모리

> 데이터는 `Value` 또는 `Array`를 사용하여 공유 메모리 맵에 저장 될 수 있습니다. 예를 들어, 다음 코드는

>     from multiprocessing import Process, Value, Array

>     def f(n, a):
>         n.value = 3.1415927
>         for i in range(len(a)):
>             a[i] = -a[i]

>     if __name__ == '__main__':
>         num = Value('d', 0.0)
>         arr = Array('i', range(10))

>         p = Process(target=f, args=(num, arr))
>         p.start()
>         p.join()

>         print(num.value)
>         print(arr[:])

> 를 인쇄할 것입니다

>     3.1415927
>     [0, -1, -2, -3, -4, -5, -6, -7, -8, -9]

> `num` 과 `arr` 을 만들 때 사용되는 `'d'` 와 `'i'` 인자는 `array` 모듈에서 사용되는 종류의 타입 코드입니다: `'d'` 는 배정밀도 부동 소수점을 나타내고, `'i'` 는 부호 있는 정수를 나타냅니다. 이러한 공유 객체는 프로세스 및 스레드에 안전합니다.

> 공유 메모리를 더 유연하게 사용하려면, 공유 메모리에 할당된 임의의 ctypes 객체 생성을 지원하는 `multiprocessing.sharedctypes` 모듈을 사용할 수 있습니다.

서버 프로세스

> `Manager()` 가 반환한 관리자 객체는 파이썬 객체를 유지하고 다른 프로세스가 프락시를 사용하여 이 객체를 조작할 수 있게 하는 서버 프로세스를 제어합니다.

> A manager returned by `Manager()` will support types `list`, `dict`, `set`, `Namespace`, `Lock`, `RLock`, `Semaphore`, `BoundedSemaphore`, `Condition`, `Event`, `Barrier`, `Queue`, `Value` and `Array`. For example,

>     from multiprocessing import Process, Manager

>     def f(d, l, s):
>         d[1] = '1'
>         d['2'] = 2
>         d[0.25] = None
>         l.reverse()
>         s.add('a')
>         s.add('b')

>     if __name__ == '__main__':
>         with Manager() as manager:
>             d = manager.dict()
>             l = manager.list(range(10))
>             s = manager.set()

>             p = Process(target=f, args=(d, l, s))
>             p.start()
>             p.join()

>             print(d)
>             print(l)
>             print(s)

> 를 인쇄할 것입니다

>     {0.25: None, 1: '1', '2': 2}
>     [9, 8, 7, 6, 5, 4, 3, 2, 1, 0]
>     {'a', 'b'}

> 서버 프로세스 관리자는 임의의 객체 형을 지원하도록 만들 수 있으므로 공유 메모리 객체를 사용하는 것보다 융통성이 있습니다. 또한, 단일 관리자를 네트워크를 통해 서로 다른 컴퓨터의 프로세스에서 공유 할 수 있습니다. 그러나 공유 메모리를 사용할 때보다 느립니다.

### 작업자 풀 사용

`Pool` 클래스는 작업자 프로세스 풀을 나타냅니다. 여기에는 몇 가지 다른 방법으로 작업을 작업자 프로세스로 넘길 수 있는 메서드가 있습니다.

예를 들면:

    from multiprocessing import Pool, TimeoutError
    import time
    import os

    def f(x):
        return x*x

    if __name__ == '__main__':
        # start 4 worker processes
        with Pool(processes=4) as pool:

            # print "[0, 1, 4,..., 81]"
            print(pool.map(f, range(10)))

            # print same numbers in arbitrary order
            for i in pool.imap_unordered(f, range(10)):
                print(i)

            # evaluate "f(20)" asynchronously
            res = pool.apply_async(f, (20,))      # runs in *only* one process
            print(res.get(timeout=1))             # prints "400"

            # evaluate "os.getpid()" asynchronously
            res = pool.apply_async(os.getpid, ()) # runs in *only* one process
            print(res.get(timeout=1))             # prints the PID of that process

            # launching multiple evaluations asynchronously *may* use more processes
            multiple_results = [pool.apply_async(os.getpid, ()) for i in range(4)]
            print([res.get(timeout=1) for res in multiple_results])

            # make a single worker sleep for 10 seconds
            res = pool.apply_async(time.sleep, (10,))
            try:
                print(res.get(timeout=1))
            except TimeoutError:
                print("We lacked patience and got a multiprocessing.TimeoutError")

            print("For the moment, the pool remains available for more work")

        # exiting the 'with'-block has stopped the pool
        print("Now the pool is closed and no longer available")

풀의 메서드는 풀을 만든 프로세스에서만 사용되어야 함에 유의하세요.

참고

이 패키지 내의 기능을 사용하려면 `__main__` 모듈을 자식이 임포트 할 수 있어야 합니다. 이것은 프로그래밍 지침에서 다루지만, 여기에서 지적할 가치가 있습니다. 이것은 몇몇 예제, 가령 `multiprocessing.pool.Pool` 예제가 대화형 인터프리터에서 동작하지 않음을 의미합니다. 예를 들면:

    >>> from multiprocessing import Pool
    >>> p = Pool(5)
    >>> def f(x):
    ...     return x*x
    ...
    >>> with p:
    ...     p.map(f, [1,2,3])
    Process PoolWorker-1:
    Process PoolWorker-2:
    Process PoolWorker-3:
    Traceback (most recent call last):
    Traceback (most recent call last):
    Traceback (most recent call last):
    AttributeError: Can't get attribute 'f' on <module '__main__' (<class '_frozen_importlib.BuiltinImporter'>)>
    AttributeError: Can't get attribute 'f' on <module '__main__' (<class '_frozen_importlib.BuiltinImporter'>)>
    AttributeError: Can't get attribute 'f' on <module '__main__' (<class '_frozen_importlib.BuiltinImporter'>)>

(이것을 시도해 보면 실제로 세 개의 전체 트레이스백이 어느 정도 임의로 번갈아 출력됩니다. 그런 다음 부모 프로세스를 중지시켜야 할 수도 있습니다.)

## 레퍼런스

The `multiprocessing` package mostly replicates the API of the `threading` module.

### Global start method

Python supports several ways to create and initialize a process. The global start method sets the default mechanism for creating a process.

Several multiprocessing functions and methods that may also instantiate certain objects will implicitly set the global start method to the system’s default, if it hasn’t been set already. The global start method can only be set once. If you need to change the start method from the system default, you must proactively set the global start method before calling functions or methods, or creating these objects.

### `Process`와 예외

class multiprocessing.Process(group=None, target=None, name=None, args=(), kwargs={}, *, daemon=None)

  프로세스 객체는 별도의 프로세스에서 실행되는 작업을 나타냅니다. `Process` 클래스는 `threading.Thread` 의 모든 메서드와 같은 메서드를 갖습니다.

  The constructor should always be called with keyword arguments. group should always be `None`; it exists solely for compatibility with `threading.Thread`. target is the callable object to be invoked by the `run()` method. It defaults to `None`, meaning nothing is called. name is the process name (see `name` for more details). args is the argument tuple for the target invocation. kwargs is a dictionary of keyword arguments for the target invocation. If provided, the keyword-only daemon argument sets the process `daemon` flag to `True` or `False`. If `None` (the default), this flag will be inherited from the creating process.

  By default, no arguments are passed to target. The args argument, which defaults to `()`, can be used to specify a list or tuple of the arguments to pass to target.

  If a subclass overrides the constructor, it must make sure it invokes the base class constructor (`super().__init__()`) before doing anything else to the process.

  참고

  In general, all arguments to `Process` must be picklable. This is frequently observed when trying to create a `Process` or use a `concurrent.futures.ProcessPoolExecutor` from a REPL with a locally defined target function.

  Passing a callable object defined in the current REPL session causes the child process to die via an uncaught `AttributeError` exception when starting as target must have been defined within an importable module in order to be loaded during unpickling.

  Example of this uncatchable error from the child:

      >>> import multiprocessing as mp
      >>> def knigit():
      ...     print("Ni!")
      ...
      >>> process = mp.Process(target=knigit)
      >>> process.start()
      >>> Traceback (most recent call last):
        File ".../multiprocessing/spawn.py", line ..., in spawn_main
        File ".../multiprocessing/spawn.py", line ..., in _main
      AttributeError: module '__main__' has no attribute 'knigit'
      >>> process
      <SpawnProcess name='SpawnProcess-1' pid=379473 parent=378707 stopped exitcode=1>

  See spawn 과 forkserver 시작 방법. While this restriction is not true if using the `"fork"` start method, as of Python `3.14` that is no longer the default on any platform. See 컨텍스트 및 시작 방법. See also gh-132898.

  버전 3.3에서 변경: Added the daemon parameter.

  run()

    프로세스의 활동을 나타내는 메서드.

    서브 클래스에서 이 메서드를 재정의할 수 있습니다. 표준 `run()` 메서드는 객체의 생성자에 target 인자로 전달된 콜러블 객체를 호출하는데 (있다면) args 와 kwargs 인자를 각각 위치 인자와 키워드 인자로 사용합니다.

    Using a list or tuple as the args argument passed to `Process` achieves the same effect.

    Example:

        >>> from multiprocessing import Process
        >>> p = Process(target=print, args=[1])
        >>> p.run()
        1
        >>> p = Process(target=print, args=(1,))
        >>> p.run()
        1

  start()

    프로세스의 활동을 시작합니다.

    이것은 프로세스 객체 당 최대 한 번 호출되어야 합니다. 객체의 `run()` 메서드가 별도의 프로세스에서 호출되도록 합니다.

  join([timeout])

    선택적 인자 timeout 이 `None` (기본값) 인 경우, 메서드는 `join()` 메서드가 호출된 프로세스가 종료될 때까지 블록 됩니다. timeout 이 양수면 최대 timeout 초 동안 블록 됩니다. 이 메서드는 프로세스가 종료되거나 메서드가 시간 초과 되면 `None` 을 돌려줌에 주의해야 합니다. 프로세스의 `exitcode` 를 검사하여 종료되었는지 확인하십시오.

    프로세스는 여러 번 조인할 수 있습니다.

    교착 상태를 유발할 수 있으므로 프로세스는 자신을 조인할 수 없습니다. 프로세스가 시작되기 전에 프로세스에 조인하려고 하면 에러가 발생합니다.

  name

    프로세스의 이름. 이름은 식별 목적으로만 사용되는 문자열입니다. 다른 의미는 없습니다. 여러 프로세스에 같은 이름이 주어질 수 있습니다.

    초기 이름은 생성자에 의해 설정됩니다. 명시적 이름이 생성자에 제공되지 않으면, ‘Process-N1:N2:…:Nk’ 형식의 이름이 만들어지는데, 각각의 Nk 는 부모의 N 번째 자식입니다.

  is_alive()

    프로세스가 살아있는지 아닌지를 반환합니다.

    대략, 프로세스 객체는 `start()` 메서드가 반환하는 순간부터 자식 프로세스가 종료될 때까지 살아있습니다.

  daemon

    프로세스의 데몬 플래그, 논리값. `start()` 가 호출되기 전에 설정되어야 합니다.

    초깃값은 생성 프로세스에서 상속됩니다.

    프로세스가 종료할 때, 모든 데몬 자식 프로세스를 강제 종료시키려고(terminate) 시도합니다.

    데몬 프로세스는 하위 프로세스를 만들 수 없음에 유의하십시오. 그렇지 않으면 부모 프로세스가 종료될 때 데몬 프로세스가 강제 종료되어, 데몬 프로세스가 자식 프로세스를 고아로 남기게 됩니다. 또한, 이들은 유닉스 데몬이나 서비스가 아닙니다, 데몬이 아닌 프로세스들이 종료되면 강제 종료되는 (그리고 조인되지 않는) 일반 프로세스입니다.

  `threading.Thread` API 외에도 `Process` 객체는 다음 어트리뷰트와 메서드도 지원합니다 :

  pid

    프로세스 ID를 돌려줍니다. 프로세스가 스폰 되기 전에는 `None` 입니다.

  exitcode

    The child’s exit code. This will be `None` if the process has not yet terminated.

    If the child’s `run()` method returned normally, the exit code will be 0. If it terminated via `sys.exit()` with an integer argument N, the exit code will be N.

    If the child terminated due to an exception not caught within `run()`, the exit code will be 1. If it was terminated by signal N, the exit code will be the negative value -N.

  authkey

    프로세스의 인증 키 (바이트열) 입니다.

    When `multiprocessing` is initialized the main process is assigned a random string using `os.urandom()`.

    `Process` 객체가 생성될 때, 부모 프로세스의 인증 키를 상속받습니다. `authkey` 를 다른 바이트열로 설정하여 변경할 수 있습니다.

    인증 키를 참조하세요.

  sentinel

    프로세스가 끝나면 “준비(ready)” 될 시스템 객체의 숫자 핸들.

    You can use this value if you want to wait on several events at once using `multiprocessing.connection.wait()`. Otherwise calling `join()` is simpler.

    On Windows, this is an OS handle usable with the `WaitForSingleObject` and `WaitForMultipleObjects` family of API calls. On POSIX, this is a file descriptor usable with primitives from the `select` module.

    Added in version 3.3.

  interrupt()

    Terminate the process. Works on POSIX using the `SIGINT` signal. Behavior on Windows is undefined.

    By default, this terminates the child process by raising `KeyboardInterrupt`. This behavior can be altered by setting the respective signal handler in the child process `signal.signal()` for `SIGINT`.

    Note: if the child process catches and discards `KeyboardInterrupt`, the process will not be terminated.

    Note: the default behavior will also set `exitcode` to `1` as if an uncaught exception was raised in the child process. To have a different `exitcode` you may simply catch `KeyboardInterrupt` and call `exit(your_code)`.

    Added in version 3.14.

  terminate()

    Terminate the process. On POSIX this is done using the `SIGTERM` signal; on Windows `TerminateProcess()` is used. Note that exit handlers and finally clauses, etc., will not be executed.

    프로세스의 자손 프로세스들은 강제 종료되지 않을 것입니다 – 단순히 고아가 될 것입니다.

    경고

    연결된 프로세스가 파이프 또는 큐를 사용할 때 이 메서드를 사용하면, 파이프 또는 큐가 손상되어 다른 프로세스에서 사용할 수 없게 될 수 있습니다. 마찬가지로, 프로세스가 록이나 세마포어 등을 획득한 경우 강제 종료하면 다른 프로세스가 교착 상태가 될 수 있습니다.

  kill()

    Same as `terminate()` but using the `SIGKILL` signal on POSIX.

    Added in version 3.7.

  close()

    `Process` 객체를 닫아, 그것과 관련된 모든 자원을 해제합니다. 하부 프로세스가 여전히 실행 중이면 `ValueError` 가 발생합니다. 일단 `close()` 가 성공적으로 반환되면, `Process` 객체의 다른 대부분의 메서드와 어트리뷰트는 `ValueError` 를 발생시킵니다.

    Added in version 3.7.

  `start()`, `join()`, `is_alive()`, `terminate()` 및 `exitcode` 메서드는 프로세스 객체를 생성한 프로세스에 의해서만 호출되어야 합니다.

  `Process` 의 몇몇 메서드를 사용하는 예제:

      >>> import multiprocessing, time, signal
      >>> mp_context = multiprocessing.get_context('spawn')
      >>> p = mp_context.Process(target=time.sleep, args=(1000,))
      >>> print(p, p.is_alive())
      <...Process ... initial> False
      >>> p.start()
      >>> print(p, p.is_alive())
      <...Process ... started> True
      >>> p.terminate()
      >>> time.sleep(0.1)
      >>> print(p, p.is_alive())
      <...Process ... stopped exitcode=-SIGTERM> False
      >>> p.exitcode == -signal.SIGTERM
      True

exception multiprocessing.ProcessError

  The base class of all `multiprocessing` exceptions.

exception multiprocessing.BufferTooShort

  Exception raised by `Connection.recv_bytes_into()` when the supplied buffer object is too small for the message read.

  `e` 가 `BufferTooShort` 의 인스턴스라면, `e.args[0]` 는 메시지를 바이트열로 줍니다.

exception multiprocessing.AuthenticationError

  인증 에러가 일어날 때 발생합니다.

exception multiprocessing.TimeoutError

  시간제한이 초과하였을 때 시간제한을 건 메서드에 의해 발생합니다.

### 파이프와 큐

여러 프로세스를 사용할 때, 일반적으로 프로세스 간 통신을 위해 메시지 전달을 사용하고 록과 같은 동기화 프리미티브 사용을 피합니다.

메시지를 전달하기 위해 `Pipe()` (두 프로세스 간의 연결) 또는 큐(여러 생산자와 소비자를 허용합니다)를 사용할 수 있습니다.

`Queue`, `SimpleQueue` 그리고 `JoinableQueue` 형은, 표준 라이브러리의 `queue.Queue` 클래스에 따라 모델링 된, 다중 생산자, 다중 소비자 FIFO 큐입니다. 이것들은 파이썬 2.5의 `queue.Queue` 클래스에서 도입된 `task_done()`과 `join()` 메서드가 `Queue` 에 없다는 점에서 다릅니다.

`JoinableQueue`를 사용하면, 큐에서 제거된 작업마다 `JoinableQueue.task_done()`을 호출해야 합니다. 그렇지 않으면 완료되지 않은 작업의 수를 세는 데 사용되는 세마포어가 결국 오버플로 되어 예외를 일으킵니다.

One difference from other Python queue implementations, is that `multiprocessing` queues serializes all objects that are put into them using `pickle`. The object returned by the get method is a re-created object that does not share memory with the original object.

관리자 객체를 사용하여 공유 큐를 생성할 수도 있습니다 – 관리자를 보세요.

참고

`multiprocessing` uses the usual `queue.Empty` and `queue.Full` exceptions to signal a timeout. They are not available in the `multiprocessing` namespace so you need to import them from `queue`.

참고

객체를 큐에 넣으면, 객체는 피클 되고 배경 스레드가 나중에 피클 된 데이터를 하부 파이프로 플러시 합니다. 이것은 다소 의외의 결과로 이어지지만, 실제적인 어려움을 일으키지는 않아야 합니다 – 이것이 여러분을 정말로 신경 쓰이게 한다면, 대신 관리자 로 만든 큐를 사용할 수 있습니다.

1. 빈 큐에 객체를 넣은 후에, `empty()` 메서드가 `False`를 반환하고 `get_nowait()`가 `queue.Empty` 를 일으키지 않고 반환할 수 있기 전까지 극히 작은 지연이 있을 수 있습니다.

2. 여러 프로세스가 객체를 큐에 넣는 경우, 반대편에서 객체가 다른 순서로 수신될 수 있습니다. 그러나, 같은 프로세스에 의해 큐에 들어간 객체들은 항상 상대적인 순서가 유지됩니다.

경고

`Queue`를 사용하려고 하는 동안 `Process.terminate()` 또는 `os.kill()` 을 사용하여 프로세스를 죽이면, 큐의 데이터가 손상될 수 있습니다. 이로 인해 나중에 다른 프로세스가 큐를 사용하려고 할 때 예외가 발생할 수 있습니다.

경고

위에서 언급했듯이, 자식 프로세스가 항목을 큐에 넣었을 때 (그리고 `JoinableQueue.cancel_join_thread` 를 사용하지 않았다면), 버퍼링 된 모든 항목이 파이프로 플러시 될 때까지 해당 프로세스가 종료되지 않습니다.

이것은, 여러분이 그 자식 프로세스를 조인하려고 하면, 큐에 넣은 모든 항목을 소진하지 않는 한 교착 상태가 발생할 수 있다는 뜻입니다. 마찬가지로, 그 자식 프로세스가 데몬이 아니면 부모 프로세스가 종료 시점에 데몬이 아닌 모든 자식을 조인하려고 할 때 정지될 수 있습니다.

관리자를 사용하여 생성된 큐에는 이 문제가 없습니다. 프로그래밍 지침을 참조하세요.

프로세스 간 통신을 위해 큐를 사용하는 예는 예제을 참조하십시오.

multiprocessing.Pipe(duplex=True)

  파이프의 끝을 나타내는 `Connection` 객체 쌍 `(conn1, conn2)` 를 반환합니다.

  duplex 가 `True` (기본값) 면 파이프는 양방향입니다. duplex 가 `False` 인 경우 파이프는 단방향입니다: `conn1` 은 메시지를 받는 데에만 사용할 수 있고, `conn2` 는 메시지를 보낼 때만 사용할 수 있습니다.

  The `send()` method serializes the object using `pickle` and the `recv()` re-creates the object.

class multiprocessing.Queue([maxsize])

  파이프와 몇 개의 록/세마포어를 사용하여 구현된 프로세스 공유 큐를 반환합니다. 프로세스가 처음으로 항목을 큐에 넣으면 버퍼에서 파이프로 객체를 전송하는 피더 스레드가 시작됩니다.

  Instantiating this class may set the global start method. See Global start method for more details.

  제한 시간 초과를 알리기 위해 표준 라이브러리의 `queue` 모듈에서 정의되는 `queue.Empty` 와 `queue.Full` 예외를 일으킵니다.

  `Queue` 는 `task_done()`과 `join()` 을 제외한 `queue.Queue` 의 모든 메서드를 구현합니다.

  qsize()

    큐의 대략의 크기를 돌려줍니다. 다중 스레딩/다중 프로세싱 특성을 타기 때문에 이 숫자는 신뢰할 수 없습니다.

    Note that this may raise `NotImplementedError` on platforms like macOS where `sem_getvalue()` is not implemented.

  empty()

    큐가 비어 있다면 `True` 를, 그렇지 않으면 `False` 를 반환합니다. 다중 스레딩/다중 프로세싱 특성을 타기 때문에 신뢰할 수 없습니다.

    May raise an `OSError` on closed queues. (not guaranteed)

  full()

    큐가 가득 차면 `True` 를, 그렇지 않으면 `False` 를 반환합니다. 다중 스레딩/다중 프로세싱 특성을 타기 때문에 신뢰할 수 없습니다.

  put(obj[, block[, timeout]])

    obj를 큐에 넣습니다. 선택적 인자 block 이 `True` (기본값)이고 timeout 이 `None` (기본값) 이면, 빈 슬롯이 생길 때까지 필요한 경우 블록합니다. timeout 이 양수인 경우, 최대 timeout 초만큼 블록하고 그 시간 내에 사용 가능 슬롯이 생기지 않으면 `queue.Full` 예외를 발생시킵니다. 그렇지 않으면 (block 이 `False`) 빈 슬롯을 즉시 사용할 수 있으면 큐에 항목을 넣고, 그렇지 않으면 `queue.Full` 예외를 발생시킵니다 (이 경우 timeout 은 무시됩니다).

    버전 3.8에서 변경: 큐가 닫혔으면, `AssertionError` 대신 `ValueError`가 발생합니다.

  put_nowait(obj)

    `put(obj, False)` 와 같습니다.

  get([block[, timeout]])

    큐에서 항목을 제거하고 반환합니다. 선택적 인자 block 이 `True` (기본값)이고 timeout 이 `None` (기본값) 이면, 항목이 들어올 때까지 필요한 경우 블록합니다. timeout 이 양수인 경우, 최대 timeout 초만큼 블록하고 그 시간 내에 항목이 들어오지 않으면 `queue.Empty` 예외를 발생시킵니다. 그렇지 않으면 (block이 `False`) 즉시 사용할 수 있는 항목이 있으면 반환하고, 그렇지 않으면 `queue.Empty` 예외를 발생시킵니다 (이 경우 timeout 은 무시됩니다).

    버전 3.8에서 변경: 큐가 닫혔으면, `OSError` 대신 `ValueError`가 발생합니다.

  get_nowait()

    `get(False)` 와 같습니다.

  `multiprocessing.Queue` 에는 `queue.Queue` 에서 찾을 수 없는 몇 가지 추가 메서드가 있습니다. 일반적으로 이러한 메서드는 대부분 코드에서 필요하지 않습니다:

  close()

    큐를 닫습니다: 내부 자원을 해제합니다.

    A queue must not be used anymore after it is closed. For example, `get()`, `put()` and `empty()` methods must no longer be called.

    The background thread will quit once it has flushed all buffered data to the pipe. This is called automatically when the queue is garbage collected.

  join_thread()

    배경 스레드에 조인합니다. `close()` 가 호출된 후에만 사용할 수 있습니다. 배경 스레드가 종료될 때까지 블록해서 버퍼의 모든 데이터가 파이프로 플러시 되었음을 보증합니다.

    기본적으로 프로세스가 큐를 만든 주체가 아니면 종료할 때 큐의 배경 스레드를 조인하려고 합니다. 프로세스는 `cancel_join_thread()`를 호출하여 `join_thread()` 가 아무것도 하지 않게 할 수 있습니다.

  cancel_join_thread()

    `join_thread()` 의 블록을 방지합니다. 특히, 프로세스가 종료할 때 배경 스레드를 자동으로 조인하는 것을 막습니다 – `join_thread()`를 보십시오.

    A better name for this method might be `allow_exit_without_flush()`. It is likely to cause enqueued data to be lost, and you almost certainly will not need to use it. It is really only there if you need the current process to exit immediately without waiting to flush enqueued data to the underlying pipe, and you don’t care about lost data.

  참고

  이 클래스의 기능은 호스트 운영 체제의 작동하는 공유 세마포어 구현을 요구합니다. 그런 것이 없으면, 클래스의 기능이 비활성화되고, `Queue` 의 인스턴스를 만들려고 하면 `ImportError` 를 일으킵니다. 자세한 내용은 bpo-3770을 참조하십시오. 아래에 나열된 특수 큐 형들도 마찬가지입니다.

class multiprocessing.SimpleQueue

  이것은 단순화된 `Queue` 형으로, 록이 걸린 `Pipe` 에 매우 가깝습니다.

  Instantiating this class may set the global start method. See Global start method for more details.

  close()

    큐를 닫습니다: 내부 자원을 해제합니다.

    큐를 닫은 후에는 더는 사용해서는 안 됩니다. 예를 들어, `get()`, `put()` 및 `empty()` 메서드가 더는 호출되지 않아야 합니다.

    Added in version 3.9.

  empty()

    큐가 비어 있다면 `True` 를, 그렇지 않으면 `False` 를 반환합니다.

    Always raises an `OSError` if the SimpleQueue is closed.

  get()

    큐에서 항목을 제거하고 반환합니다.

  put(item)

    item 을 큐에 넣습니다.

class multiprocessing.JoinableQueue([maxsize])

  `Queue` 서브 클래스 `JoinableQueue` 는 추가로 `task_done()`과 `join()` 메서드를 가진 큐입니다.

  Instantiating this class may set the global start method. See Global start method for more details.

  task_done()

    앞서 큐에 넣은 작업이 완료되었음을 나타냅니다. 큐 소비자가 사용합니다. 작업을 가져오는데 사용된 각 `get()` 마다, 뒤따르는 `task_done()` 호출은 작업에 대한 처리가 완료되었음을 큐에 알립니다.

    만약 `join()` 이 현재 블록하고 있다면, 모든 항목이 처리될 때 재개될 것입니다 (`put()` 으로 큐에 넣은 모든 항목에 대해 `task_done()` 호출을 수신했다는 뜻입니다).

    큐에 있는 항목보다 많이 호출되면 `ValueError` 를 발생시킵니다.

  join()

    큐의 모든 항목을 가져가서 처리할 때까지 블록합니다.

    항목이 큐에 추가될 때마다 완료되지 않은 작업의 수는 올라갑니다. 소비자가 그 항목을 꺼냈고 그에 대한 모든 작업을 완료했음을 알리기 위해 `task_done()`을 호출할 때마다 숫자는 줄어듭니다. 완료되지 않은 작업의 수가 0으로 떨어지면 `join()` 이 블록으로부터 풀려납니다.

### 잡동사니

multiprocessing.active_children()

  현재 프로세스의 모든 살아있는 자식 리스트를 반환합니다.

  이것을 호출하면 이미 완료된 프로세스에 “조인” 하는 부작용이 있습니다.

multiprocessing.cpu_count()

  시스템의 CPU 수를 반환합니다.

  This number is not equivalent to the number of CPUs the current process can use. The number of usable CPUs can be obtained with `os.process_cpu_count()` (or `len(os.sched_getaffinity(0))`).

  When the number of CPUs cannot be determined a `NotImplementedError` is raised.

  더 보기

  `os.cpu_count()` `os.process_cpu_count()`

  버전 3.13에서 변경: The return value can also be overridden using the `-X cpu_count` flag or `PYTHON_CPU_COUNT` as this is merely a wrapper around the `os` cpu count APIs.

multiprocessing.current_process()

  현재 프로세스에 해당하는 `Process` 객체를 반환합니다.

  `threading.current_thread()`와 유사한 기능을 제공합니다.

multiprocessing.parent_process()

  `current_process()`의 부모 프로세스에 해당하는 `Process` 객체를 반환합니다. 메인 프로세스에서, `parent_process`는 `None`입니다.

  Added in version 3.8.

multiprocessing.freeze_support()

  Add support for when a program which uses `multiprocessing` has been frozen to produce an executable. (Has been tested with py2exe, PyInstaller and cx_Freeze.)

  메인 모듈의 `if __name__ == '__main__'` 줄 바로 뒤에서 이 함수를 호출해야 합니다. 예를 들면:

      from multiprocessing import Process, freeze_support

      def f():
          print('hello world!')

      if __name__ == '__main__':
          freeze_support()
          Process(target=f).start()

  `freeze_support()` 줄이 생략된 경우 고정된 실행 파일을 실행하려고 하면 `RuntimeError` 가 발생합니다.

  Calling `freeze_support()` has no effect when the start method is not spawn. In addition, if the module is being run normally by the Python interpreter (the program has not been frozen), then `freeze_support()` has no effect.

multiprocessing.get_all_start_methods()

  Returns a list of the supported start methods, the first of which is the default. The possible start methods are `'fork'`, `'spawn'` and `'forkserver'`. Not all platforms support all methods. See 컨텍스트 및 시작 방법.

  Added in version 3.4.

multiprocessing.get_context(method=None)

  Return a context object which has the same attributes as the `multiprocessing` module.

  If method is `None` then the default context is returned. Note that if the global start method has not been set, this will set it to the system default See Global start method for more details. Otherwise method should be `'fork'`, `'spawn'`, `'forkserver'`. `ValueError` is raised if the specified start method is not available. See 컨텍스트 및 시작 방법.

  Added in version 3.4.

multiprocessing.get_start_method(allow_none=False)

  프로세스를 기동하기 위해서 사용되는 시작 방법의 이름을 돌려줍니다.

  If the global start method is not set and allow_none is `False`, the global start method is set to the default, and its name is returned. See Global start method for more details.

  The return value can be `'fork'`, `'spawn'`, `'forkserver'` or `None`. See 컨텍스트 및 시작 방법.

  Added in version 3.4.

  버전 3.8에서 변경: macOS에서, spawn 시작 방법이 이제 기본값입니다. fork 시작 방법은 서브 프로세스의 충돌로 이어질 수 있기 때문에, 안전하지 않은 것으로 간주해야 합니다. bpo-33725를 참조하십시오.

multiprocessing.set_executable(executable)

  Set the path of the Python interpreter to use when starting a child process. (By default `sys.executable` is used). Embedders will probably need to do some thing like

      set_executable(os.path.join(sys.exec_prefix, 'pythonw.exe'))

  자식 프로세스를 만들기 전에 해야 합니다.

  버전 3.4에서 변경: Now supported on POSIX when the `'spawn'` start method is used.

  버전 3.11에서 변경: Accepts a path-like object.

multiprocessing.set_forkserver_preload(module_names, *, on_error='ignore')

  Set a list of module names for the forkserver main process to attempt to import so that their already imported state is inherited by forked processes. This can be used as a performance enhancement to avoid repeated work in every process.

  For this to work, it must be called before the forkserver process has been launched (before creating a `Pool` or starting a `Process`).

  The on_error parameter controls how `ImportError` exceptions during module preloading are handled: `"ignore"` (default) silently ignores failures, `"warn"` causes the forkserver subprocess to emit an `ImportWarning` to stderr, and `"fail"` causes the forkserver subprocess to exit with the exception traceback on stderr, making subsequent process creation fail with `EOFError` or `ConnectionError`.

  Only meaningful when using the `'forkserver'` start method. See 컨텍스트 및 시작 방법.

  Added in version 3.4.

  버전 3.15.0a5 (unreleased)에서 변경: Added the on_error parameter.

multiprocessing.set_start_method(method, force=False)

  Set the method which should be used to start child processes. The method argument can be `'fork'`, `'spawn'` or `'forkserver'`. Raises `RuntimeError` if the start method has already been set and force is not `True`. If method is `None` and force is `True` then the start method is set to `None`. If method is `None` and force is `False` then the context is set to the default context.

  이것은 한 번만 호출해야 하며, 메인 모듈의 `if __name__ == '__main__'` 절 내에서 보호되어야 합니다.

  See 컨텍스트 및 시작 방법.

  Added in version 3.4.

참고

`multiprocessing` contains no analogues of `threading.active_count()`, `threading.enumerate()`, `threading.settrace()`, `threading.setprofile()`, `threading.Timer`, or `threading.local`.

### Connection 객체

연결 객체를 사용하면 피클 가능한 객체나 문자열을 보내고 받을 수 있습니다. 메시지 지향 연결된 소켓으로 생각할 수 있습니다.

연결 객체는 보통 `Pipe` 를 사용해서 만들어집니다 – 리스너와 클라이언트 도 참고하세요.

class multiprocessing.connection.Connection
  send(obj)

    연결의 반대편 끝에서 `recv()`를 사용하여 읽을 객체를 보냅니다.

    객체는 피클 가능해야 합니다. 매우 큰 피클(약 32 MiB+, OS에 따라 다릅니다)은 `ValueError` 예외를 발생시킬 수 있습니다.

  recv()

    연결의 반대편 끝에서 `send()`로 보낸 객체를 반환합니다. 뭔가 수신할 때까지 블록합니다. 수신할 내용이 없고 반대편 끝이 닫혔으면 `EOFError`를 발생시킵니다.

  fileno()

    연결이 사용하는 파일 기술자나 핸들을 돌려줍니다.

  close()

    연결을 닫습니다.

    연결이 가비지 수집될 때 자동으로 호출됩니다.

  poll([timeout])

    읽어 들일 데이터가 있는지를 돌려줍니다.

    timeout 을 지정하지 않으면 즉시 반환됩니다. timeout 이 숫자면 블록할 최대 시간(초)을 지정합니다. timeout 이 `None` 이면 시간제한이 없습니다.

    여러 개의 연결 객체를 `multiprocessing.connection.wait()` 을 사용하여 한 번에 폴링 할 수 있습니다.

  send_bytes(buffer[, offset[, size]])

    바이트열류 객체 의 바이트 데이터를 하나의 완전한 메시지로 보냅니다.

    offset 이 주어지면 buffer 의 해당 위치부터 데이터를 읽습니다. size 가 주어지면 그만큼의 바이트를 버퍼에서 읽습니다. 매우 큰 버퍼(약 32 MiB+, OS에 따라 다릅니다)는 `ValueError` 예외를 발생시킬 수 있습니다

  recv_bytes([maxlength])

    접속의 반대편 끝에서 송신된 바이트 데이터의 완전한 메시지를 문자열로 돌려줍니다. 뭔가 수신할 때까지 블록합니다. 수신할 내용이 없고 반대편 끝이 닫혔으면 `EOFError`를 발생시킵니다.

    maxlength 가 지정되고 메시지가 maxlength 보다 길면 `OSError` 가 발생하고 연결은 더는 읽을 수 없게 됩니다.

    버전 3.3에서 변경: 이 함수는 `IOError` 를 발생시켜왔는데, 이제는 `OSError` 의 별칭입니다.

  recv_bytes_into(buffer[, offset])

    연결의 반대편 끝에서 보낸 바이트 데이터의 전체 메시지를 buffer 로 읽어 들이고, 메시지의 바이트 수를 반환합니다. 뭔가 수신할 때까지 블록합니다. 수신할 내용이 없고 반대편 끝이 닫혔으면 `EOFError`를 발생시킵니다.

    buffer 는 쓰기 가능한 바이트열류 객체 여야 합니다. offset 이 지정되면, 버퍼의 그 위치로부터 메시지를 씁니다. offset은 buffer 길이보다 작은 음수가 아닌 정수여야 합니다 (바이트 단위).

    버퍼가 너무 작으면 `BufferTooShort` 예외가 발생하고, 완전한 메시지는 `e.args[0]` 으로 제공되는데, 여기서 `e` 는 예외 인스턴스입니다.

  버전 3.3에서 변경: 이제 연결 객체 자체를 `Connection.send()` 와 `Connection.recv()` 를 사용하여 프로세스 간에 전송할 수 있습니다.

  Connection objects also now support the context management protocol – see 컨텍스트 관리자 형. `__enter__()` returns the connection object, and `__exit__()` calls `close()`.

예를 들어:

    >>> from multiprocessing import Pipe
    >>> a, b = Pipe()
    >>> a.send([1, 'hello', None])
    >>> b.recv()
    [1, 'hello', None]
    >>> b.send_bytes(b'thank you')
    >>> a.recv_bytes()
    b'thank you'
    >>> import array
    >>> arr1 = array.array('i', range(5))
    >>> arr2 = array.array('i', [0] * 10)
    >>> a.send_bytes(arr1)
    >>> count = b.recv_bytes_into(arr2)
    >>> assert count == len(arr1) * arr1.itemsize
    >>> arr2
    array('i', [0, 1, 2, 3, 4, 0, 0, 0, 0, 0])

경고

`Connection.recv()` 메서드는 수신한 데이터를 자동으로 언 피클 합니다. 메시지를 보낸 프로세스를 신뢰할 수 없다면 보안상 위험 할 수 있습니다.

따라서, 연결 객체가 `Pipe()`를 사용하여 생성되지 않았다면, 일종의 인증을 수행한 후에만 `recv()` 및 `send()` 메서드를 사용해야 합니다. 인증 키를 참조하세요.

경고

프로세스가 파이프에 읽거나 쓰려고 할 때 죽으면, 파이프의 데이터가 손상될 가능성이 있습니다. 메시지 경계가 어디에 있는지 확신할 수 없는 상태가 될 가능성이 있기 때문입니다.

### 동기화 프리미티브

일반적으로 다중 프로세스 프로그램에서는 동기화 프리미티브가 다중 스레드 프로그램에서만큼 필요하지는 않습니다. `threading` 모듈에 대한 설명서를 참조하십시오.

관리자 객체를 사용하여 동기화 프리미티브를 생성할 수도 있습니다 – 관리자를 참조하세요.

class multiprocessing.Barrier(parties[, action[, timeout]])

  배리어(barrier) 객체: `threading.Barrier` 의 복제본.

  Instantiating this class may set the global start method. See Global start method for more details.

  Added in version 3.3.

class multiprocessing.BoundedSemaphore([value])

  제한된 세마포어 객체: `threading.BoundedSemaphore` 과 유사한 대응 물.

  Instantiating this class may set the global start method. See Global start method for more details.

  대응 물과 한 가지 차이가 있습니다: `acquire` 메서드의 첫 번째 인자에 block 이라는 이름을 사용해서 `Lock.acquire()` 와의 일관성을 유지합니다.

  locked()

    Return a boolean indicating whether this object is locked right now.

    Added in version 3.14.

  참고

  On macOS, this is indistinguishable from `Semaphore` because `sem_getvalue()` is not implemented on that platform.

class multiprocessing.Condition([lock])

  조건 변수: `threading.Condition` 의 별칭.

  If lock is specified then it should be a `Lock` or `RLock` object from `multiprocessing`.

  Instantiating this class may set the global start method. See Global start method for more details.

  버전 3.3에서 변경: `wait_for()` 메서드가 추가되었습니다.

class multiprocessing.Event

  `threading.Event` 의 복제본.

  Instantiating this class may set the global start method. See Global start method for more details.

class multiprocessing.Lock

  비 재귀적 록 객체: `threading.Lock` 과 유사한 대응 물. 일단 프로세스 또는 스레드가 록을 획득하면, 프로세스 또는 스레드에서 록을 획득하려는 후속 시도는 록이 해제될 때까지 블록 됩니다; 모든 프로세스 또는 스레드가 이를 해제할 수 있습니다. 스레드에 적용되는 `threading.Lock` 의 개념과 동작은, 명시된 경우를 제외하고, `multiprocessing.Lock` 를 통해 프로세스나 스레드에 그대로 적용됩니다.

  `Lock` 은 실제로 기본 컨텍스트로 초기화된 `multiprocessing.synchronize.Lock` 의 인스턴스를 반환하는 팩토리 함수입니다.

  Instantiating this class may set the global start method. See Global start method for more details.

  `Lock` 은 컨텍스트 관리자 프로토콜을 지원하므로 `with` 문에서 사용될 수 있습니다.

  acquire(block=True, timeout=None)

    블록하거나 블록하지 않는 방식으로 록을 획득합니다.

    block 인자가 `True` (기본값) 로 설정되면, 메서드 호출은 록이 해제 상태가 될 때까지 블록 한 다음, 잠금 상태로 만들고 `True` 를 반환합니다. 이 첫 번째 인자의 이름은 `threading.Lock.acquire()` 와 다르다는 것에 유의하세요.

    block 인자가 `False` 로 설정되면, 메서드 호출은 블록 되지 않습니다. 록이 현재 잠금 상태면 `False` 를 반환합니다. 그렇지 않으면 록을 잠금 상태로 설정하고 `True` 를 반환합니다.

    timeout 에 대해 양의 부동 소수점 값을 사용하여 호출하는 경우, 록을 얻을 수 없는 한 최대 timeout 으로 지정된 시간(초) 동안 블록합니다. timeout 을 음수 값으로 호출하는 것은 timeout 에 0을 주는 것과 같습니다. timeout 값이 `None` (기본값) 인 호출은 제한 시간을 무한대로 설정합니다. timeout 에 대한 음수와 `None` 값의 처리는 `threading.Lock.acquire()` 에서 구현된 동작과 다르다는 것에 주의하십시오. timeout 인자는 block 인자가 `False` 로 설정되면 실제적인 의미는 없고 무시됩니다. 록이 획득되면 `True` 를 돌려주고, 제한 시간 초과가 발생하면 `False` 를 돌려줍니다.

  release()

    록을 해제합니다. 이것은 원래 록을 획득한 프로세스나 스레드뿐만 아니라 모든 프로세스나 스레드에서 호출 할 수 있습니다.

    동작은 `threading.Lock.release()` 와 같지만, 해제된 록에서 호출될 때 `ValueError` 가 발생한다는 점만 다릅니다.

  locked()

    Return a boolean indicating whether this object is locked right now.

    Added in version 3.14.

class multiprocessing.RLock

  재귀적 록 객체: `threading.RLock` 과 유사한 대응 물. 재귀적 록은 획득한 프로세스 또는 스레드에 의해 해제되어야 합니다. 일단 프로세스나 스레드가 재귀적 록을 획득하면, 같은 프로세스나 스레드가 블록 없이 다시 획득할 수 있습니다; 해당 프로세스나 스레드는 획득할 때마다 한 번 해제해야 합니다.

  `RLock` 은 실제로 기본 컨텍스트로 초기화된 `multiprocessing.synchronize.RLock` 의 인스턴스를 반환하는 팩토리 함수입니다.

  Instantiating this class may set the global start method. See Global start method for more details.

  `RLock` 은 컨텍스트 관리자 프로토콜을 지원하므로 `with` 문에서 사용될 수 있습니다.

  acquire(block=True, timeout=None)

    블록하거나 블록하지 않는 방식으로 록을 획득합니다.

    block 인자를 `True` 로 설정해서 호출하면, 록이 현재 프로세스나 스레드가 이미 획득한 상태가 아니면 록이 (어떤 프로세스나 스레드도 획득하지 않은) 록 해제 상태가 될 때까지 블록합니다. 이후에 현재 프로세스나 스레드가 (소유권이 아직 없는 경우) 록 소유권을 얻게 되며 록 내 재귀 수준이 1 증가하고 `True` 를 반환합니다. 이 첫 번째 인자의 동작에는, 인자의 이름부터 시작해서 `threading.RLock.acquire()` 구현과 비교되는 몇 가지 차이점이 있습니다.

    block 인자를 `False` 로 설정해서 호출하면 블록하지 않습니다. 록이 이미 다른 프로세스나 스레드에 의해 획득되었으면 (그래서 소유하고 있으면), 현재 프로세스나 스레드는 소유권을 갖지 않으며 록 내 재귀 수준은 변경되지 않고 `False` 를 반환합니다. 록이 해제 상태에 있으면, 현재 프로세스 또는 스레드가 소유권을 가져오며 재귀 수준이 증가하고 `True` 를 반환합니다.

    timeout 인자의 사용법과 동작은 `Lock.acquire()` 와 같습니다. timeout 의 이러한 동작 중 일부는 `threading.RLock.acquire()` 에서 구현된 동작과 다르다는 것에 주의하십시오.

  release()

    재귀 수준을 감소시키면서 록을 해제합니다. 감소 후에 재귀 수준이 0이면, 록을 해제 상태(어떤 프로세스나 스레드에도 소유되지 않음)로 재설정하고, 다른 프로세스나 스레드가 록이 해제될 때까지 기다리며 블록하고 있는 경우 해당 프로세스나 스레드 중 정확히 하나가 계속 진행하도록 허용합니다. 감소 후에 재귀 수준이 여전히 0이 아닌 경우, 록은 획득된 상태로 남고 호출한 프로세스나 스레드에 의해 소유됩니다.

    호출한 프로세스나 스레드가 록을 소유하고 있을 때만 이 메서드를 호출하십시오. 이 메서드가 소유자가 아닌 프로세스나 스레드에 의해 호출되거나, 록이 해제 (소유되지 않은) 상태면 `AssertionError` 가 발생합니다. 이 상황에서 발생하는 예외 형은 `threading.RLock.release()` 에서 구현된 동작과 다릅니다.

  locked()

    Return a boolean indicating whether this object is locked right now.

    Added in version 3.14.

class multiprocessing.Semaphore([value])

  세마포어 객체: `threading.Semaphore` 와 유사한 대응 물.

  Instantiating this class may set the global start method. See Global start method for more details.

  대응 물과 한 가지 차이가 있습니다: `acquire` 메서드의 첫 번째 인자에 block 이라는 이름을 사용해서 `Lock.acquire()` 와의 일관성을 유지합니다.

  get_value()

    Return the current value of semaphore.

    Note that this may raise `NotImplementedError` on platforms like macOS where `sem_getvalue()` is not implemented.

  locked()

    Return a boolean indicating whether this object is locked right now.

    Added in version 3.14.

참고

On macOS, `sem_timedwait` is unsupported, so calling `acquire()` with a timeout will emulate that function’s behavior using a sleeping loop.

참고

이 패키지의 기능 중 일부는 호스트 운영 체제의 작동하는 공유 세마포어 구현을 요구합니다. 그런 것이 없으면, `multiprocessing.synchronize` 모듈이 비활성화되고, 임포트하려고 하면 `ImportError` 를 일으킵니다. 자세한 내용은 bpo-3770을 참조하십시오.

### 공유 `ctypes` 객체

자식 프로세스가 상속할 수 있는 공유 메모리를 사용하여 공유 객체를 만들 수 있습니다.

multiprocessing.Value(typecode_or_type, *args, lock=True)

  공유 메모리에 할당된 `ctypes` 객체를 반환합니다. 기본적으로 반환 값은, 사실 객체에 대한 동기화 된 래퍼입니다. 객체 자체는 `Value` 의 value 어트리뷰트를 통해 접근 할 수 있습니다.

  typecode_or_type 은 반환된 객체의 형을 결정합니다: ctypes 형이거나 `array` 모듈에 의해 사용되는 종류의 한 문자 typecode입니다. *args 는 형의 생성자로 전달됩니다.

  lock 이 `True` (기본값) 면 값에 대한 액세스를 동기화하기 위해 새 재귀적 록 객체가 생성됩니다. lock 이 `Lock` 또는 `RLock` 객체인 경우, 이 값이 값에 대한 액세스를 동기화하는 데 사용됩니다. lock 이 `False` 면, 반환된 객체에 대한 액세스는 록에 의해 자동으로 보호되지 않으므로 “프로세스 안전” 하지 않습니다.

  읽기와 쓰기를 포함하는 `+=` 와 같은 연산은 원자 적(atomic)이지 않습니다. 따라서, 예를 들어, 공유 값을 원자 적으로 증가시키려면, 다음과 같이 하는 것으로는 충분하지 않습니다:

      counter.value += 1

  연관된 록이 재귀적이라고 가정하면 (기본적으로 그렇습니다), 대신 다음과 같이 할 수 있습니다

      with counter.get_lock():
          counter.value += 1

  lock 은 키워드 전용 인자입니다.

multiprocessing.Array(typecode_or_type, size_or_initializer, *, lock=True)

  공유 메모리에서 할당된 ctypes 배열을 반환합니다. 기본적으로 반환 값은, 사실 배열에 대한 동기화 된 래퍼입니다.

  typecode_or_type determines the type of the elements of the returned array: it is either a ctypes type or a one character typecode of the kind used by the `array` module with the exception of `'w'`, which is not supported. In addition, the `'c'` typecode is an alias for `ctypes.c_char`. If size_or_initializer is an integer, then it determines the length of the array, and the array will be initially zeroed. Otherwise, size_or_initializer is a sequence which is used to initialize the array and whose length determines the length of the array.

  lock 이 `True` (기본값) 면 값에 대한 액세스를 동기화하기 위해 새 록 객체가 생성됩니다. lock 이 `Lock` 또는 `RLock` 객체인 경우, 이 값이 값에 대한 액세스를 동기화하는 데 사용됩니다. lock 이 `False` 면, 반환된 객체에 대한 액세스는 록에 의해 자동으로 보호되지 않으므로 “프로세스 안전” 하지 않습니다.

  lock 은 키워드 전용 인자입니다.

  `ctypes.c_char` 의 배열은 value 와 raw 어트리뷰트를 가지고 있습니다. 이 어트리뷰트를 사용하여 문자열을 저장하고 꺼낼 수 있습니다.

#### `multiprocessing.sharedctypes` 모듈

`multiprocessing.sharedctypes` 모듈은 자식 프로세스에 의해 상속될 수 있는 공유 메모리에 `ctypes` 객체를 할당하는 기능을 제공합니다.

참고

공유 메모리에 포인터를 저장할 수는 있지만, 특정 프로세스의 주소 공간에 있는 위치를 참조하게 됩니다. 그러나 포인터는 두 번째 프로세스의 컨텍스트에서는 유효하지 않을 가능성이 커서, 두 번째 프로세스에서 포인터를 역 참조하려고 하면 충돌이 일어날 수 있습니다.

multiprocessing.sharedctypes.RawArray(typecode_or_type, size_or_initializer)

  공유 메모리에 할당된 ctypes 배열을 반환합니다.

  typecode_or_type 은 반환된 배열의 요소의 형을 결정합니다: ctypes 형이거나 `array` 모듈에 의해 사용되는 종류의 한 문자 typecode입니다. size_or_initializer 가 정수면, 배열의 길이를 결정하고 배열은 0으로 초기화됩니다. 그렇지 않으면, size_or_initializer 는 배열을 초기화하는 데 사용되는 시퀀스고, 길이는 배열의 길이를 결정합니다.

  요소를 쓰고 읽는 것은 잠재적으로 원자 적이지 않습니다 – 액세스가 록을 사용하여 자동으로 동기화되기 원하면 `Array()`를 대신 사용하세요.

multiprocessing.sharedctypes.RawValue(typecode_or_type, *args)

  공유 메모리에 할당된 ctypes 객체를 반환합니다.

  typecode_or_type 은 반환된 객체의 형을 결정합니다: ctypes 형이거나 `array` 모듈에 의해 사용되는 종류의 한 문자 typecode입니다. *args 는 형의 생성자로 전달됩니다.

  값을 쓰고 읽는 것은 잠재적으로 원자 적이지 않습니다 – 액세스가 록을 사용하여 자동으로 동기화되기 원하면 `Value()`를 대신 사용하세요.

  `ctypes.c_char` 의 배열은 value 와 raw 어트리뷰트를 가지고 있습니다. 이 어트리뷰트를 사용하여 문자열을 저장하고 꺼낼 수 있습니다 – `ctypes` 설명서를 보십시오.

multiprocessing.sharedctypes.Array(typecode_or_type, size_or_initializer, *, lock=True, ctx=None)

  lock 값에 따라, 날 ctypes 배열 대신 프로세스 안전한 동기화 래퍼가 반환될 수 있다는 것을 제외하고는 `RawArray()` 와 같습니다.

  lock 이 `True` (기본값) 면 값에 대한 액세스를 동기화하기 위해 새 록 객체가 생성됩니다. lock 이 `Lock` 또는 `RLock` 객체인 경우, 이 값이 값에 대한 액세스를 동기화하는 데 사용됩니다. lock 이 `False` 면, 반환된 객체에 대한 액세스는 록에 의해 자동으로 보호되지 않으므로 “프로세스 안전” 하지 않습니다.

  ctx is a context object, or `None` (use the current context). If `None`, calling this may set the global start method. See Global start method for more details.

  Note that lock and ctx are keyword-only parameters.

multiprocessing.sharedctypes.Value(typecode_or_type, *args, lock=True, ctx=None)

  lock 값에 따라, 날 ctypes 객체 대신 프로세스 안전한 동기화 래퍼가 반환될 수 있다는 것을 제외하고는 `RawValue()` 와 같습니다.

  lock 이 `True` (기본값) 면 값에 대한 액세스를 동기화하기 위해 새 록 객체가 생성됩니다. lock 이 `Lock` 또는 `RLock` 객체인 경우, 이 값이 값에 대한 액세스를 동기화하는 데 사용됩니다. lock 이 `False` 면, 반환된 객체에 대한 액세스는 록에 의해 자동으로 보호되지 않으므로 “프로세스 안전” 하지 않습니다.

  ctx is a context object, or `None` (use the current context). If `None`, calling this may set the global start method. See Global start method for more details.

  Note that lock and ctx are keyword-only parameters.

multiprocessing.sharedctypes.copy(obj)

  공유 메모리에서 할당된 ctypes 객체를 반환합니다. 이 객체는 ctypes 객체 obj 의 복사본입니다.

multiprocessing.sharedctypes.synchronized(obj, lock=None, ctx=None)

  lock 을 사용하여 액세스를 동기화하는 ctypes 객체에 대한 프로세스 안전한 래퍼 객체를 반환합니다. lock 이 `None` (기본값)이면 `multiprocessing.RLock` 객체가 자동으로 생성됩니다.

  ctx is a context object, or `None` (use the current context). If `None`, calling this may set the global start method. See Global start method for more details.

  동기화 래퍼는 래핑 된 객체의 메서드 외에도 두 개의 메서드를 더 갖습니다: `get_obj()` 는 래핑 된 객체를 반환하고, `get_lock()` 은 동기화에 사용되는 록 객체를 반환합니다.

  래퍼를 통해 ctypes 객체에 액세스하는 것은, 날 ctypes 객체에 액세스하는 것보다 훨씬 느릴 수 있습니다.

  버전 3.5에서 변경: 동기화된 객체는 컨텍스트 관리자 프로토콜을 지원합니다.

아래 표는 공유 메모리에 공유 ctypes 객체를 만드는 문법과 일반적인 ctypes 문법을 비교합니다. (표에서 `MyStruct` 는 `ctypes.Structure` 의 서브 클래스입니다.)

ctypes | type을 사용하는 공유 ctypes | typecode를 사용하는 공유 ctypes
--- | --- | ---
c_double(2.4) | RawValue(c_double, 2.4) | RawValue(‘d’, 2.4)
MyStruct(4, 6) | RawValue(MyStruct, 4, 6) |
(c_short * 7)() | RawArray(c_short, 7) | RawArray(‘h’, 7)
(c_int * 3)(9, 2, 8) | RawArray(c_int, (9, 2, 8)) | RawArray(‘i’, (9, 2, 8))

다음은 자식 프로세스가 여러 ctypes 객체를 수정하는 예입니다:

    from multiprocessing import Process, Lock
    from multiprocessing.sharedctypes import Value, Array
    from ctypes import Structure, c_double

    class Point(Structure):
        _fields_ = [('x', c_double), ('y', c_double)]

    def modify(n, x, s, A):
        n.value **= 2
        x.value **= 2
        s.value = s.value.upper()
        for a in A:
            a.x **= 2
            a.y **= 2

    if __name__ == '__main__':
        lock = Lock()

        n = Value('i', 7)
        x = Value(c_double, 1.0/3.0, lock=False)
        s = Array('c', b'hello world', lock=lock)
        A = Array(Point, [(1.875,-6.25), (-5.75,2.0), (2.375,9.5)], lock=lock)

        p = Process(target=modify, args=(n, x, s, A))
        p.start()
        p.join()

        print(n.value)
        print(x.value)
        print(s.value)
        print([(a.x, a.y) for a in A])

인쇄되는 결과는 이렇습니다

    49
    0.1111111111111111
    HELLO WORLD
    [(3.515625, 39.0625), (33.0625, 4.0), (5.640625, 90.25)]

### 관리자

관리자는 서로 다른 컴퓨터에서 실행되는 프로세스 간에 네트워크를 통해 공유하는 것을 포함하여 서로 다른 프로세스 간에 공유할 수 있는 데이터를 만드는 방법을 제공합니다. 관리자 객체는 공유 객체 를 관리하는 서버 프로세스를 제어합니다. 다른 프로세스는 프락시를 사용하여 공유 객체에 액세스 할 수 있습니다.

multiprocessing.Manager()

  프로세스 간에 객체를 공유하는 데 사용할 수 있는 시작된 `SyncManager` 객체를 반환합니다. 반환된 관리자 객체는 생성된 자식 프로세스에 해당하며 공유 객체를 만들고 해당 프락시를 반환하는 메서드가 있습니다.

관리자 프로세스는 가비지 수집되거나 상위 프로세스가 종료되자마자 종료됩니다. 관리자 클래스는 `multiprocessing.managers` 모듈에 정의되어 있습니다 :

class multiprocessing.managers.BaseManager(address=None, authkey=None, serializer='pickle', ctx=None, *, shutdown_timeout=1.0)

  BaseManager 객체를 만듭니다.

  일단 생성되면 관리자 객체가 시작된 관리자 프로세스를 참조하게 하려고 `start()` 또는 `get_server().serve_forever()` 를 호출해야 합니다.

  address 는 관리자 프로세스가 새 연결을 리슨하는 주소입니다. address 가 `None` 이면 임의의 것이 선택됩니다.

  authkey 는 서버 프로세스로 들어오는 연결의 유효성을 검사하는 데 사용되는 인증 키입니다. authkey 가 `None` 이면 `current_process().authkey` 가 사용됩니다. 그렇지 않으면 authkey 가 사용되며 바이트열이어야 합니다.

  serializer must be `'pickle'` (use `pickle` serialization) or `'xmlrpclib'` (use `xmlrpc.client` serialization).

  ctx is a context object, or `None` (use the current context). If `None`, calling this may set the global start method. See Global start method for more details.

  shutdown_timeout is a timeout in seconds used to wait until the process used by the manager completes in the `shutdown()` method. If the shutdown times out, the process is terminated. If terminating the process also times out, the process is killed.

  버전 3.11에서 변경: Added the shutdown_timeout parameter.

  start([initializer[, initargs]])

    관리자를 시작시키기 위해 서브 프로세스를 시작합니다. initializer 가 `None` 이 아닌 경우, 서브 프로세스는 시작할 때 `initializer(*initargs)` 를 호출합니다.

  get_server()

    Manager의 제어를 받는 실제 서버를 나타내는 `Server` 객체를 반환합니다. `Server` 객체는 `serve_forever()` 메서드를 지원합니다:

        >>> from multiprocessing.managers import BaseManager
        >>> manager = BaseManager(address=('', 50000), authkey=b'abc')
        >>> server = manager.get_server()
        >>> server.serve_forever()

    `Server` 는 추가로 `address` 어트리뷰트를 가지고 있습니다.

  connect()

    지역 관리자 객체를 원격 관리자 프로세스에 연결합니다:

        >>> from multiprocessing.managers import BaseManager
        >>> m = BaseManager(address=('127.0.0.1', 50000), authkey=b'abc')
        >>> m.connect()

  shutdown()

    관리자가 사용하는 프로세스를 중지합니다. `start()`를 사용하여 서버 프로세스를 시작한 경우에만 사용할 수 있습니다.

    여러 번 호출 될 수 있습니다.

  register(typeid[, callable[, proxytype[, exposed[, method_to_typeid[, create_method]]]]])

    관리자 클래스에 형이나 콜러블을 등록하는데 사용할 수 있는 클래스 메서드.

    typeid 는 특정 형의 공유 객체를 식별하는 데 사용되는 “형 식별자” 입니다. 문자열이어야 합니다.

    callable 은 이 형 식별자에 대한 객체를 만드는 데 사용되는 콜러블 객체입니다. 관리자 인스턴스가 `connect()` 메서드를 사용하여 서버에 연결되거나, create_method 인자가 `False` 면 `None` 으로 남겨 둘 수 있습니다.

    proxytype 은, 이 typeid 의 공유 객체의 프락시를 만드는 데 사용되는 `BaseProxy` 의 서브 클래스입니다. `None` 이면 프락시 클래스가 자동으로 생성됩니다.

    exposed 는 이 typeid에 대한 프락시가 `BaseProxy._callmethod()` 를 사용하여 액세스 할 수 있도록 허용해야 하는 메서드 이름의 시퀀스를 지정하는 데 사용됩니다. (만약 exposed 가 `None` 이면, 존재하는 경우, `proxytype._exposed_` 가 대신 사용됩니다.) exposed 리스트가 지정되지 않은 경우, 공유 객체의 모든 “공용 메서드” 에 액세스 할 수 있습니다. (여기서 “공용 메서드” 는 `__call__()` 메서드가 있고 그 이름이 `'_'` 로 시작하지 않는 어트리뷰트를 의미합니다.)

    method_to_typeid 는 프락시를 반환해야 하는 노출된 메서드의 반환형을 지정하는 데 사용되는 매핑입니다. 메서드 이름을 typeid 문자열로 매핑합니다. (만일 method_to_typeid 가 `None` 이면, 존재한다면, `proxytype._method_to_typeid_` 가 대신 사용됩니다.) 메서드의 이름이 이 매핑의 키가 아니거나 매핑이 `None` 이면, 메서드에 의해 반환된 객체는 값으로 복사됩니다.

    create_method 는 이름이 typeid 인 메서드를 만들어야 하는지를 결정합니다. 이 메서드는 서버 프로세스에 새 공유 객체를 만들고 프락시를 반환하도록 지시하는 데 사용될 수 있습니다. 기본적으로 `True` 입니다.

  `BaseManager` 인스턴스는 읽기 전용 프로퍼티를 하나 가지고 있습니다:

  address

    관리자가 사용하는 주소.

  버전 3.3에서 변경: 관리자 객체는 컨텍스트 관리 프로토콜을 지원합니다 – 컨텍스트 관리자 형를 보세요. `__enter__()` 는 서버 프로세스를 시작하고 (아직 시작하지 않았다면), 관리자 객체를 반환합니다. `__exit__()` 는 `shutdown()`을 호출합니다.

  이전 버전에서 `__enter__()` 는 관리자의 서버 프로세스가 아직 시작되지 않았을 때 시작시키지 않았습니다.

class multiprocessing.managers.SyncManager

  프로세스의 동기화에 사용할 수 있는 `BaseManager` 의 서브 클래스입니다. 이 형의 객체는 `multiprocessing.Manager()` 에 의해 반환됩니다.

  이 클래스의 메서드는 여러 프로세스에서 동기화 할 수 있도록 일반적으로 사용되는 많은 데이터형을 생성하고 프락시 객체를 반환합니다. 특히 공유 리스트와 딕셔너리가 포함됩니다.

  Barrier(parties[, action[, timeout]])

    공유 `threading.Barrier` 객체를 생성하고 프락시를 반환합니다.

    Added in version 3.3.

  BoundedSemaphore([value])

    공유 `threading.BoundedSemaphore` 객체를 생성하고 프락시를 반환합니다.

  Condition([lock])

    공유 `threading.Condition` 객체를 생성하고 프락시를 반환합니다.

    lock 이 제공되면 `threading.Lock` 또는 `threading.RLock` 객체에 대한 프락시여야 합니다.

    버전 3.3에서 변경: `wait_for()` 메서드가 추가되었습니다.

  Event()

    공유 `threading.Event` 객체를 생성하고 프락시를 반환합니다.

  Lock()

    공유 `threading.Lock` 객체를 생성하고 프락시를 반환합니다.

  Namespace()

    공유 `Namespace` 객체를 생성하고 프락시를 반환합니다.

  Queue([maxsize])

    공유 `queue.Queue` 객체를 생성하고 프락시를 반환합니다.

  RLock()

    공유 `threading.RLock` 객체를 생성하고 프락시를 반환합니다.

  Semaphore([value])

    공유 `threading.Semaphore` 객체를 생성하고 프락시를 반환합니다.

  Array(typecode, sequence)

    배열을 만들고 프락시를 반환합니다.

  Value(typecode, value)

    쓰기 가능한 `value` 어트리뷰트를 가진 객체를 생성하고 프락시를 반환합니다.

  dict()
  dict(mapping)
  dict(sequence)

    공유 `dict` 객체를 생성하고 프락시를 반환합니다.

  list()
  list(sequence)

    공유 `list` 객체를 생성하고 프락시를 반환합니다.

  set()
  set(sequence)
  set(mapping)

    Create a shared `set` object and return a proxy for it.

    Added in version 3.14: `set` support was added.

  버전 3.6에서 변경: 공유 객체는 중첩될 수 있습니다. 예를 들어, 공유 리스트와 같은 공유 컨테이너 객체는, `SyncManager` 에 의해 모두 관리되고 동기화되는 다른 공유 객체를 포함 할 수 있습니다.

class multiprocessing.managers.Namespace

  `SyncManager` 로 등록 할 수 있는 형입니다.

  이름 공간 객체에는 공용 메서드가 없지만, 쓰기 가능한 어트리뷰트가 있습니다. repr 은 그것의 어트리뷰트 값을 보여줍니다.

  그러나, 이름 공간 객체의 프락시를 사용할 때, `'_'` 로 시작하는 어트리뷰트는 프락시의 어트리뷰트가 되며 참조 대상의 어트리뷰트가 아닙니다:

      >>> mp_context = multiprocessing.get_context('spawn')
      >>> manager = mp_context.Manager()
      >>> Global = manager.Namespace()
      >>> Global.x = 10
      >>> Global.y = 'hello'
      >>> Global._z = 12.3    # this is an attribute of the proxy
      >>> print(Global)
      Namespace(x=10, y='hello')

#### 사용자 정의 관리자

자신만의 관리자를 만들려면, `BaseManager` 의 서브 클래스를 만들고 `register()` 클래스 메서드를 사용하여 새로운 형이나 콜러블을 관리자 클래스에 등록합니다. 예를 들면:

    from multiprocessing.managers import BaseManager

    class MathsClass:
        def add(self, x, y):
            return x + y
        def mul(self, x, y):
            return x * y

    class MyManager(BaseManager):
        pass

    MyManager.register('Maths', MathsClass)

    if __name__ == '__main__':
        with MyManager() as manager:
            maths = manager.Maths()
            print(maths.add(4, 3))         # prints 7
            print(maths.mul(7, 8))         # prints 56

#### 원격 관리자 사용하기

한 기계에서 관리자 서버를 실행하고 다른 기계의 클라이언트가 관리자 서버를 사용하도록 할 수 있습니다 (관련된 방화벽이 허용한다고 가정합니다).

다음 명령을 실행하면 원격 클라이언트가 액세스 할 수 있는 단일 공유 큐를 위한 서버가 만들어집니다:

    >>> from multiprocessing.managers import BaseManager
    >>> from queue import Queue
    >>> queue = Queue()
    >>> class QueueManager(BaseManager): pass
    >>> QueueManager.register('get_queue', callable=lambda:queue)
    >>> m = QueueManager(address=('', 50000), authkey=b'abracadabra')
    >>> s = m.get_server()
    >>> s.serve_forever()

한 클라이언트는 다음과 같이 서버에 액세스 할 수 있습니다:

    >>> from multiprocessing.managers import BaseManager
    >>> class QueueManager(BaseManager): pass
    >>> QueueManager.register('get_queue')
    >>> m = QueueManager(address=('foo.bar.org', 50000), authkey=b'abracadabra')
    >>> m.connect()
    >>> queue = m.get_queue()
    >>> queue.put('hello')

또 다른 클라이언트도 사용할 수 있습니다:

    >>> from multiprocessing.managers import BaseManager
    >>> class QueueManager(BaseManager): pass
    >>> QueueManager.register('get_queue')
    >>> m = QueueManager(address=('foo.bar.org', 50000), authkey=b'abracadabra')
    >>> m.connect()
    >>> queue = m.get_queue()
    >>> queue.get()
    'hello'

지역 프로세스 역시, 위의 클라이언트가 원격으로 액세스하는 코드를 사용하여 같은 큐에 액세스 할 수 있습니다:

    >>> from multiprocessing import Process, Queue
    >>> from multiprocessing.managers import BaseManager
    >>> class Worker(Process):
    ...     def __init__(self, q):
    ...         self.q = q
    ...         super().__init__()
    ...     def run(self):
    ...         self.q.put('local hello')
    ...
    >>> queue = Queue()
    >>> w = Worker(queue)
    >>> w.start()
    >>> class QueueManager(BaseManager): pass
    ...
    >>> QueueManager.register('get_queue', callable=lambda: queue)
    >>> m = QueueManager(address=('', 50000), authkey=b'abracadabra')
    >>> s = m.get_server()
    >>> s.serve_forever()

### 프락시 객체

프락시는 (아마도) 다른 프로세스에 있는 공유 객체를 가리키는 객체입니다. 공유 객체는 프락시의 지시 대상 이라고 합니다. 여러 프락시 객체는 같은 지시 대상을 가질 수 있습니다.

프락시 객체에는 지시 대상의 해당 메서드를 호출하는 메서드가 있습니다 (그러나 지시 대상의 모든 메서드가 반드시 프락시를 통해 사용할 수 있는 것은 아닙니다). 이런 식으로, 프락시는 지시 대상처럼 사용될 수 있습니다:

    >>> mp_context = multiprocessing.get_context('spawn')
    >>> manager = mp_context.Manager()
    >>> l = manager.list([i*i for i in range(10)])
    >>> print(l)
    [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]
    >>> print(repr(l))
    <ListProxy object, typeid 'list' at 0x...>
    >>> l[4]
    16
    >>> l[2:5]
    [4, 9, 16]

프락시에 `str()` 을 적용하면 지시 대상의 표현이 반환되는 반면, `repr()` 을 적용하면 프락시의 표현이 반환됩니다.

프락시 객체의 중요한 특징은, 피클 가능해서 프로세스 간에 전달될 수 있다는 것입니다. 지시 대상은 프락시 객체를 포함 할 수 있습니다. 이것은 관리된 리스트, 딕셔너리 및 다른 프락시 객체 의 중첩을 허용합니다:

    >>> a = manager.list()
    >>> b = manager.list()
    >>> a.append(b)         # referent of a now contains referent of b
    >>> print(a, b)
    [<ListProxy object, typeid 'list' at ...>] []
    >>> b.append('hello')
    >>> print(a[0], b)
    ['hello'] ['hello']

비슷하게, 딕셔너리와 리스트 프락시는 서로 중첩될 수 있습니다:

    >>> l_outer = manager.list([ manager.dict() for i in range(2) ])
    >>> d_first_inner = l_outer[0]
    >>> d_first_inner['a'] = 1
    >>> d_first_inner['b'] = 2
    >>> l_outer[1]['c'] = 3
    >>> l_outer[1]['z'] = 26
    >>> print(l_outer[0])
    {'a': 1, 'b': 2}
    >>> print(l_outer[1])
    {'c': 3, 'z': 26}

(프락시가 아닌) 표준 `list` 또는 `dict` 객체가 지시 대상에 포함되어있는 경우, 이 가변 값들에 대한 수정은 관리자를 통해 전파되지 않습니다. 포함된 값이 언제 수정되는지 프락시가 알 방법이 없기 때문입니다. 그러나 컨테이너 프락시에 값을 저장하는 것(프락시 객체의 `__setitem__` 을 호출합니다)은 관리자를 통해 전파되므로, 그 항목을 효과적으로 수정하기 위해, 수정된 값을 컨테이너 프락시에 다시 대입할 수 있습니다:

    # create a list proxy and append a mutable object (a dictionary)
    lproxy = manager.list()
    lproxy.append({})
    # now mutate the dictionary
    d = lproxy[0]
    d['a'] = 1
    d['b'] = 2
    # at this point, the changes to d are not yet synced, but by
    # updating the dictionary, the proxy is notified of the change
    lproxy[0] = d

이 접근법은 아마도 대부분의 사용 사례에서 중첩된 프락시 객체를 사용하는 것보다 불편하지만, 동기화에 대한 제어 수준을 보여줍니다.

참고

The proxy types in `multiprocessing` do nothing to support comparisons by value. So, for instance, we have:

    >>> manager.list([1,2,3]) == [1,2,3]
    False

비교할 때는 지시 대상의 사본을 대신 사용해야 합니다.

class multiprocessing.managers.BaseProxy

  프락시 객체는 `BaseProxy` 의 서브 클래스의 인스턴스입니다.

  _callmethod(methodname[, args[, kwds]])

    프락시의 지시 대상 메서드를 호출하고 결과를 반환합니다.

    `proxy` 가 프락시이고, 그 지시 대상이 `obj` 면, 표현식

        proxy._callmethod(methodname, args, kwds)

    은 표현식

        getattr(obj, methodname)(*args, **kwds)

    을 관리자 프로세스에서 평가합니다.

    반환된 값은 호출 결과의 복사본이거나 새 공유 객체에 대한 프락시입니다 – `BaseManager.register()` 의 method_to_typeid 인자에 대한 설명서를 보십시오.

    호출 때문에 예외가 발생하면, `_callmethod()` 가 다시 일으킵니다. 관리자 프로세스에서 다른 예외가 발생하면 `RemoteError` 예외로 변환되어 `_callmethod()` 가 일으킵니다.

    특히, methodname 이 노출되지 않았으면 예외가 발생합니다.

    `_callmethod()` 사용법의 예:

        >>> l = manager.list(range(10))
        >>> l._callmethod('__len__')
        10
        >>> l._callmethod('__getitem__', (slice(2, 7),)) # equivalent to l[2:7]
        [2, 3, 4, 5, 6]
        >>> l._callmethod('__getitem__', (20,))          # equivalent to l[20]
        Traceback (most recent call last):
        ...
        IndexError: list index out of range

  _getvalue()

    지시 대상의 복사본을 반환합니다.

    지시 대상이 피클 가능하지 않으면 예외가 발생합니다.

  __repr__()

    프락시 객체의 표현을 반환합니다.

  __str__()

    지시 대상의 표현을 반환합니다.

#### 정리

프락시 객체는 weakref 콜백을 사용해서 가비지 수집 시 자신의 지시 대상을 소유한 관리자에서 자신을 등록 취소합니다.

더는 참조하는 프락시가 없는 경우 공유 객체는 관리자 프로세스에서 삭제됩니다.

### 프로세스 풀

`Pool` 클래스를 사용하여, 제출된 작업을 수행할 프로세스 풀을 만들 수 있습니다.

class multiprocessing.pool.Pool([processes[, initializer[, initargs[, maxtasksperchild[, context]]]]])

  작업을 제출할 수 있는 작업자 프로세스 풀을 제어하는 프로세스 풀 객체. 제한 시간과 콜백을 사용하는 비동기 결과를 지원하고 병렬 map 구현을 제공합니다.

  processes is the number of worker processes to use. If processes is `None` then the number returned by `os.process_cpu_count()` is used.

  initializer 가 `None` 이 아니면, 각 작업자 프로세스는 시작할 때 `initializer(*initargs)` 를 호출합니다.

  maxtasksperchild 는, 사용되지 않는 자원을 해제할 수 있도록, 작업 프로세스가 종료되고 새 작업 프로세스로 교체되기 전에 완료할 수 있는 작업 수입니다. 기본 maxtasksperchild 는 `None` 입니다. 이는 작업자 프로세스가 풀만큼 오래감을 의미합니다.

  context can be used to specify the context used for starting the worker processes. Usually a pool is created using the function `multiprocessing.Pool()` or the `Pool()` method of a context object. In both cases context is set appropriately. If `None`, calling this function will have the side effect of setting the current global start method if it has not been set already. See the `get_context()` function.

  풀 객체의 메서드는 풀을 생성한 프로세스에 의해서만 호출되어야 합니다.

  경고

  `multiprocessing.pool` 객체에는 풀을 컨텍스트 관리자로 사용하거나 `close()`와 `terminate()`를 수동으로 호출하여 (다른 자원과 마찬가지로) 올바르게 관리해야 하는 내부 자원이 있습니다. 이를 수행하지 않으면 파이널리제이션 때 프로세스가 멈출 수 있습니다.

  Note that it is not correct to rely on the garbage collector to destroy the pool as CPython does not assure that the finalizer of the pool will be called (see `object.__del__()` for more information).

  버전 3.2에서 변경: Added the maxtasksperchild parameter.

  버전 3.4에서 변경: Added the context parameter.

  버전 3.13에서 변경: processes uses `os.process_cpu_count()` by default, instead of `os.cpu_count()`.

  참고

  `Pool` 내의 작업자 프로세스는 일반적으로 Pool의 작업 큐의 전체 지속 기간 지속합니다. 작업자가 잡은 자원을 해제하기 위해 다른 시스템 (가령 Apache, mod_wsgi 등)에서 흔히 사용되는 패턴은, 풀 내에 있는 작업자가 종료되고 새 프로세스가 스폰 되어 예전 것을 교체하기 전에 일정한 분량의 작업만 완료하도록 하는 것입니다. `Pool` 의 maxtasksperchild 인자는 이 기능을 일반 사용자에게 노출합니다.

  apply(func[, args[, kwds]])

    인자 args 및 키워드 인자 kwds 를 사용하여 func 를 호출합니다. 결과가 준비될 때까지 블록 됩니다. 이 블록 때문에, `apply_async()` 가 병렬로 작업을 수행하는 데 더 적합합니다. 또한 func 는 풀의 작업자 중 하나에서만 실행됩니다.

  apply_async(func[, args[, kwds[, callback[, error_callback]]]])

    `AsyncResult` 객체를 반환하는 `apply()` 메서드의 변형입니다.

    callback 이 지정되면 단일 인자를 받아들이는 콜러블이어야 합니다. 결과가 준비되면 callback 을 이 결과를 인자로 호출합니다. 실패한 결과면 error_callback 이 대신 적용됩니다.

    error_callback 이 지정되면 단일 인자를 허용하는 콜러블이어야 합니다. 대상 함수가 실패하면, error_callback 이 예외 인스턴스를 인자로 호출됩니다.

    콜백은 즉시 완료되어야 합니다. 그렇지 않으면 결과를 처리하는 스레드가 블록 됩니다.

  map(func, iterable[, chunksize])

    `map()` 내장 함수의 병렬 버전입니다 (하지만 하나의 iterable 인자만 지원합니다, 여러 이터러블에 대해서는 `starmap()`을 참조하십시오). 결과가 준비될 때까지 블록 됩니다.

    이 메서드는 iterable을 여러 묶음으로 잘라서 별도의 작업으로 프로세스 풀에 제출합니다. 이러한 묶음의 (대략적인) 크기는 chunksize 를 양의 정수로 설정하여 지정할 수 있습니다.

    매우 긴 이터러블은 높은 메모리 사용을 유발할 수 있습니다. 더 나은 효율성을 위해, 명시적인 chunksize 옵션으로 `imap()`이나 `imap_unordered()`를 사용하는 것을 고려하십시오.

  map_async(func, iterable[, chunksize[, callback[, error_callback]]])

    `AsyncResult` 객체를 반환하는 `map()` 메서드의 변형입니다.

    callback 이 지정되면 단일 인자를 받아들이는 콜러블이어야 합니다. 결과가 준비되면 callback 을 이 결과를 인자로 호출합니다. 실패한 결과면 error_callback 이 대신 적용됩니다.

    error_callback 이 지정되면 단일 인자를 허용하는 콜러블이어야 합니다. 대상 함수가 실패하면, error_callback 이 예외 인스턴스를 인자로 호출됩니다.

    콜백은 즉시 완료되어야 합니다. 그렇지 않으면 결과를 처리하는 스레드가 블록 됩니다.

  imap(func, iterable[, chunksize])

    `map()` 의 느긋한 버전.

    chunksize 인자는 `map()` 메서드에서 사용된 인자와 같습니다. 매우 긴 iterable의 경우 chunksize 에 큰 값을 사용하면 기본값 `1` 을 사용하는 것보다 작업을 많이 빠르게 완료 할 수 있습니다.

    또한 chunksize 가 `1` 이면 `imap()` 메서드에 의해 반환된 이터레이터의 `next()` 메서드는 선택적 timeout 매개 변수를 가집니다: `next(timeout)` 은 결과가 timeout 초 내에 반환될 수 없는 경우 `multiprocessing.TimeoutError` 를 발생시킵니다.

  imap_unordered(func, iterable[, chunksize])

    `imap()`과 같지만, 반환된 이터레이터가 제공하는 결과의 순서가 임의적인 것으로 간주하여야 합니다. (단 하나의 작업자 프로세스가 있는 경우에만 순서가 “올바름” 이 보장됩니다.

  starmap(func, iterable[, chunksize])

    Like `map()` except that the elements of the iterable are expected to be iterables that are unpacked as arguments.

    따라서 iterable 이 `[(1,2), (3, 4)]` 미면 결과는 `[func(1,2), func(3,4)]` 가 됩니다.

    Added in version 3.3.

  starmap_async(func, iterable[, chunksize[, callback[, error_callback]]])

    `starmap()` 과 `map_async()` 의 조합으로 이터러블의 iterable 을 이터레이트하고 이터러블을 언팩해서 func 를 호출합니다. 결과 객체를 반환합니다.

    Added in version 3.3.

  close()

    더는 작업이 풀에 제출되지 않도록 합니다. 모든 작업이 완료되면 작업자 프로세스가 종료됩니다.

  terminate()

    계류 중인 작업을 완료하지 않고 즉시 작업자 프로세스를 중지합니다. 풀 객체가 가비지 수집될 때 `terminate()` 가 즉시 호출됩니다.

  join()

    작업자 프로세스가 종료될 때까지 기다립니다. `join()` 호출 전에 반드시 `close()` 나 `terminate()`를 호출해야합니다 .

  버전 3.3에서 변경: 풀 객체는 이제 컨텍스트 관리 프로토콜을 지원합니다 – 컨텍스트 관리자 형를 보십시오. `__enter__()` 는 풀 객체를 반환하고, `__exit__()` 는 `terminate()`를 호출합니다.

class multiprocessing.pool.AsyncResult

  `Pool.apply_async()`와 `Pool.map_async()` 에 의해 반환되는 결과의 클래스.

  get([timeout])

    결과가 도착할 때 반환합니다. timeout 이 `None` 이 아니고 결과가 timeout 초 내에 도착하지 않으면 `multiprocessing.TimeoutError` 가 발생합니다. 원격 호출이 예외를 발생시키는 경우 해당 예외는 `get()` 에 의해 다시 발생합니다.

  wait([timeout])

    결과가 사용 가능할 때까지 또는 timeout 초가 지날 때까지 기다립니다.

  ready()

    호출이 완료했는지를 돌려줍니다.

  successful()

    예외를 발생시키지 않고 호출이 완료되었는지를 돌려줍니다. 결과가 준비되지 않았으면 `ValueError` 를 발생시킵니다.

    버전 3.7에서 변경: 결과가 준비되지 않았으면, `AssertionError` 대신 `ValueError`가 발생합니다.

다음 예제는 풀 사용 방법을 보여줍니다.:

    from multiprocessing import Pool
    import time

    def f(x):
        return x*x

    if __name__ == '__main__':
        with Pool(processes=4) as pool:         # start 4 worker processes
            result = pool.apply_async(f, (10,)) # evaluate "f(10)" asynchronously in a single process
            print(result.get(timeout=1))        # prints "100" unless your computer is *very* slow

            print(pool.map(f, range(10)))       # prints "[0, 1, 4,..., 81]"

            it = pool.imap(f, range(10))
            print(next(it))                     # prints "0"
            print(next(it))                     # prints "1"
            print(it.next(timeout=1))           # prints "4" unless your computer is *very* slow

            result = pool.apply_async(time.sleep, (10,))
            print(result.get(timeout=1))        # raises multiprocessing.TimeoutError

### 리스너와 클라이언트

보통 프로세스 간 메시지 전달은 큐를 사용하거나 `Pipe()` 가 반환하는 `Connection` 객체를 사용하여 수행됩니다.

그러나, `multiprocessing.connection` 모듈은 약간의 추가적인 유연성을 허용합니다. 기본적으로 소켓이나 윈도우의 이름있는 파이프를 다루는 높은 수준의 메시지 지향 API를 제공합니다. 또한 `hmac` 모듈을 사용한 다이제스트 인증 과 다중 연결을 동시에 폴링하는 방법을 지원합니다.

multiprocessing.connection.deliver_challenge(connection, authkey)

  무작위로 생성된 메시지를 연결의 다른 쪽 끝으로 보내고 응답을 기다립니다.

  응답이 authkey 를 키로 사용하는 메시지의 다이제스트와 일치하면 환영 메시지가 연결의 다른 끝으로 전송됩니다. 그렇지 않으면 `AuthenticationError` 가 발생합니다.

multiprocessing.connection.answer_challenge(connection, authkey)

  메시지를 수신하고, authkey 를 키로 사용하여 메시지의 다이제스트를 계산한 다음, 다이제스트를 다시 보냅니다.

  환영 메시지가 수신되지 않으면, `AuthenticationError` 가 발생합니다.

multiprocessing.connection.Client(address[, family[, authkey]])

  주소 address 를 사용하는 리스너에 대한 연결을 설정하려고 시도하고, `Connection`을 반환합니다.

  연결 유형은 family 인자에 의해 결정되지만, 일반적으로 address 형식에서 유추 할 수 있으므로 일반적으로 생략 할 수 있습니다. (주소 형식를 참조하세요)

  If authkey is given and not `None`, it should be a byte string and will be used as the secret key for an HMAC-based authentication challenge. No authentication is done if authkey is `None`. `AuthenticationError` is raised if authentication fails. See 인증 키.

class multiprocessing.connection.Listener([address[, family[, backlog[, authkey]]]])

  연결을 ‘리스닝’ 하는 바인드된 소켓이나 윈도우의 이름있는 파이프에 대한 래퍼입니다.

  address 는 리스너 객체의 바인드된 소켓이나 이름있는 파이프가 사용할 주소입니다.

  참고

  주소가 ‘0.0.0.0’ 인 경우, 주소는 윈도우에서 연결 가능한 끝점이 아닙니다. 연결할 수 있는 끝점이 필요한 경우, ‘127.0.0.1’을 사용해야 합니다.

  family 는 사용할 소켓(또는 이름있는 파이프)의 유형입니다. 문자열 `'AF_INET'` (TCP 소켓), `'AF_UNIX'` (유닉스 도메인 소켓), `'AF_PIPE'` (윈도우 이름있는 파이프) 중 하나일 수 있습니다. 이 중 오직 첫 번째 것만 항상 사용할 수 있음이 보장됩니다. family 가 `None` 이면, address 의 형식으로부터 유추됩니다. address 역시 `None` 이면, 기본값이 선택됩니다. 이 기본값은 사용 가능한 것 중 가장 빠른 것으로 기대되는 것입니다. 주소 형식를 참조하세요. family 가 `'AF_UNIX'` 이고 주소가 `None` 이면, 소켓은 `tempfile.mkstemp()` 를 사용하여 만들어진 비공개 임시 디렉터리에 생성됩니다.

  리스너 객체가 소켓을 사용하면, backlog (기본적으로 1) 는 소켓이 바인드되면 소켓의 `listen()` 메서드에 전달됩니다.

  If authkey is given and not `None`, it should be a byte string and will be used as the secret key for an HMAC-based authentication challenge. No authentication is done if authkey is `None`. `AuthenticationError` is raised if authentication fails. See 인증 키.

  accept()

    리스너 객체의 바인드된 소켓 또는 이름있는 파이프에 대한 연결을 수락하고 `Connection` 객체를 반환합니다. 인증이 시도되고 실패하면 `AuthenticationError` 가 발생합니다.

  close()

    리스너 객체의 바운드된 소켓 또는 이름있는 파이프를 닫습니다. 리스너가 가비지 수집될 때 자동으로 호출됩니다. 그러나 명시적으로 호출하는 것이 좋습니다.

  리스너 객체는 다음과 같은 읽기 전용 프로퍼티를 가집니다:

  address

    리스너 객체에서 사용 중인 주소.

  last_accepted

    마지막으로 수락한 연결이 온 주소. 없으면 `None` 입니다.

  버전 3.3에서 변경: 리스너 객체는 컨텍스트 관리 프로토콜을 지원합니다 – 컨텍스트 관리자 형를 보세요. `__enter__()` 는 리스너 객체를 반환하고, `__exit__()` 는 `close()`를 호출합니다.

multiprocessing.connection.wait(object_list, timeout=None)

  object_list 에 있는 객체가 준비될 때까지 기다립니다. object_list 에 있는 객체 중 준비된 것들의 리스트를 반환합니다. timeout 이 float면, 호출이 최대 지정된 초만큼 블록 됩니다. timeout 이 `None` 이면, 시간제한 없이 블록 됩니다. 음수 timeout은 0과 같습니다.

  For both POSIX and Windows, an object can appear in object_list if it is

  - 읽기 가능한 `Connection` 객체;

  - 연결되고 읽기 가능한 `socket.socket` 객체; 또는

  - `Process` 객체의 `sentinel` 어트리뷰트.

  연결이나 소켓 객체는 읽을 수 있는 데이터가 있거나 반대편 끝이 닫히면 준비가 됩니다.

  POSIX: `wait(object_list, timeout)` almost equivalent `select.select(object_list, [], [], timeout)`. The difference is that, if `select.select()` is interrupted by a signal, it can raise `OSError` with an error number of `EINTR`, whereas `wait()` will not.

  Windows: An item in object_list must either be an integer handle which is waitable (according to the definition used by the documentation of the Win32 function `WaitForMultipleObjects()`) or it can be an object with a `fileno()` method which returns a socket handle or pipe handle. (Note that pipe handles and socket handles are not waitable handles.)

  Added in version 3.3.

예제

다음 서버 코드는 인증 키로 `'secret password'` 를 사용하는 리스너를 만듭니다. 그런 다음 연결을 기다리고 어떤 데이터를 클라이언트로 보냅니다.:

    from multiprocessing.connection import Listener
    from array import array

    address = ('localhost', 6000)     # family is deduced to be 'AF_INET'

    with Listener(address, authkey=b'secret password') as listener:
        with listener.accept() as conn:
            print('connection accepted from', listener.last_accepted)

            conn.send([2.25, None, 'junk', float])

            conn.send_bytes(b'hello')

            conn.send_bytes(array('i', [42, 1729]))

다음 코드는 서버에 연결하고 서버로부터 어떤 데이터를 받습니다:

    from multiprocessing.connection import Client
    from array import array

    address = ('localhost', 6000)

    with Client(address, authkey=b'secret password') as conn:
        print(conn.recv())                  # => [2.25, None, 'junk', float]

        print(conn.recv_bytes())            # => 'hello'

        arr = array('i', [0, 0, 0, 0, 0])
        print(conn.recv_bytes_into(arr))    # => 8
        print(arr)                          # => array('i', [42, 1729, 0, 0, 0])

다음 코드는 `wait()` 을 사용하여 여러 프로세스로부터 오는 메시지를 한 번에 기다립니다:

    from multiprocessing import Process, Pipe, current_process
    from multiprocessing.connection import wait

    def foo(w):
        for i in range(10):
            w.send((i, current_process().name))
        w.close()

    if __name__ == '__main__':
        readers = []

        for i in range(4):
            r, w = Pipe(duplex=False)
            readers.append(r)
            p = Process(target=foo, args=(w,))
            p.start()
            # We close the writable end of the pipe now to be sure that
            # p is the only process which owns a handle for it.  This
            # ensures that when p closes its handle for the writable end,
            # wait() will promptly report the readable end as being ready.
            w.close()

        while readers:
            for r in wait(readers):
                try:
                    msg = r.recv()
                except EOFError:
                    readers.remove(r)
                else:
                    print(msg)

#### 주소 형식

- `'AF_INET'` 주소는 `(hostname, port)` 형식의 튜플입니다. hostname 은 문자열이고, port 는 정수입니다.

- `'AF_UNIX'` 주소는 파일 시스템의 파일 이름을 나타내는 문자열입니다.

- An `'AF_PIPE'` address is a string of the form `r'\\.\pipe\PipeName'`. To use `Client()` to connect to a named pipe on a remote computer called ServerName one should use an address of the form `r'\\ServerName\pipe\PipeName'` instead.

두 개의 역 슬래시로 시작하는 문자열은 기본적으로 `'AF_UNIX'` 주소가 아니라 `'AF_PIPE'` 주소로 간주합니다.

### 인증 키

`Connection.recv` 를 사용할 때, 수신된 데이터는 자동으로 언 피클 됩니다. 안타깝게도, 신뢰할 수 없는 출처의 데이터를 언 피클 하는 것은 보안상의 위험입니다. 때문에 `Listener`와 `Client()` 는 `hmac` 모듈을 사용하여 다이제스트 인증을 제공합니다.

인증 키는 암호로 여겨질 수 있는 바이트열입니다: 일단 연결이 이루어지면 양 끝은 다른 쪽이 인증 키를 알고 있음을 증명하도록 요구합니다. (양쪽 끝이 같은 키를 사용하고 있음을 증명하는 데는 연결을 통해 키를 보내는 것을 수반하지 않습니다.)

인증이 요청되었지만 인증 키가 지정되지 않으면, `current_process().authkey` 의 반환 값이 사용됩니다 (`Process` 를 보세요). 이 값은 현재 프로세스가 생성하는 `Process` 객체에 의해 자동으로 상속됩니다. 이것은 다중 프로세스 프로그램의 모든 프로세스는 (기본적으로) 자신들 간의 연결을 설정할 때 사용할 수 있는 하나의 인증 키를 공유한다는 것을 뜻합니다.

적절한 인증 키는 `os.urandom()` 을 사용하여 생성할 수도 있습니다.

### 로깅

로깅에 대한 일부 지원이 제공됩니다. 그러나, `logging` 패키지는 프로세스 공유 록을 사용하지 않으므로 (처리기형에 따라) 다른 프로세스의 메시지가 뒤섞일 가능성이 있습니다.

multiprocessing.get_logger()

  Returns the logger used by `multiprocessing`. If necessary, a new one will be created.

  When first created the logger has level `logging.NOTSET` and no default handler. Messages sent to this logger will not by default propagate to the root logger.

  윈도우에서 자식 프로세스는 부모 프로세스의 로거의 수준만 상속받습니다 – 그 밖의 다른 로거 사용자 지정은 상속되지 않습니다.

multiprocessing.log_to_stderr(level=None)

  This function performs a call to `get_logger()` but in addition to returning the logger created by get_logger, it adds a handler which sends output to `sys.stderr` using format `'[%(levelname)s/%(processName)s] %(message)s'`. You can modify `levelname` of the logger by passing a `level` argument.

다음은 로깅이 켜져 있는 예제 세션입니다:

    >>> import multiprocessing, logging
    >>> logger = multiprocessing.log_to_stderr()
    >>> logger.setLevel(logging.INFO)
    >>> logger.warning('doomed')
    [WARNING/MainProcess] doomed
    >>> m = multiprocessing.Manager()
    [INFO/SyncManager-...] child process calling self.run()
    [INFO/SyncManager-...] created temp directory /.../pymp-...
    [INFO/SyncManager-...] manager serving at '/.../listener-...'
    >>> del m
    [INFO/MainProcess] sending shutdown message to manager
    [INFO/SyncManager-...] manager exiting with exitcode 0

로깅 수준의 전체 표는 `logging` 모듈을 참조하십시오.

### `multiprocessing.dummy` 모듈

`multiprocessing.dummy` replicates the API of `multiprocessing` but is no more than a wrapper around the `threading` module.

특히, `multiprocessing.dummy`에서 제공하는 `Pool` 함수는 같은 메서드 호출을 모두 지원하지만, 작업자 프로세스가 아닌 작업자 스레드 풀을 사용하는 `Pool`의 서브 클래스인 `ThreadPool`의 인스턴스를 반환합니다.

class multiprocessing.pool.ThreadPool([processes[, initializer[, initargs]]])

  작업을 제출할 수 있는 작업자 스레드 풀을 제어하는 스레드 풀 객체. `ThreadPool` 인스턴스는 `Pool` 인스턴스와 완전히 호환되며, 해당 리소스는 컨텍스트 관리자로 풀을 사용하거나 `close()`와 `terminate()`를 수동으로 호출하여 적절하게 관리해야 합니다.

  processes is the number of worker threads to use. If processes is `None` then the number returned by `os.process_cpu_count()` is used.

  initializer 가 `None` 이 아니면, 각 작업자 프로세스는 시작할 때 `initializer(*initargs)` 를 호출합니다.

  `Pool`과 달리, maxtasksperchild와 context는 제공할 수 없습니다.

  참고

  `ThreadPool`은 프로세스 풀을 중심으로 설계되고 `concurrent.futures` 모듈 도입 이전에 설계된 `Pool`과 같은 인터페이스를 공유합니다. 따라서, 스레드가 지원하는 풀에 적합하지 않은 일부 연산을 상속하고, 비동기 작업의 상태를 나타내는 자체 형 `AsyncResult`를 가지고 있는데 다른 라이브러리에서는 이해하지 못합니다.

  사용자는 일반적으로 처음부터 스레드를 중심으로 설계되고 `asyncio`를 포함한 다른 많은 라이브러리와 호환되는 `concurrent.futures.Future` 인스턴스를 반환하는 더 간단한 인터페이스를 가진 `concurrent.futures.ThreadPoolExecutor`를 사용하는 것을 선호해야 합니다.

## 프로그래밍 지침

There are certain guidelines and idioms which should be adhered to when using `multiprocessing`.

### 모든 시작 방법

다음은 모든 시작 방법에 적용됩니다.

공유 상태를 피하세요

> 가능한 한 프로세스 간에 많은 양의 데이터가 이동하지 않도록 해야 합니다.

> 저수준 동기화 프리미티브를 사용하기보다, 프로세스 간 통신을 위해 큐나 파이프를 사용하는 것이 아마도 최선입니다.

피클 가능성

> 프락시 메서드에 대한 인자가 피클 가능한지 확인하십시오.

프락시의 스레드 안전성

> 록으로 보호하지 않는 한 둘 이상의 스레드에서 프락시 객체를 사용하지 마십시오.

> (여러 프로세스가 같은 프락시를 사용하는 문제는 존재하지 않습니다.)

좀비 프로세스 조인하기

> On POSIX when a process finishes but has not been joined it becomes a zombie. There should never be very many because each time a new process starts (or `active_children()` is called) all completed processes which have not yet been joined will be joined. Also calling a finished process’s `Process.is_alive` will join the process. Even so it is probably good practice to explicitly join all the processes that you start.

피클/언 피클보다 상속하는 것이 더 좋습니다.

> When using the spawn or forkserver start methods many types from `multiprocessing` need to be picklable so that child processes can use them. However, one should generally avoid sending shared objects to other processes using pipes or queues. Instead you should arrange the program so that a process which needs access to a shared resource created elsewhere can inherit it from an ancestor process.

프로세스 강제 종료를 피하세요

> `Process.terminate` 메서드를 사용해서 프로세스를 정지시키는 것은, 그 프로세스가 현재 사용하고 있는 공유 자원(가령 록, 세마포어, 파이프, 큐)을 손상하거나 다른 프로세스에서 사용할 수 없게 만들 수 있습니다.

> 따라서, 아마도 어떤 공유 자원도 사용하지 않는 프로세스에만 `Process.terminate` 사용을 고려하는 것이 최선일 겁니다.

큐를 사용하는 프로세스 조인하기

> 큐에 항목을 넣은 프로세스는 종료되기 전에 버퍼링 된 모든 항목이 “피더” 스레드에 의해 하부 파이프로 공급될 때까지 대기합니다. (자식 프로세스는 `Queue.cancel_join_thread` 메서드를 호출해서 이 동작을 회피할 수 있습니다.)

> 이것은, 큐를 사용할 때마다 큐에 넣은 모든 항목이 결국 프로세스가 조인되기 전에 제거되도록 해야 함을 의미합니다. 그렇지 않으면 큐에 항목을 넣은 프로세스가 종료되리라고 보장할 수 없습니다. 데몬이 아닌 프로세스가 자동으로 조인된다는 것도 기억하세요.

> 교착 상태에 빠지는 예는 다음과 같습니다:

>     from multiprocessing import Process, Queue

>     def f(q):
>         q.put('X' * 1000000)

>     if __name__ == '__main__':
>         queue = Queue()
>         p = Process(target=f, args=(queue,))
>         p.start()
>         p.join()                    # this deadlocks
>         obj = queue.get()

> 이 문제를 고치는 방법은 마지막 두 줄의 순서를 바꾸는 것입니다 (또는 간단히 `p.join()` 줄을 지우는 것입니다).

자식 프로세스에 자원을 명시적으로 전달하세요.

> On POSIX using the fork start method, a child process can make use of a shared resource created in a parent process using a global resource. However, it is better to pass the object as an argument to the constructor for the child process.

> 윈도우 및 다른 시작 방법과 (잠재적으로) 호환될 수 있는 코드를 만드는 것 외에도, 이것은 자식 프로세스가 아직 살아있는 동안 객체가 부모 프로세스에서 가비지 수집되지 않음을 보장합니다. 부모 프로세스에서 그 객체가 가비지 수집될 때 일부 자원이 해제되면 이것이 중요 할 수 있습니다.

> 그래서 예를 들면

>     from multiprocessing import Process, Lock

>     def f():
>         ... do something using "lock" ...

>     if __name__ == '__main__':
>         lock = Lock()
>         for i in range(10):
>             Process(target=f).start()

> 는 다음과 같이 다시 써야 합니다

>     from multiprocessing import Process, Lock

>     def f(l):
>         ... do something using "l" ...

>     if __name__ == '__main__':
>         lock = Lock()
>         for i in range(10):
>             Process(target=f, args=(lock,)).start()

`sys.stdin` 을 “파일류 객체”로 교체할 때 조심하세요

> `multiprocessing` originally unconditionally called:

>     os.close(sys.stdin.fileno())

> `multiprocessing.Process._bootstrap()` 메서드에서 하는 작업입니다 — 이것은 손자 프로세스와 관련된 문제로 이어졌습니다. 이것은 다음과 같이 변경되었습니다:

>     sys.stdin.close()
>     sys.stdin = open(os.open(os.devnull, os.O_RDONLY), closefd=False)

> Which solves the fundamental issue of processes colliding with each other resulting in a bad file descriptor error, but introduces a potential danger to applications which replace `sys.stdin()` with a “file-like object” with output buffering. This danger is that if multiple processes call `close()` on this file-like object, it could result in the same data being flushed to the object multiple times, resulting in corruption.

> 파일류 객체를 작성하고 여러분 자신의 캐싱을 구현하면, 캐시에 추가할 때마다 pid를 저장하고, pid가 변경되면 캐시를 버려서 포크에 안전하게 만들 수 있습니다. 예를 들면:

>     @property
>     def cache(self):
>         pid = os.getpid()
>         if pid != self._pid:
>             self._pid = pid
>             self._cache = []
>         return self._cache

> 자세한 내용은 bpo-5155, bpo-5313 및 bpo-5331을 참조하십시오.

### spawn 과 forkserver 시작 방법

There are a few extra restrictions which don’t apply to the fork start method.

더 높은 피클 가능성

> Ensure that all arguments to `Process` are picklable. Also, if you subclass `Process.__init__`, you must make sure that instances will be picklable when the `Process.start` method is called.

전역 변수

> 자식 프로세스에서 실행되는 코드가 전역 변수에 접근하려고 시도하면, 그 값은 (있는 경우) `Process.start` 가 호출되는 시점의 부모 프로세스의 값과 같지 않을 수 있습니다.

> 하지만, 모듈 수준의 상수인 전역 변수는 문제가 되지 않습니다.

메인 모듈의 안전한 임포트

> Make sure that the main module can be safely imported by a new Python interpreter without causing unintended side effects (such as starting a new process).

> 예를 들어, spawn 또는 forkserver 시작 방법을 사용해서 다음 모듈을 실행하면 `RuntimeError` 로 실패합니다:

>     from multiprocessing import Process

>     def foo():
>         print('hello')

>     p = Process(target=foo)
>     p.start()

> 대신 다음과 같이 `if __name__ == '__main__':` 을 사용하여 프로그램의 “진입 지점”을 보호해야 합니다:

>     from multiprocessing import Process, freeze_support, set_start_method

>     def foo():
>         print('hello')

>     if __name__ == '__main__':
>         freeze_support()
>         set_start_method('spawn')
>         p = Process(target=foo)
>         p.start()

> (`freeze_support()` 줄은 프로그램이 프로즌 되지 않고 정상적으로 실행될 경우 생략될 수 있습니다.)

> 이것은 새로 스폰 된 파이썬 인터프리터가 모듈을 안전하게 임포트 한 다음 모듈의 `foo()` 함수를 실행할 수 있게 해줍니다.

> 메인 모듈에서 풀이나 관리자를 만들면 비슷한 제한이 적용됩니다.

## 예제

사용자 정의된 관리자와 프락시를 만들고 사용하는 방법에 대한 시연:

    from multiprocessing import freeze_support
    from multiprocessing.managers import BaseManager, BaseProxy
    import operator

    ##

    class Foo:
        def f(self):
            print('you called Foo.f()')
        def g(self):
            print('you called Foo.g()')
        def _h(self):
            print('you called Foo._h()')

    # A simple generator function
    def baz():
        for i in range(10):
            yield i*i

    # Proxy type for generator objects
    class GeneratorProxy(BaseProxy):
        _exposed_ = ['__next__']
        def __iter__(self):
            return self
        def __next__(self):
            return self._callmethod('__next__')

    # Function to return the operator module
    def get_operator_module():
        return operator

    ##

    class MyManager(BaseManager):
        pass

    # register the Foo class; make `f()` and `g()` accessible via proxy
    MyManager.register('Foo1', Foo)

    # register the Foo class; make `g()` and `_h()` accessible via proxy
    MyManager.register('Foo2', Foo, exposed=('g', '_h'))

    # register the generator function baz; use `GeneratorProxy` to make proxies
    MyManager.register('baz', baz, proxytype=GeneratorProxy)

    # register get_operator_module(); make public functions accessible via proxy
    MyManager.register('operator', get_operator_module)

    ##

    def test():
        manager = MyManager()
        manager.start()

        print('-' * 20)

        f1 = manager.Foo1()
        f1.f()
        f1.g()
        assert not hasattr(f1, '_h')
        assert sorted(f1._exposed_) == sorted(['f', 'g'])

        print('-' * 20)

        f2 = manager.Foo2()
        f2.g()
        f2._h()
        assert not hasattr(f2, 'f')
        assert sorted(f2._exposed_) == sorted(['g', '_h'])

        print('-' * 20)

        it = manager.baz()
        for i in it:
            print('<%d>' % i, end=' ')
        print()

        print('-' * 20)

        op = manager.operator()
        print('op.add(23, 45) =', op.add(23, 45))
        print('op.pow(2, 94) =', op.pow(2, 94))
        print('op._exposed_ =', op._exposed_)

    ##

    if __name__ == '__main__':
        freeze_support()
        test()

`Pool` 사용하기:

    import multiprocessing
    import time
    import random
    import sys

    #
    # Functions used by test code
    #

    def calculate(func, args):
        result = func(*args)
        return '%s says that %s%s = %s' % (
            multiprocessing.current_process().name,
            func.__name__, args, result
            )

    def calculatestar(args):
        return calculate(*args)

    def mul(a, b):
        time.sleep(0.5 * random.random())
        return a * b

    def plus(a, b):
        time.sleep(0.5 * random.random())
        return a + b

    def f(x):
        return 1.0 / (x - 5.0)

    def pow3(x):
        return x ** 3

    def noop(x):
        pass

    #
    # Test code
    #

    def test():
        PROCESSES = 4
        print('Creating pool with %d processes\n' % PROCESSES)

        with multiprocessing.Pool(PROCESSES) as pool:
            #
            # Tests
            #

            TASKS = [(mul, (i, 7)) for i in range(10)] + \
                    [(plus, (i, 8)) for i in range(10)]

            results = [pool.apply_async(calculate, t) for t in TASKS]
            imap_it = pool.imap(calculatestar, TASKS)
            imap_unordered_it = pool.imap_unordered(calculatestar, TASKS)

            print('Ordered results using pool.apply_async():')
            for r in results:
                print('\t', r.get())
            print()

            print('Ordered results using pool.imap():')
            for x in imap_it:
                print('\t', x)
            print()

            print('Unordered results using pool.imap_unordered():')
            for x in imap_unordered_it:
                print('\t', x)
            print()

            print('Ordered results using pool.map() --- will block till complete:')
            for x in pool.map(calculatestar, TASKS):
                print('\t', x)
            print()

            #
            # Test error handling
            #

            print('Testing error handling:')

            try:
                print(pool.apply(f, (5,)))
            except ZeroDivisionError:
                print('\tGot ZeroDivisionError as expected from pool.apply()')
            else:
                raise AssertionError('expected ZeroDivisionError')

            try:
                print(pool.map(f, list(range(10))))
            except ZeroDivisionError:
                print('\tGot ZeroDivisionError as expected from pool.map()')
            else:
                raise AssertionError('expected ZeroDivisionError')

            try:
                print(list(pool.imap(f, list(range(10)))))
            except ZeroDivisionError:
                print('\tGot ZeroDivisionError as expected from list(pool.imap())')
            else:
                raise AssertionError('expected ZeroDivisionError')

            it = pool.imap(f, list(range(10)))
            for i in range(10):
                try:
                    x = next(it)
                except ZeroDivisionError:
                    if i == 5:
                        pass
                except StopIteration:
                    break
                else:
                    if i == 5:
                        raise AssertionError('expected ZeroDivisionError')

            assert i == 9
            print('\tGot ZeroDivisionError as expected from IMapIterator.next()')
            print()

            #
            # Testing timeouts
            #

            print('Testing ApplyResult.get() with timeout:', end=' ')
            res = pool.apply_async(calculate, TASKS[0])
            while 1:
                sys.stdout.flush()
                try:
                    sys.stdout.write('\n\t%s' % res.get(0.02))
                    break
                except multiprocessing.TimeoutError:
                    sys.stdout.write('.')
            print()
            print()

            print('Testing IMapIterator.next() with timeout:', end=' ')
            it = pool.imap(calculatestar, TASKS)
            while 1:
                sys.stdout.flush()
                try:
                    sys.stdout.write('\n\t%s' % it.next(0.02))
                except StopIteration:
                    break
                except multiprocessing.TimeoutError:
                    sys.stdout.write('.')
            print()
            print()

    if __name__ == '__main__':
        multiprocessing.freeze_support()
        test()

큐를 사용하여 작업을 작업자 프로세스 집단에 제공하고 결과를 수집하는 방법을 보여주는 예:

    import time
    import random

    from multiprocessing import Process, Queue, current_process, freeze_support

    #
    # Function run by worker processes
    #

    def worker(input, output):
        for func, args in iter(input.get, 'STOP'):
            result = calculate(func, args)
            output.put(result)

    #
    # Function used to calculate result
    #

    def calculate(func, args):
        result = func(*args)
        return '%s says that %s%s = %s' % \
            (current_process().name, func.__name__, args, result)

    #
    # Functions referenced by tasks
    #

    def mul(a, b):
        time.sleep(0.5*random.random())
        return a * b

    def plus(a, b):
        time.sleep(0.5*random.random())
        return a + b

    #
    #
    #

    def test():
        NUMBER_OF_PROCESSES = 4
        TASKS1 = [(mul, (i, 7)) for i in range(20)]
        TASKS2 = [(plus, (i, 8)) for i in range(10)]

        # Create queues
        task_queue = Queue()
        done_queue = Queue()

        # Submit tasks
        for task in TASKS1:
            task_queue.put(task)

        # Start worker processes
        for i in range(NUMBER_OF_PROCESSES):
            Process(target=worker, args=(task_queue, done_queue)).start()

        # Get and print results
        print('Unordered results:')
        for i in range(len(TASKS1)):
            print('\t', done_queue.get())

        # Add more tasks using `put()`
        for task in TASKS2:
            task_queue.put(task)

        # Get and print some more results
        for i in range(len(TASKS2)):
            print('\t', done_queue.get())

        # Tell child processes to stop
        for i in range(NUMBER_OF_PROCESSES):
            task_queue.put('STOP')

    if __name__ == '__main__':
        freeze_support()
        test()