"select" --- Waiting for I/O completion
***************************************

======================================================================

This module provides access to the "select()" and "poll()" functions
available in most operating systems, "devpoll()" available on Solaris
and derivatives, "epoll()" available on Linux 2.5+ and "kqueue()"
available on most BSD. Note that on Windows, it only works for
sockets; on other operating systems, it also works for other file
types (in particular, on Unix, it works on pipes). It cannot be used
on regular files to determine whether a file has grown since it was
last read.

참고:

  "selectors" 모듈은 "select" 모듈 프리미티브에 기반한 고수준의 효율적
  인 I/O 멀티플렉싱을 제공합니다. 사용되는 OS 수준 프리미티브에 대한
  정확한 제어를 원하지 않는 한, 사용자는 "selectors" 모듈을 대신 사용
  하는 것이 좋습니다.

가용성: not WASI.

이 모듈은 웹어셈블리에서 작동하지 않거나 제공되지 않습니다. 자세한 내
용은 WebAssembly platforms을 참조하세요.

모듈은 다음을 정의합니다:

exception select.error

   "OSError"의 폐지된 별칭.

   버전 3.3에서 변경: **PEP 3151**에 따라, 이 클래스는 "OSError"의 별
   칭이 되었습니다.

select.devpoll()

   (Solaris와 파생 제품에서만 지원됩니다.) "/dev/poll" 폴링(polling)
   객체를 반환합니다; devpoll 객체가 지원하는 메서드에 대해서는 아래의
   /dev/poll 폴링 객체 섹션을 참조하십시오.

   "devpoll()" objects are linked to the number of file descriptors
   allowed at the time of instantiation. If your program reduces this
   value, "devpoll()" will fail. If your program increases this value,
   "devpoll()" may return an incomplete list of active file
   descriptors.

   새 파일 기술자는 상속 불가능합니다.

   Added in version 3.3.

   버전 3.4에서 변경: 새 파일 기술자는 이제 상속 불가능합니다.

select.epoll(sizehint=-1, flags=0)

   (리눅스 2.5.44 이상에서만 지원됩니다.) I/O 이벤트를 위한 에지(Edge)
   나 레벨(Level) 트리거 되는 인터페이스로 사용할 수 있는 에지 폴링 객
   체를 반환합니다.

   *sizehint* informs epoll about the expected number of events to be
   registered.  It must be positive, or "-1" to use the default. It is
   only used on older systems where "epoll_create1()" is not
   available; otherwise it has no effect (though its value is still
   checked).

   *flags*는 폐지되었고 완전히 무시됩니다. 그러나, 제공되면, 값은 "0"
   이나 "select.EPOLL_CLOEXEC"여야 합니다. 그렇지 않으면 "OSError"가
   발생합니다.

   epolling 객체가 지원하는 메서드는 아래의 에지와 레벨 트리거 폴링
   (epoll) 객체 섹션을 참조하십시오.

   "epoll" 객체는 컨텍스트 관리자 프로토콜을 지원합니다: "with" 문에서
   사용될 때, 새 파일 기술자는 블록 끝에서 자동으로 닫힙니다.

   새 파일 기술자는 상속 불가능합니다.

   버전 3.3에서 변경: *flags* 매개 변수를 추가했습니다.

   버전 3.4에서 변경: "with" 문에 대한 지원이 추가되었습니다. 새로운
   파일 기술자는 이제 상속 불가능합니다.

   버전 3.4부터 폐지됨: *flags* 매개 변수. 이제 기본적으로
   "select.EPOLL_CLOEXEC"가 사용됩니다. 파일 기술자를 상속 가능하게 하
   려면 "os.set_inheritable()"을 사용하십시오.

select.poll()

   (모든 운영 체제에서 지원되는 것은 아닙니다.) 파일 기술자 등록과 등
   록 해지를 지원하고 그런 다음 I/O 이벤트에 대해 폴링하는 폴링 객체를
   반환합니다; 폴링 객체가 지원하는 메서드에 대해서는 아래의 폴링 객체
   섹션을 참조하십시오.

select.kqueue()

   (BSD에서만 지원됩니다.) 커널 큐 객체를 반환합니다; kqueue 객체가 지
   원하는 메서드에 대해서는 아래의 Kqueue 객체 섹션을 참조하십시오.

   새 파일 기술자는 상속 불가능합니다.

   버전 3.4에서 변경: 새 파일 기술자는 이제 상속 불가능합니다.

select.kevent(ident, filter=KQ_FILTER_READ, flags=KQ_EV_ADD, fflags=0, data=0, udata=0)

   (BSD에서만 지원됩니다.) 커널 이벤트 객체를 반환합니다. kevent 객체
   가 지원하는 메서드에 대해서는 아래의 Kevent 객체 섹션을 참조하십시
   오.

select.select(rlist, wlist, xlist[, timeout])

   This is a straightforward interface to the Unix "select()" system
   call. The first three arguments are iterables of 'waitable
   objects': either integers representing file descriptors or objects
   with a parameterless method named "fileno()" returning such an
   integer:

   * *rlist*: 읽을 준비가 될 때까지 기다립니다

   * *wlist*: 쓰기 준비가 될 때까지 기다립니다

   * *xlist*: "예외 조건"을 기다립니다 (시스템에서 어떤 것들을 이러한
     조건으로 간주하는지는 매뉴얼 페이지를 참조하십시오)

   Empty iterables are allowed, but acceptance of three empty
   iterables is platform-dependent. (It is known to work on Unix but
   not on Windows.)  The optional *timeout* argument specifies a time-
   out as a floating-point number in seconds.  When the *timeout*
   argument is omitted the function blocks until at least one file
   descriptor is ready.  A time-out value of zero specifies a poll and
   never blocks.

   반환 값은 준비된 객체의 리스트 3개입니다: 처음 세 인자의 부분 집합
   입니다. 파일 기술자가 준비되지 않고 시간제한에 도달하면, 세 개의 빈
   리스트가 반환됩니다.

   이터러블에서 허용되는 객체 형에는 파이썬 *파일 객체* (예를 들어
   "sys.stdin", 또는 "open()"이나 "os.popen()"에서 반환된 객체),
   "socket.socket()"에서 반환된 소켓 객체가 있습니다. 적절한 (단지 임
   의의 정수가 아니라 실제 파일 기술자를 반환하는) "fileno()" 메서드가
   있는 한, *래퍼 (wrapper)* 클래스를 직접 정의할 수도 있습니다.

   참고:

     File objects on Windows are not acceptable, but sockets are.  On
     Windows, the underlying "select()" function is provided by the
     WinSock library, and does not handle file descriptors that don't
     originate from WinSock.

   버전 3.5에서 변경: 시그널 처리기가 "InterruptedError"를 발생시키는
   대신 예외를 발생시키는 경우(이유는 **PEP 475**를 참조하십시오)를 제
   외하고, 시그널에 의해 인터럽트 될 때 다시 계산된 시간제한으로 함수
   가 다시 시도됩니다.

select.PIPE_BUF

   The minimum number of bytes which can be written without blocking
   to a pipe when the pipe has been reported as ready for writing by
   "select()", "poll()" or another interface in this module.  This
   doesn't apply to other kind of file-like objects such as sockets.

   이 값은 POSIX에서 512 이상이 되도록 보장합니다.

   가용성: Unix

   Added in version 3.2.


"/dev/poll" 폴링 객체
=====================

Solaris and derivatives have "/dev/poll". While "select()" is
*O*(*highest file descriptor*) and "poll()" is *O*(*number of file
descriptors*), "/dev/poll" is *O*(*active file descriptors*).

"/dev/poll" behaviour is very close to the standard "poll()" object.

devpoll.close()

   폴링 객체의 파일 기술자를 닫습니다.

   Added in version 3.4.

devpoll.closed

   폴링 객체가 닫혔으면 "True".

   Added in version 3.4.

devpoll.fileno()

   폴링 객체의 파일 기술자 번호를 반환합니다.

   Added in version 3.4.

devpoll.register(fd[, eventmask])

   폴링 객체에 파일 기술자를 등록합니다. 이후 "poll()" 메서드에 대한
   호출은 파일 기술자에 계류 중인 I/O 이벤트가 있는지 확인합니다. *fd*
   는 정수이거나, 정수를 반환하는 "fileno()" 메서드가 있는 객체일 수
   있습니다. 파일 객체는 "fileno()"를 구현하므로, 인자로도 사용할 수
   있습니다.

   *eventmask* is an optional bitmask describing the type of events
   you want to check for. The constants are the same that with
   "poll()" object. The default value is a combination of the
   constants "POLLIN", "POLLPRI", and "POLLOUT".

   경고:

     Registering a file descriptor that's already registered is not an
     error, but the result is undefined. The appropriate action is to
     unregister or modify it first. This is an important difference
     compared with "poll()".

devpoll.modify(fd[, eventmask])

   이 메서드는 "unregister()" 다음에 "register()"를 수행합니다. 명시적
   으로 같은 작업을 수행하는 것보다 조금 더 효율적입니다.

devpoll.unregister(fd)

   폴링 객체가 추적하는 파일 기술자를 제거합니다. "register()" 메서드
   와 마찬가지로, *fd*는 정수이거나 정수를 반환하는 "fileno()" 메서드
   가 있는 객체일 수 있습니다.

   등록되지 않은 파일 기술자를 제거하려고 하면 안전하게 무시됩니다.

devpoll.poll([timeout])

   Polls the set of registered file descriptors, and returns a
   possibly empty list containing "(fd, event)" 2-tuples for the
   descriptors that have events or errors to report. *fd* is the file
   descriptor, and *event* is a bitmask with bits set for the reported
   events for that descriptor --- "POLLIN" for waiting input,
   "POLLOUT" to indicate that the descriptor can be written to, and so
   forth. An empty list indicates that the call timed out and no file
   descriptors had any events to report. If *timeout* is given, it
   specifies the length of time in milliseconds which the system will
   wait for events before returning. If *timeout* is omitted, -1, or
   "None", the call will block until there is an event for this poll
   object.

   버전 3.5에서 변경: 시그널 처리기가 "InterruptedError"를 발생시키는
   대신 예외를 발생시키는 경우(이유는 **PEP 475**를 참조하십시오)를 제
   외하고, 시그널에 의해 인터럽트 될 때 다시 계산된 시간제한으로 함수
   가 다시 시도됩니다.


에지와 레벨 트리거 폴링 (epoll) 객체
====================================

   https://linux.die.net/man/4/epoll

   *eventmask*

   +---------------------------+-------------------------------------------------+
   | 상수                      | 의미                                            |
   |===========================|=================================================|
   | "EPOLLIN"                 | 읽기 가능                                       |
   +---------------------------+-------------------------------------------------+
   | "EPOLLOUT"                | 쓰기 가능                                       |
   +---------------------------+-------------------------------------------------+
   | "EPOLLPRI"                | 읽을 긴급 데이터                                |
   +---------------------------+-------------------------------------------------+
   | "EPOLLERR"                | 연관된 fd에서 에러 조건이 발생했습니다          |
   +---------------------------+-------------------------------------------------+
   | "EPOLLHUP"                | 연관된 fd에서 끊어짐(hang up)이 발생했습니다    |
   +---------------------------+-------------------------------------------------+
   | "EPOLLET"                 | 에지 트리거 동작을 설정합니다, 기본값은 레벨 트 |
   |                           | 리거 동작입니다                                 |
   +---------------------------+-------------------------------------------------+
   | "EPOLLONESHOT"            | 원샷(one-shot) 동작을 설정합니다. 하나의 이벤트 |
   |                           | 를 꺼낸 후에, fd는 내부적으로 비활성화됩니다.   |
   +---------------------------+-------------------------------------------------+
   | "EPOLLEXCLUSIVE"          | 연관된 fd에 이벤트가 있을 때 하나의 epoll 객체  |
   |                           | 만 깨웁니다. 기본값( 이 플래그가 설정되지 않으  |
   |                           | 면)은 fd를 폴링하는 모든 epoll 객체를 깨우 는   |
   |                           | 것입니다.                                       |
   +---------------------------+-------------------------------------------------+
   | "EPOLLRDHUP"              | 스트림 소켓 반대편이 연결을 닫았거나 연결의 쓰  |
   |                           | 기 절반을 종료했습니 다.                        |
   +---------------------------+-------------------------------------------------+
   | "EPOLLRDNORM"             | "EPOLLIN"과 동등합니다                          |
   +---------------------------+-------------------------------------------------+
   | "EPOLLRDBAND"             | 우선순위가 높은 데이터 대역을 읽을 수 있습니다. |
   +---------------------------+-------------------------------------------------+
   | "EPOLLWRNORM"             | "EPOLLOUT"과 동등합니다                         |
   +---------------------------+-------------------------------------------------+
   | "EPOLLWRBAND"             | 우선순위가 높은 데이터를 쓸 수 있습니다.        |
   +---------------------------+-------------------------------------------------+
   | "EPOLLMSG"                | 무시됩니다.                                     |
   +---------------------------+-------------------------------------------------+

   Added in version 3.6: "EPOLLEXCLUSIVE"가 추가되었습니다. 리눅스 커
   널 4.5 이상에서만 지원됩니다.

epoll.close()

   epoll 객체의 제어 파일 기술자를 닫습니다.

epoll.closed

   epoll 객체가 닫혔으면 "True".

epoll.fileno()

   제어 fd의 파일 기술자 번호를 반환합니다.

epoll.fromfd(fd)

   주어진 파일 기술자에서 epoll 객체를 만듭니다.

epoll.register(fd[, eventmask])

   epoll 객체에 fd 기술자를 등록합니다.

epoll.modify(fd, eventmask)

   등록된 파일 기술자를 수정합니다.

epoll.unregister(fd)

   epoll 객체에서 등록된 파일 기술자를 제거합니다.

   버전 3.9에서 변경: 이 메서드는 더는 "EBADF" 에러를 무시하지 않습니
   다.

epoll.poll(timeout=None, maxevents=-1)

   이벤트를 기다립니다. 시간제한은 초 단위입니다 (float)

   버전 3.5에서 변경: 시그널 처리기가 "InterruptedError"를 발생시키는
   대신 예외를 발생시키는 경우(이유는 **PEP 475**를 참조하십시오)를 제
   외하고, 시그널에 의해 인터럽트 될 때 다시 계산된 시간제한으로 함수
   가 다시 시도됩니다.


폴링 객체
=========

The "poll()" system call, supported on most Unix systems, provides
better scalability for network servers that service many, many clients
at the same time. "poll()" scales better because the system call only
requires listing the file descriptors of interest, while "select()"
builds a bitmap, turns on bits for the fds of interest, and then
afterward the whole bitmap has to be linearly scanned again.
"select()" is *O*(*highest file descriptor*), while "poll()" is
*O*(*number of file descriptors*).

poll.register(fd[, eventmask])

   폴링 객체에 파일 기술자를 등록합니다. 이후 "poll()" 메서드에 대한
   호출은 파일 기술자에 계류 중인 I/O 이벤트가 있는지 확인합니다. *fd*
   는 정수이거나, 정수를 반환하는 "fileno()" 메서드가 있는 객체일 수
   있습니다. 파일 객체는 "fileno()"를 구현하므로, 인자로도 사용할 수
   있습니다.

   *eventmask*는 확인할 이벤트 유형을 설명하는 선택적 비트 마스크이고,
   아래 표에 설명된 상수 "POLLIN", "POLLPRI" 및 "POLLOUT"의 조합일 수
   있습니다. 지정하지 않으면, 사용되는 기본값은 3가지 유형의 이벤트를
   모두 확인합니다.

   +---------------------+--------------------------------------------+
   | 상수                | 의미                                       |
   |=====================|============================================|
   | "POLLIN"            | 읽을 데이터가 있습니다                     |
   +---------------------+--------------------------------------------+
   | "POLLPRI"           | 읽을 긴급한 데이터가 있습니다              |
   +---------------------+--------------------------------------------+
   | "POLLOUT"           | 출력 준비: 쓰기가 블록 되지 않을 것입니다  |
   +---------------------+--------------------------------------------+
   | "POLLERR"           | 어떤 종류의 에러 조건                      |
   +---------------------+--------------------------------------------+
   | "POLLHUP"           | 끊어졌습니다(Hung up)                      |
   +---------------------+--------------------------------------------+
   | "POLLRDHUP"         | 스트림 소켓 반대편이 연결을 닫았거나, 연결 |
   |                     | 의 쓰기 절반을 종료했습니 다               |
   +---------------------+--------------------------------------------+
   | "POLLNVAL"          | 잘못된 요청: 기술자가 열리지 않았습니다    |
   +---------------------+--------------------------------------------+

   이미 등록된 파일 기술자를 등록하는 것은 에러가 아니며, 기술자를 정
   확히 한 번 등록하는 것과 같은 효과가 있습니다.

poll.modify(fd, eventmask)

   이미 등록된 fd를 수정합니다. 이것은 "register(fd, eventmask)"와 같
   은 효과가 있습니다. 등록되지 않은 파일 기술자를 수정하려고 하면
   errno "ENOENT"로 "OSError" 예외가 발생합니다.

poll.unregister(fd)

   폴링 객체가 추적하는 파일 기술자를 제거합니다. "register()" 메서드
   와 마찬가지로, *fd*는 정수이거나 정수를 반환하는 "fileno()" 메서드
   가 있는 객체일 수 있습니다.

   등록되지 않은 파일 기술자를 제거하려고 하면 "KeyError" 예외가 발생
   합니다.

poll.poll([timeout])

   Polls the set of registered file descriptors, and returns a
   possibly empty list containing "(fd, event)" 2-tuples for the
   descriptors that have events or errors to report. *fd* is the file
   descriptor, and *event* is a bitmask with bits set for the reported
   events for that descriptor --- "POLLIN" for waiting input,
   "POLLOUT" to indicate that the descriptor can be written to, and so
   forth. An empty list indicates that the call timed out and no file
   descriptors had any events to report. If *timeout* is given, it
   specifies the length of time in milliseconds which the system will
   wait for events before returning. If *timeout* is omitted,
   negative, or "None", the call will block until there is an event
   for this poll object.

   버전 3.5에서 변경: 시그널 처리기가 "InterruptedError"를 발생시키는
   대신 예외를 발생시키는 경우(이유는 **PEP 475**를 참조하십시오)를 제
   외하고, 시그널에 의해 인터럽트 될 때 다시 계산된 시간제한으로 함수
   가 다시 시도됩니다.


Kqueue 객체
===========

kqueue.close()

   kqueue 객체의 제어 파일 기술자를 닫습니다.

kqueue.closed

   kqueue 객체가 닫혔으면 "True".

kqueue.fileno()

   제어 fd의 파일 기술자 번호를 반환합니다.

kqueue.fromfd(fd)

   주어진 파일 기술자에서 kqueue 객체를 만듭니다.

kqueue.control(changelist, max_events[, timeout]) -> eventlist

   kevent에 대한 저수준 인터페이스

   * changelist는 kevent 객체의 이터러블 이거나 "None"이어야 합니다

   * max_events는 0이거나 양의 정수여야 합니다.

   * timeout은 초 단위 (float 가능); 기본값은 "None"이고 무한히 대기합
     니다

   버전 3.5에서 변경: 시그널 처리기가 "InterruptedError"를 발생시키는
   대신 예외를 발생시키는 경우(이유는 **PEP 475**를 참조하십시오)를 제
   외하고, 시그널에 의해 인터럽트 될 때 다시 계산된 시간제한으로 함수
   가 다시 시도됩니다.


Kevent 객체
===========

https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2

kevent.ident

   이벤트를 식별하는 데 사용되는 값. 해석은 필터에 따라 다르지만, 일반
   적으로 파일 기술자입니다. 생성자에서 ident 는 정수이거나 "fileno()"
   메서드가 있는 객체일 수 있습니다. kevent는 내부적으로 정수를 저장합
   니다.

kevent.filter

   커널 필터의 이름.

   +-----------------------------+-----------------------------------------------+
   | 상수                        | 의미                                          |
   |=============================|===============================================|
   | "KQ_FILTER_READ"            | 기술자를 취하고 읽을 수 있는 데이터가 있을 때 |
   |                             | 마다 반환합니다                               |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_WRITE"           | 기술자를 취하고 쓸 수 있는 데이터가 있을 때마 |
   |                             | 다 반환합니다                                 |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_AIO"             | AIO 요청                                      |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_VNODE"           | *fflag*에서 감시 중인 요청된 이벤트 중 하나   |
   |                             | 이상이 발생할 때 반환합 니다                  |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_PROC"            | 프로세스 id에서 이벤트를 감시합니다           |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_NETDEV"          | Watch for events on a network device [not     |
   |                             | available on macOS]                           |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_SIGNAL"          | 감시하는 시그널이 프로세스에 전달될 때마다 반 |
   |                             | 환합니다                                      |
   +-----------------------------+-----------------------------------------------+
   | "KQ_FILTER_TIMER"           | 임의의 타이머를 설정합니다                    |
   +-----------------------------+-----------------------------------------------+

kevent.flags

   필터 액션.

   +-----------------------------+-----------------------------------------------+
   | 상수                        | 의미                                          |
   |=============================|===============================================|
   | "KQ_EV_ADD"                 | 이벤트를 추가하거나 수정합니다                |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_DELETE"              | 큐에서 이벤트를 제거합니다                    |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_ENABLE"              | 이벤트를 반환하도록 Permitscontrol() 합니다   |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_DISABLE"             | 이벤트 비활성화                               |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_ONESHOT"             | 처음 발생한 후 이벤트를 제거합니다            |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_CLEAR"               | 이벤트를 꺼낸 후 상태를 재설정합니다          |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_SYSFLAGS"            | 내부 이벤트                                   |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_FLAG1"               | 내부 이벤트                                   |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_EOF"                 | 필터 특정 EOF 조건                            |
   +-----------------------------+-----------------------------------------------+
   | "KQ_EV_ERROR"               | 반환 값을 봅니다                              |
   +-----------------------------+-----------------------------------------------+

kevent.fflags

   필터 특정 플래그.

   "KQ_FILTER_READ"와 "KQ_FILTER_WRITE" 필터 플래그:

   +------------------------------+----------------------------------------------+
   | 상수                         | 의미                                         |
   |==============================|==============================================|
   | "KQ_NOTE_LOWAT"              | 소켓 버퍼의 낮은 수위(low water mark)        |
   +------------------------------+----------------------------------------------+

   "KQ_FILTER_VNODE" 필터 플래그:

   +------------------------------+----------------------------------------------+
   | 상수                         | 의미                                         |
   |==============================|==============================================|
   | "KQ_NOTE_DELETE"             | *unlink()*가 호출되었습니다                  |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_WRITE"              | 쓰기가 발생했습니다                          |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_EXTEND"             | 파일이 확장되었습니다                        |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_ATTRIB"             | 속성이 변경되었습니다                        |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_LINK"               | 링크 수가 변경되었습니다                     |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_RENAME"             | 파일 이름이 변경되었습니다                   |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_REVOKE"             | 파일에 대한 액세스가 취소되었습니다          |
   +------------------------------+----------------------------------------------+

   "KQ_FILTER_PROC" 필터 플래그:

   +------------------------------+----------------------------------------------+
   | 상수                         | 의미                                         |
   |==============================|==============================================|
   | "KQ_NOTE_EXIT"               | 프로세스가 종료되었습니다                    |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_FORK"               | 프로세스가 *fork()*를 호출했습니다           |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_EXEC"               | 프로세스가 새로운 프로세스를 실행했습니다    |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_PCTRLMASK"          | 내부 필터 플래그                             |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_PDATAMASK"          | 내부 필터 플래그                             |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_TRACK"              | *fork()*를 가로질러 프로세스를 추적합니다    |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_CHILD"              | *NOTE_TRACK*의 경우 자식 프로세스에서 반환됩 |
   |                              | 니다                                         |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_TRACKERR"           | 자식에게 연결할 수 없습니다                  |
   +------------------------------+----------------------------------------------+

   "KQ_FILTER_NETDEV" filter flags (not available on macOS):

   +------------------------------+----------------------------------------------+
   | 상수                         | 의미                                         |
   |==============================|==============================================|
   | "KQ_NOTE_LINKUP"             | 링크가 올라갔습니다                          |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_LINKDOWN"           | 링크가 내려갔습니다                          |
   +------------------------------+----------------------------------------------+
   | "KQ_NOTE_LINKINV"            | 링크 상태가 유효하지 않습니다                |
   +------------------------------+----------------------------------------------+

kevent.data

   필터 특정 데이터.

kevent.udata

   사용자 정의 값.
