Ссылка FSEvents

Значение по умолчанию.

Платформа вызовет Вашу функцию обратного вызова с типами CF, а не сырыми данными C типы (т.е. CFArrayRef CFStringRefs, а не сырые данные C массив необработанных указателей струны до). Посмотрите FSEventStreamCallback.

Влияет на значение параметра задержки. При указании этого флага и больше, чем секунды задержки протекли начиная с последнего события приложение сразу получит событие. Поставка события сбрасывает таймер задержки, и дальнейшие события будут поставлены после того, как секунды задержки протекли. Этот флаг полезен для приложений, которые являются интерактивными и хотят реагировать сразу на изменения, но избегать затопляться уведомлениями, когда изменения являются occurringin быстрой преемственностью. Если Вы не указываете этот флаг, то, когда событие имеет место после периода никаких событий, таймер задержки запущен. Любые события, происходящие в течение следующих секунд задержки, будут поставлены как одна группа (включая то первое событие). Поставка группы событий сбрасывает таймер задержки, и дальнейшие события будут поставлены после секунд задержки. Это - поведение по умолчанию и более подходяще для фона, демона или приложений пакетной обработки.

Уведомления запроса об изменениях вдоль пути к пути (ям) Вы смотрите. Например, с этим флагом, если бы Вы наблюдаете «/foo/bar» и он переименован к «/foo/bar.old», Вы получили бы событие RootChanged. Если каталог «/foo» был переименован, то же является истиной. Событие, которое Вы получаете, является специальным мероприятием: путь для события является первоначальным трактом, который Вы указали, флаг kFSEventStreamEventFlagRootChanged установлен, и идентификатор события является нулем. События RootChanged полезны, чтобы указать, что необходимо повторно отсканировать определенную иерархию, потому что она изменилась полностью (в противоположность вещам в нем изменение). Если Вы хотите отследить текущее расположение каталога, лучше открывать каталог прежде, чем создать поток так, чтобы Вы имели дескриптор файла для него и могли выпустить F_GETPATH fcntl () для нахождения текущего пути.

Не отправляйте события, инициированные текущим процессом. Это полезно для сокращения объема отправляющихся событий. Если Ваш процесс мог бы изменить иерархию файловой системы ниже контролируемого пути (ей), только полезно.Примечание: это не имеет никакого эффекта на исторические события, т.е. поставленных перед событием сигнальной метки HistoryDone.

Уведомления уровня файла запроса. Ваш поток получит события об отдельных файлах в иерархии, которую Вы наблюдаете вместо того, чтобы только получить уведомления уровня каталога. Используйте этот флаг с осторожностью, поскольку это генерирует значительно больше событий, чем без него.

Было некоторое изменение в каталоге в определенном пути, предоставленном в этом случае.

Ваше приложение должно повторно отсканировать не только каталог, данный в конечном счете, но и все его дочерние элементы, рекурсивно. Это может произойти, если была проблема, посредством чего события были объединены иерархически. Например, событие в/Users/jsmith/Music и событие в/Users/jsmith/Pictures могли бы быть объединены в событие с этим набором флага и путем =/Users/jsmith. Если этот флаг установлен, можно быть в состоянии понять то, произошло ли узкое место в ядре (менее вероятно) или в клиенте (более вероятно) путем проверки на присутствие информационных флагов kFSEventStreamEventFlagUserDropped или kFSEventStreamEventFlagKernelDropped.

kFSEventStreamEventFlagUserDropped или флаги kFSEventStreamEventFlagKernelDropped могут быть установлены в дополнение к флагу kFSEventStreamEventFlagMustScanSubDirs указать, что проблема произошла в буферизации событий (определенный набор флага указывает, где проблема произошла), и что клиент должен сделать полное сканирование любых каталогов (и их подкаталоги, рекурсивно) быть контролируемым этим потоком. Если Вы попросили контролировать разнообразные пути с этим потоком тогда, Вы будете уведомлены обо всех них. Ваша потребность кода только проверяет на флаг kFSEventStreamEventFlagMustScanSubDirs; эти флаги (если есть) только предоставляют информацию, чтобы помочь Вам диагностировать проблему.

Если kFSEventStreamEventFlagEventIdsWrapped установлен, это означает 64-разрядный перенесенный счетчик идентификатора события. В результате ранее выпущенный идентификатор события является больше не действительными параметрами за sinceWhen параметр FSEventStreamCreate... () функции.

Обозначает событие сигнальной метки, отправленное для маркировки конца «исторических» событий, отправленных в результате указания значения sinceWhen в FSEventStreamCreate... () вызов, создавший этот поток событий. (Это не будет отправлено, если kFSEventStreamEventIdSinceNow был передан для sinceWhen.) После вызова обратного вызова клиента со всеми «историческими» событиями, произошедшими до настоящего времени, обратный вызов клиента будет вызван с событием, где установлен флаг kFSEventStreamEventFlagHistoryDone. Клиент должен проигнорировать путь, предоставленный в этом обратном вызове.

Обозначает специальное мероприятие, отправленное, когда существует изменение в одном из каталогов вдоль пути к одному из каталогов, которые Вы попросили смотреть. Когда этот флаг установлен, идентификатор события является нулем, и путь соответствует одному из путей, которые Вы попросили наблюдать (в частности, тот, изменившийся). Путь больше может не существовать, потому что он или один из его родителей был удален или переименован. События с этим набором флага будут только отправлены, если Вы передали флаг kFSEventStreamCreateFlagWatchRoot FSEventStreamCreate... () при создании потока.

Когда объем смонтирован под одним из контролируемых путей, обозначает специальное мероприятие, отправленное. Путь в конечном счете является путем к недавно смонтированному объему. Вы получите одно из этих уведомлений для каждого объема, монтируют событие в ядре (независимый от DiskArbitration). Остерегайтесь этого, недавно смонтированный объем мог содержать произвольно большую иерархию каталогов. Избегите ловушек как инициирование рекурсивного сканирования нелокальной файловой системы, которую можно обнаружить путем проверки на отсутствие флага MNT_LOCAL в f_flags, возвращенном statfs (). Также знайте о флаге MNT_DONTBROWSE, установленном для объемов, которые не должны быть выведены на экран элементами пользовательского интерфейса.

Когда объем размонтирован под одним из контролируемых путей, обозначает специальное мероприятие, отправленное. Путь в конечном счете является путем к каталогу, из которого был размонтирован объем. Вы получите одно из этих уведомлений для каждого события размонтирования объема в ядре. Это не замена для уведомлений, предоставленных платформой DiskArbitration; Вы только уведомляетесь после того, как размонтирование произошло. Остерегайтесь то размонтирование объема могло раскрыть произвольно большую иерархию каталогов, несмотря на то, что OS X никогда не делает это.