> **Источник:** https://python-all.ru/3.16/library/select.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `select` – Ожидание завершения ввода-вывода

---

Этот модуль предоставляет доступ к функциям `select()` и `poll()`, доступным в большинстве операционных систем, `devpoll()` – на Solaris и производных, `epoll()` – на Linux 2.5+ и `kqueue()` – на большинстве BSD. Обратите внимание: в Windows он работает только с сокетами; в других ОС он также работает с другими типами файлов (в частности, в Unix – с каналами). Его нельзя использовать для обычных файлов, чтобы определить, увеличился ли файл с момента последнего чтения.

> **Примечание**
>
> Модуль [`selectors`](https://python-all.ru/3.16/library/selectors.html#module-selectors) предоставляет высокоуровневую и эффективную мультиплексацию ввода-вывода, построенную на примитивах модуля `select`. Пользователям рекомендуется использовать модуль `selectors`, если только им не требуется точный контроль над используемыми низкоуровневыми примитивами ОС.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): не WASI.

Этот модуль не работает или недоступен на WebAssembly. Подробнее см. [платформы WebAssembly](https://python-all.ru/3.16/library/intro.html#wasm-availability).

Модуль определяет следующее:

#### `exception select.error`

Устаревший псевдоним [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError).

Изменено в версии 3.3: В соответствии с [**PEP 3151**](https://python-all.ru/3.16/library/select.html) этот класс стал псевдонимом [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError).

#### `select.devpoll()`

Возвращает объект `/dev/poll` опроса; см. раздел [Объекты опроса /dev/poll](https://python-all.ru/3.16/library/select.html#devpoll-objects) ниже для получения информации о методах, поддерживаемых объектами devpoll.

Объекты `devpoll()` привязаны к количеству файловых дескрипторов, разрешённых на момент создания. Если программа уменьшает это значение, `devpoll()` завершится ошибкой. Если программа увеличивает это значение, `devpoll()` может вернуть неполный список активных файловых дескрипторов.

Новый файловый дескриптор является [ненаследуемым](https://python-all.ru/3.16/library/os.html#fd-inheritance).

Добавлено в версии 3.3.

Изменено в версии 3.4: Новый файловый дескриптор теперь не наследуется.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): Solaris.

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

Возвращает объект опроса по фронту, который можно использовать как интерфейс с триггером по фронту или уровню для событий ввода-вывода.

*sizehint* сообщает epoll ожидаемое количество регистрируемых событий. Он должен быть положительным, или `-1`, чтобы использовать значение по умолчанию. Он используется только в старых системах, где *[epoll\_create1(2)](https://python-all.ru/3.16/library/select.html)* недоступен; в противном случае он не имеет эффекта (хотя его значение всё равно проверяется).

Параметр *flags* устарел и полностью игнорируется. Однако, если он указан, его значение должно быть `0` или `select.EPOLL_CLOEXEC`, иначе возбуждается `OSError`.

См. раздел [Объекты опроса с триггером по фронту и уровню (epoll)](https://python-all.ru/3.16/library/select.html#epoll-objects) ниже для получения информации о методах, поддерживаемых объектами epoll.

Объекты `epoll` поддерживают протокол менеджера контекста: при использовании в инструкции [`with`](https://python-all.ru/3.16/reference/compound_stmts.html#with) новый файловый дескриптор автоматически закрывается в конце блока.

Новый файловый дескриптор является [ненаследуемым](https://python-all.ru/3.16/library/os.html#fd-inheritance).

Изменено в версии 3.3: Добавлен параметр *flags*.

Изменено в версии 3.4: Добавлена поддержка инструкции [`with`](https://python-all.ru/3.16/reference/compound_stmts.html#with). Теперь новый файловый дескриптор является ненаследуемым.

Устарело с версии 3.4: Параметр *flags*. Теперь по умолчанию используется `select.EPOLL_CLOEXEC`. Используйте [`os.set_inheritable()`](https://python-all.ru/3.16/library/os.html#os.set_inheritable), чтобы сделать файловый дескриптор наследуемым.

Изменено в версии 3.15: при сборке CPython эта функция может быть отключена с помощью [`--disable-epoll`](https://python-all.ru/3.16/using/configure.html#cmdoption-disable-epoll).

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): Linux \>= 2.5.44.

#### `select.poll()`

Возвращает объект опроса, который поддерживает регистрацию и отмену регистрации файловых дескрипторов, а затем их опрос на предмет событий ввода-вывода; см. раздел [Объекты опроса](https://python-all.ru/3.16/library/select.html#poll-objects) ниже для получения информации о методах, поддерживаемых объектами опроса.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): Unix.

#### `select.kqueue()`

Возвращает объект очереди ядра; см. раздел [Объекты Kqueue](https://python-all.ru/3.16/library/select.html#kqueue-objects) ниже для получения информации о методах, поддерживаемых объектами kqueue.

Новый файловый дескриптор является [ненаследуемым](https://python-all.ru/3.16/library/os.html#fd-inheritance).

Изменено в версии 3.4: Новый файловый дескриптор теперь не наследуется.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): BSD, macOS.

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

Возвращает объект события ядра; см. раздел [Объекты Kevent](https://python-all.ru/3.16/library/select.html#kevent-objects) ниже для получения информации о методах, поддерживаемых объектами kevent.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): BSD, macOS.

#### `select.select(rlist, wlist, xlist, timeout=None)`

Это простой интерфейс к системному вызову `select()` Unix. Первые три аргумента – это итерируемые объекты «ожидаемых объектов»: целые числа, представляющие файловые дескрипторы, или объекты с методом без параметров с именем [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno), возвращающим такое целое число:

- *rlist*: ожидать готовности к чтению
- *wlist*: ожидать готовности к записи
- *xlist*: ожидать «исключительного условия» (см. справочную страницу для того, что ваша система считает таким условием)

Пустые итерируемые объекты допускаются, но принятие трёх пустых итерируемых объектов зависит от платформы. (Известно, что работает на Unix, но не на Windows.) Необязательный аргумент *timeout* задаёт тайм-аут в секундах; он может быть нецелым числом для указания долей секунды. Когда аргумент *timeout* опущен или равен `None`, функция блокируется, пока хотя бы один файловый дескриптор не будет готов. Значение тайм-аута, равное нулю, задаёт опрос и никогда не блокирует.

Возвращаемое значение – тройка списков готовых объектов: подмножества первых трех аргументов. Когда тайм-аут истекает без готовности файлового дескриптора, возвращаются три пустых списка.

Среди допустимых типов объектов в итерируемых – [файловые объекты](https://python-all.ru/3.16/glossary.html#term-file-object) Python (например, `sys.stdin` или объекты, возвращаемые [`open()`](https://python-all.ru/3.16/library/functions.html#open) или [`os.popen()`](https://python-all.ru/3.16/library/os.html#os.popen)), сокетные объекты, возвращаемые [`socket.socket()`](https://python-all.ru/3.16/library/socket.html#socket.socket). Вы также можете самостоятельно определить *класс-обёртку*, если он имеет подходящий метод [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno) (который действительно возвращает файловый дескриптор, а не случайное целое число).

> **Примечание**
>
> Файловые объекты в Windows недопустимы, но сокеты – да. В Windows базовая функция `select()` предоставляется библиотекой WinSock и не обрабатывает файловые дескрипторы, не происходящие из WinSock.

Изменено в версии 3.5: Функция теперь повторяется с пересчитанным тайм-аутом при прерывании сигналом, за исключением случая, когда обработчик сигнала вызывает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/select.html) для обоснования), вместо вызова [`InterruptedError`](https://python-all.ru/3.16/library/exceptions.html#InterruptedError).

Изменено в версии 3.15: принимает любое вещественное число в качестве *timeout*, а не только целое или float.

#### `select.PIPE_BUF`

Минимальное количество байтов, которое можно записать без блокировки в канал, когда канал был сообщен как готовый к записи с помощью [`select()`](https://python-all.ru/3.16/library/select.html#select.select), `poll()` или другого интерфейса в этом модуле. Это не относится к другим видам файлоподобных объектов, таким как сокеты.

Это значение гарантируется POSIX равным не менее 512.

[Доступность](https://python-all.ru/3.16/library/intro.html#availability): Unix

Добавлено в версии 3.2.

## `/dev/poll` объекты опроса

Solaris и его производные имеют `/dev/poll`. В то время как `select()` является *O*(*наибольший файловый дескриптор*) и `poll()` является *O*(*количество файловых дескрипторов*), `/dev/poll` является *O*(*активные файловые дескрипторы*).

Поведение `/dev/poll` очень близко к стандартному объекту `poll()`.

#### `devpoll.close()`

Закрывает файловый дескриптор объекта опроса.

Добавлено в версии 3.4.

#### `devpoll.closed`

`True` если объект опроса закрыт.

Добавлено в версии 3.4.

#### `devpoll.fileno()`

Возвращает номер файлового дескриптора объекта опроса.

Добавлено в версии 3.4.

#### `devpoll.register(fd[, eventmask])`

Регистрирует файловый дескриптор в объекте опроса. Последующие вызовы метода [`poll()`](https://python-all.ru/3.16/library/select.html#select.poll) будут проверять, есть ли у файлового дескриптора ожидающие события ввода-вывода. *fd* может быть целым числом или объектом с методом [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno), возвращающим целое число. Файловые объекты реализуют `fileno()`, поэтому их тоже можно использовать в качестве аргумента.

*eventmask* – необязательная битовая маска, описывающая тип событий, которые требуется проверять. Константы те же, что и для объекта `poll()`. Значение по умолчанию представляет собой комбинацию констант `POLLIN`, `POLLPRI` и `POLLOUT`.

> **Предупреждение**
>
> Регистрация уже зарегистрированного файлового дескриптора не является ошибкой, но результат не определен. Правильным действием будет сначала отменить регистрацию или изменить его. Это важное отличие от `poll()`.

#### `devpoll.modify(fd[, eventmask])`

Этот метод выполняет [`unregister()`](https://python-all.ru/3.16/library/select.html#select.devpoll.unregister) с последующим [`register()`](https://python-all.ru/3.16/library/select.html#select.devpoll.register). Он (немного) эффективнее, чем делать то же самое явно.

#### `devpoll.unregister(fd)`

Удаляет файловый дескриптор, отслеживаемый объектом опроса. Как и метод [`register()`](https://python-all.ru/3.16/library/select.html#select.devpoll.register), *fd* может быть целым числом или объектом с методом [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno), возвращающим целое число.

Попытка удалить файловый дескриптор, который никогда не был зарегистрирован, безопасно игнорируется.

#### `devpoll.poll([timeout])`

Опрашивает набор зарегистрированных файловых дескрипторов и возвращает возможно пустой список, содержащий кортежи из двух элементов `(fd, event)` для дескрипторов, у которых есть события или ошибки. *fd* – это файловый дескриптор, а *event* – битовая маска с установленными битами для сообщенных событий этого дескриптора: `POLLIN` – ожидание ввода, `POLLOUT` – указывает, что в дескриптор можно писать, и так далее. Пустой список означает, что вызов завершился по тайм-ауту и ни у одного файлового дескриптора не было событий. Если указан *timeout*, он задает время в миллисекундах, в течение которого система будет ждать событий перед возвратом. Если *timeout* опущен, равен -1 или [`None`](https://python-all.ru/3.16/library/constants.html#None), вызов будет блокироваться до появления события для этого объекта poll.

Изменено в версии 3.5: Функция теперь повторяется с пересчитанным тайм-аутом при прерывании сигналом, за исключением случая, когда обработчик сигнала вызывает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/select.html) для обоснования), вместо вызова [`InterruptedError`](https://python-all.ru/3.16/library/exceptions.html#InterruptedError).

Изменено в версии 3.15: принимает любое вещественное число в качестве *timeout*, а не только целое или float.

## Объекты опроса с триггерами по переднему и уровневому фронту (epoll)

> [https://linux.die.net/man/4/epoll](https://python-all.ru/3.16/library/select.html)
>
> *eventmask* – это битовая маска, использующая следующие константы:
>
> | Константа | Значение |
> | --- | --- |
> | `EPOLLIN` | Доступен для чтения. |
> | `EPOLLOUT` | Доступен для записи. |
> | `EPOLLPRI` | Срочные данные для чтения. |
> | `EPOLLERR` | На связанном fd произошла ошибка. |
> | `EPOLLHUP` | На связанном fd произошел разрыв соединения. |
> | `EPOLLET` | Устанавливает поведение триггера по переднему фронту; по умолчанию – поведение триггера по уровню. |
> | `EPOLLONESHOT` | Устанавливает однократное поведение. После извлечения одного события файловый дескриптор внутренне отключается. |
> | `EPOLLEXCLUSIVE` | Пробуждает только один объект epoll при событии на связанном fd. По умолчанию (если этот флаг не установлен) пробуждаются все объекты epoll, ожидающие на этом fd. |
> | `EPOLLRDHUP` | Потоковый сокет: удаленная сторона закрыла соединение или завершила записывающую половину соединения. |
> | `EPOLLRDNORM` | Эквивалентно `EPOLLIN` |
> | `EPOLLRDBAND` | Полоса приоритетных данных доступна для чтения. |
> | `EPOLLWRNORM` | Эквивалентно `EPOLLOUT`. |
> | `EPOLLWRBAND` | Приоритетные данные могут быть записаны. |
> | `EPOLLMSG` | Игнорируется. |
> | `EPOLLWAKEUP` | Предотвращает ожидание во время ожидания событий. |
>
> Добавлено в версии 3.6: `EPOLLEXCLUSIVE` был добавлен. Поддерживается только ядром Linux 4.5 и новее.
>
> Добавлено в версии 3.14: `EPOLLWAKEUP` был добавлен. Поддерживается только ядром Linux 3.5 и новее.

#### `epoll.close()`

Закрывает управляющий файловый дескриптор объекта epoll.

#### `epoll.closed`

`True`, если объект epoll закрыт.

#### `epoll.fileno()`

Возвращает номер файлового дескриптора управляющего fd.

#### `epoll.fromfd(fd)`

Создает объект epoll из заданного файлового дескриптора.

#### `epoll.register(fd[, eventmask])`

Регистрирует файловый дескриптор *fd* в объекте epoll.

#### `epoll.modify(fd, eventmask)`

Изменяет зарегистрированный файловый дескриптор *fd*.

#### `epoll.unregister(fd)`

Удаляет зарегистрированный файловый дескриптор из объекта epoll.

Изменено в версии 3.9: Метод больше не игнорирует ошибку [`EBADF`](https://python-all.ru/3.16/library/errno.html#errno.EBADF).

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

Ожидание событий. Если задан *timeout*, он определяет время ожидания в секундах (может быть нецелым), в течение которого система будет ждать события перед возвратом.

Изменено в версии 3.5: Функция теперь повторяется с пересчитанным тайм-аутом при прерывании сигналом, за исключением случая, когда обработчик сигнала вызывает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/select.html) для обоснования), вместо вызова [`InterruptedError`](https://python-all.ru/3.16/library/exceptions.html#InterruptedError).

Изменено в версии 3.15: принимает любое вещественное число в качестве *timeout*, а не только целое или float.

## Объекты опроса (polling)

Системный вызов `poll()`, поддерживаемый в большинстве Unix-систем, обеспечивает лучшую масштабируемость для сетевых серверов, обслуживающих одновременно множество клиентов. `poll()` масштабируется лучше, поскольку системный вызов требует только перечисления интересующих файловых дескрипторов, тогда как `select()` строит битовую маску, устанавливает биты для интересующих fd, а затем всю битовую маску нужно снова линейно сканировать. `select()` имеет сложность *O*(*наибольший файловый дескриптор*), тогда как `poll()` – *O*(*количество файловых дескрипторов*).

#### `poll.register(fd[, eventmask])`

Регистрирует файловый дескриптор в объекте опроса. Последующие вызовы метода [`poll()`](https://python-all.ru/3.16/library/select.html#select.poll) будут проверять, есть ли у файлового дескриптора ожидающие события ввода-вывода. *fd* может быть целым числом или объектом с методом [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno), возвращающим целое число. Файловые объекты реализуют `fileno()`, поэтому их тоже можно использовать в качестве аргумента.

*eventmask* – необязательная битовая маска, описывающая типы событий для проверки. Может быть комбинацией констант `POLLIN`, `POLLPRI` и `POLLOUT`, описанных в таблице ниже. Если не указана, по умолчанию проверяются все три типа событий.

| Константа | Значение |
| --- | --- |
| `POLLIN` | Есть данные для чтения. |
| `POLLPRI` | Есть срочные данные для чтения. |
| `POLLOUT` | Готов к выводу: запись не будет блокироваться. |
| `POLLERR` | Ошибка какого-либо рода. |
| `POLLHUP` | Разъединение. |
| `POLLRDHUP` | Удаленный сокет потока закрыл соединение или завершил запись на своей стороне. |
| `POLLNVAL` | Недопустимый запрос: дескриптор не открыт. |

Регистрация уже зарегистрированного файлового дескриптора не является ошибкой и имеет тот же эффект, как если бы дескриптор был зарегистрирован ровно один раз.

#### `poll.modify(fd, eventmask)`

Изменяет уже зарегистрированный fd. Это имеет тот же эффект, что и `register(fd, eventmask)`. Попытка изменить файловый дескриптор, который никогда не был зарегистрирован, приводит к возбуждению исключения [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError) с errno `ENOENT`.

#### `poll.unregister(fd)`

Удаляет файловый дескриптор, отслеживаемый объектом опроса. Как и метод [`register()`](https://python-all.ru/3.16/library/select.html#select.poll.register), *fd* может быть целым числом или объектом с методом [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno), возвращающим целое число.

Попытка удалить файловый дескриптор, который никогда не был зарегистрирован, приводит к возбуждению исключения [`KeyError`](https://python-all.ru/3.16/library/exceptions.html#KeyError).

#### `poll.poll([timeout])`

Опрашивает набор зарегистрированных файловых дескрипторов и возвращает, возможно, пустой список, содержащий `(fd, event)` кортежи из двух элементов для дескрипторов, по которым есть события или ошибки. *fd* – файловый дескриптор, а *event* – битовая маска с установленными битами для сообщаемых событий этого дескриптора: `POLLIN` для ожидания ввода, `POLLOUT` для указания, что в дескриптор можно писать, и так далее. Пустой список означает, что вызов завершился по таймауту и ни у одного файлового дескриптора не было событий. Если указан *timeout*, он задает время ожидания в миллисекундах, в течение которого система будет ожидать события перед возвратом. Если *timeout* опущен, отрицателен или равен [`None`](https://python-all.ru/3.16/library/constants.html#None), вызов будет блокироваться до появления события для этого объекта опроса.

Изменено в версии 3.5: Функция теперь повторяется с пересчитанным тайм-аутом при прерывании сигналом, за исключением случая, когда обработчик сигнала вызывает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/select.html) для обоснования), вместо вызова [`InterruptedError`](https://python-all.ru/3.16/library/exceptions.html#InterruptedError).

Изменено в версии 3.15: Принимает любое вещественное число в качестве *timeout*, а не только целое число или число с плавающей точкой. Если доступна функция `ppoll()`, *timeout* имеет разрешение `1` нс (`1e-6` мс) вместо `1` мс.

## Объекты Kqueue

#### `kqueue.close()`

Закрывает файловый дескриптор управления объекта kqueue.

#### `kqueue.closed`

`True`, если объект kqueue закрыт.

#### `kqueue.fileno()`

Возвращает номер файлового дескриптора управляющего fd.

#### `kqueue.fromfd(fd)`

Создаёт объект kqueue из заданного файлового дескриптора.

#### `kqueue.control(changelist, max_events[, timeout]) → eventlist`

Низкоуровневый интерфейс к kevent

- changelist должен быть итерируемым объектом, содержащим объекты kevent, или `None`
- max\_events должен быть 0 или положительным целым числом
- время ожидания в секундах (допускаются нецелые числа); по умолчанию `None`, ждать бесконечно

Изменено в версии 3.5: Функция теперь повторяется с пересчитанным тайм-аутом при прерывании сигналом, за исключением случая, когда обработчик сигнала вызывает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/select.html) для обоснования), вместо вызова [`InterruptedError`](https://python-all.ru/3.16/library/exceptions.html#InterruptedError).

Изменено в версии 3.15: Принимает любое вещественное число в качестве *timeout*, а не только целое число или число с плавающей точкой.

## Объекты kevent

[https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2](https://python-all.ru/3.16/library/select.html)

#### `kevent.ident`

Значение, используемое для идентификации события. Интерпретация зависит от фильтра, но обычно это файловый дескриптор. В конструкторе ident может быть либо целым числом, либо объектом с методом [`fileno()`](https://python-all.ru/3.16/library/io.html#io.IOBase.fileno). kevent хранит целое число внутри.

#### `kevent.filter`

Имя фильтра ядра.

| Константа | Значение |
| --- | --- |
| `KQ_FILTER_READ` | Принимает дескриптор и возвращает результат, когда doступны данные для чтения. |
| `KQ_FILTER_WRITE` | Принимает дескриптор и возвращает результат, когда doступны данные для записи. |
| `KQ_FILTER_AIO` | Запросы AIO. |
| `KQ_FILTER_VNODE` | Возвращает результат, когда происходит одно или несколько запрошенных событий, отслеживаемых в *fflag*. |
| `KQ_FILTER_PROC` | Отслеживает события для идентификатора процесса. |
| `KQ_FILTER_NETDEV` | Отслеживает события на сетевом устройстве (недоступно в macOS). |
| `KQ_FILTER_SIGNAL` | Возвращает результат, когда отслеживаемый сигнал doставляется процессу. |
| `KQ_FILTER_TIMER` | Устанавливает произвольный таймер. |

#### `kevent.flags`

Действие фильтра.

| Константа | Значение |
| --- | --- |
| `KQ_EV_ADD` | Добавляет или изменяет событие. |
| `KQ_EV_DELETE` | Удаляет событие из очереди. |
| `KQ_EV_ENABLE` | Разрешает control() возвращать событие. |
| `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` | Нижний водяной знак буфера сокета. |

`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` флаги фильтра (недоступны в macOS):

| Константа | Значение |
| --- | --- |
| `KQ_NOTE_LINKUP` | Соединение активно. |
| `KQ_NOTE_LINKDOWN` | Соединение неактивно. |
| `KQ_NOTE_LINKINV` | Состояние соединения некорректно. |

#### `kevent.data`

Данные, специфичные для фильтра.

#### `kevent.udata`

Пользовательское значение.