Ссылка vnode.h

Обсуждение

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

Обсуждение

если работой cn_nameiop будет CREATE или RENAME, cache_lookup () сбросит отрицательные записи кэша и возвратится 0. Часто используемый от файловой системы во время поиска vnop. Файловую систему вызовут, к тому, если будет отрицательная запись кэша для файла, таким образом, это может быть целесообразно первоначально проверять на отрицательные записи (и возможно пышный их).

Обсуждение

Сбросит весь hardlinks к vnode, а также все дочерние элементы (должен любой существовать). Логичный для использования, когда кэшированные данные о vnode становятся недопустимыми, например в расцеплении.

Обсуждение

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

Обсуждение

Для регулярного файла просто возвратитесь (usecount-kusecount); для файлов устройств возвратите сумму по всему vnodes 'v' который ссылка что устройство (usecount (v) - kusecount (v)). Обратите внимание на то, что это - просто снимок и могло быть недопустимо к тому времени, когда вызывающая сторона проверяет результат.

Обсуждение

Эта функция используется для убирания vnodes, связанного с монтированием как часть процесса размонтирования. Его параметры могут определить, какой vnodes пропустить в процессе и нужно ли в отношении используемого vnodes насильственно предъявить претензии. Файловые системы должны вызвать эту функцию от своего кода размонтирования, потому что код VFS будет всегда вызывать его с SKIPROOT | SKIPSWAP | SKIPSYSTEM; файловые системы должны заботиться о таком vnodes сами. SKIPSYSTEM пропускают отмеченный VSYSTEM vnodes FORCECLOSE, файл силы closeure WRITECLOSE только закрывают writeable файлы, SKIPSWAP пропускают отмеченный VSWAP vnodes SKIPROOT, корень пропуска vnodes отметил VROOT

Обсуждение

vnode_update_identity () и vnode_create () делают vfs_addname () ненужным для kexts.

Обсуждение

Контекст должен быть выпущен с vfs_context_rele () когда больше в использовании.

Обсуждение

Kexts не должен использовать эту функцию - это предпочтено для использования vfs_context_create (NULL) и vfs_context_rele (), которые гарантируют надлежащий подсчет ссылок глубинных структур.

Обсуждение

Битовое поле создается с помощью sigmask () макрос, в смысле битов | = sigmask (SIGSEGV).

Обсуждение

На контекст нельзя сослаться после того, как vfs_context_rele вызвали.

Обсуждение

Успешно выполняется, если и только если контекст имеет поток, поток имеет задачу, и задача имеет BSD proc.

Обсуждение

vnode_update_identity () и vnode_create () делают vfs_addname () ненужным для kexts.

Обсуждение

Вызывающая сторона должна vnode_put () корневой узел, когда сделано.

Обсуждение

Эта подпрограмма доступна для файловых систем, не хотящих реализовывать их собственный «bwrite» vnop. Это просто вызывает buf_bwrite (), не изменяя его параметры.

Обсуждение

Пути к vnodes являются не всегда прямыми: файл с многократными жесткими ссылками будет иметь многократные пути, и иногда невозможно определить полный путь vnode. vn_getpath () не введет файловую систему.

Обсуждение

Определяет, является ли расширение на пути известным типом расширения OS X.

Обсуждение

vn_rdwr () абстрагирует подробные данные построения uio и выбора vnode работы для разрешения простого файлового ввода-вывода в ядре.

Обсуждение

Предъявляет претензии в отношении vnode, давая ему deadfs vnops (хотя не останавливающиеся операции, уже происходящие). Также предъявляет претензии, все исказили vnodes (важный для устройств). Люди, содержащие usecounts на vnode, например, процессах с открытым файлом, найдут, что все последующие операции, но закрытие файла перестало работать.

Обсуждение

Должен только быть вызван один раз на vnode, и никогда если бы это vnode создавалось с VNFS_ADDFSREF. Должен быть соответствующий вызов к vnode_removefsref (), когда в отношении vnode предъявляют претензии; VFS предполагает, что n неиспользованный vnode не будет отмечен, как ссылается файловой системой.

Обсуждение

vnode_authorize требует действий kauth-стиля; если мы хотим установить vnode_attr структуру на vnode, мы должны перевести набор атрибутов к ряду действий kauth-стиля. Эта подпрограмма возвратит ошибки, наверняка, очевидно, запрещенные или несвязные, действия.

Обсуждение

vnode_authattr_new () заполнит значения unitialized в vnode_attr структуре со значениями по умолчанию и проверит структуру относительно текущего контекста для создания файла.

Обсуждение

Операции на мертвом vnodes всегда позволяются (хотя никогда ничего не делают).

Обсуждение

Когда vnode больше не используется, т.е. во время VNOP_RECLAIM, эту подпрограмму нужно только вызвать.

Обсуждение

vnode_close () отбрасывает refcount (персистентная ссылка) взятый в vnode_open () и раскритиковывает к файловой системе с VNOP_CLOSE. Это нужно вызвать и с iocount и с refcount на vnode и отбросит обоих.

Обсуждение

Возвраты wth iocount держались vnode, который должен в конечном счете быть отброшен с vnode_put ().

Обсуждение

Если vnode_get () успешно выполняется, получающаяся io-ссылка должна быть отброшена с vnode_put (). Эта функция успешно выполняется, если vnode рассматриваемое не мертво, или в процессе умирающего AND текущий iocount является нулем. Это означает, что может блокировать продолжающееся предъявление претензий, блокирующееся позади некоторого другого iocount.

На успехе vnode_get () возвраты с iocount держались vnode; этот тип ссылки предназначается, чтобы быть сохраненным только в течение коротких промежутков времени (например, через вызов функции) и предоставляет сильную гарантию о жизни vnode; vnodes с положительным iocounts не может быть переработан, и iocount требуется для любой работы на vnode. Однако vnode_get () не предоставляет гарантий об идентификационных данных vnode, к этому обращаются; если нет известный существующий iocount на vnode во время, вызов выполняется, это могло быть переработано и отложено в использовании, прежде чем vnode_get () успешно выполнится, таким образом, вызывающая сторона может ссылаться на абсолютно различный vnode, чем было предназначено. vnode_getwithref () и vnode_getwithvid () предоставляют гарантии о vnode идентификационных данных.

Обсуждение

Желаемые атрибуты установлены с VATTR_SET_ACTIVE и VNODE_ATTR* макросы. Поддерживаемые атрибуты определяются после вызова с VATTR_IS_SUPPORTED.

Обсуждение

Не все vnodes имеют имена, и имена vnode могут измениться (особенно, hardlinks). Используйте эту подпрограмму на ваш собственный риск. Строка возвращается с refcount, постепенно увеличенным в кэше; вызывающие стороны должны вызвать vnode_putname () для выпуска той ссылки.

Обсуждение

Родитель vnode может изменяться в течение долгого времени или быть предъявлен претензии, таким образом, vnode_getparent () может возвратить различные результаты в разное время (например, многократный-hardlink файл). Родитель возвращается с iocount, который должен впоследствии быть отброшен с vnode_put ().

Обсуждение

Если vnode_getwithref () успешно выполняется, получающаяся io-ссылка должна быть отброшена с vnode_put (). vnode_getwithref () успешно выполнится на мертвом vnodes; это должно перестать работать с ENOENT на vnodes, которые находятся в процессе того, чтобы быть предъявленным претензии. Поскольку это только вызывают с usecount на vnode, вызывающей стороне гарантируют это, vnode не был снова использован для различного файла, хотя это может теперь быть мертво и иметь deadfs vnops (которые возвращают ошибки как EIO, ENXIO, ENOTDIR). На успехе vnode_getwithref () возвраты с iocount держались vnode; этот тип ссылки предназначается, чтобы быть сохраненным только в течение коротких промежутков времени (например, через вызов функции) и предоставляет сильную гарантию о жизни vnode. vnodes с положительным iocounts, не может быть переработан. iocount требуется для любой работы на vnode.

Обсуждение

Если vnode_getwithvid () успешно выполняется, получающаяся io-ссылка должна быть отброшена с vnode_put (). Эта функция успешно выполняется, если vnode рассматриваемое не мертво, в процессе смерти, или было переработано (и дано различный vnode ID). Намеченное использование состоит в том, что vnode сохранен и его vid (vnode_vid (vp)) зарегистрированный, в то время как iocount сохранен (пример: хеш файловой системы). iocount тогда отбрасывается, и передачи времени (возможно, блокировки отбрасываются и взяли назад). Впоследствии, vnode_getwithvid () вызывается для получения iocount, но мы предупреждены, если был переработан vnode.

На успехе vnode_getwithvid () возвраты с iocount держались vnode; этот тип ссылки предназначается, чтобы быть сохраненным только в течение коротких промежутков времени (например, через вызов функции) и предоставляет сильную гарантию о жизни vnode. vnodes с положительным iocounts, не может быть переработан. iocount требуется для любой работы на vnode.

Обсуждение

Обратите внимание на то, что эта подпрограмма не синхронизируется; это - только снимок, и его результат может прекратить быть истиной в данный момент, это возвращается..

Обсуждение

Обратите внимание на то, что эта подпрограмма не синхронизируется; это - только снимок, и его результат может прекратить быть истиной в данный момент, это возвращается..

Обсуждение

vnode_isinuse () сравнивает usecount vnode (соответствующий vnode_ref () вызовы) к его refcnt параметру (число ссылок, вызывающая сторона ожидает быть на vnode). Обратите внимание на то, что ссылки «kusecount», соответствуя сторонам, заинтересованным только уведомлениями о событии, например, открытым (..., O_EVTONLY), не считаются к общему количеству; сравнение (usecount - kusecount> recnt). Также важно отметить, что результатом является только снимок; usecounts может измениться с момента до момента, и результат vnode_isinuse больше может не быть корректным самый момент, что вызывающая сторона получает его.

Обсуждение

Обратите внимание на то, что это - только снимок; монтирование может начаться или закончиться в любое время.

Обсуждение

Блочное устройство, отмеченное как смонтированный на, не может быть открыто.

Обсуждение

Это - только снимок: vnode может начать перерабатываться или перейти от мертвых в в использовании в любое время.

Обсуждение

Пропуски vnodes, которые мертвы, в процессе предъявления претензий, приостановленного, или типа VNON.

Обсуждение

Эта подпрограмма является тонкой оберткой вокруг xnu-внутренних подпрограмм поиска; в случае успеха, это возвращается с iocount, держался получающийся vnode, который должен быть отброшен с vnode_put ().

Обсуждение

Если vnode_open () успешно выполняется, он возвращается и с iocount и с usecount на возвращенном vnode. Они должны быть выпущены в конечном счете; iocount должен быть выпущен с vnode_put (), как только любые начальные операции на vnode закончены, тогда как usecount должен быть выпущен через vnode_close ().

Обсуждение

vnode_put () вызывают, чтобы указать, что vnode больше не находится в активном использовании. Это удаляет гарантию, что не будет переработан vnode. Эта подпрограмма должна использоваться для выпуска io ссылок независимо от того, как они были получены.

Обсуждение

Должен быть вызван на строке, полученной с vnode_getname ().

Обсуждение

Как весь vnode KPIs, должен быть вызван с iocount на цели vnode. когда все существующие ссылки будут отброшены, vnode_recycle () отметит это vnode для предъявления претензий.

Обсуждение

Если vnode_ref () успешно выполняется, получающийся usecount должен быть выпущен с vnode_rele (). vnode_ref () вызывают для получения персистентной ссылки на vnode. Этот тип ссылки не предоставляет ту же сильную гарантию, которую сохранит vnode, как делает iocount - это просто гарантирует, что vnode не будет снова использован для представления различного файла. Однако usecount может быть сохранен в течение длительных периодов времени, тогда как iocount предназначается, чтобы быть полученным и выпущенным быстро как часть выполнения vnode работы. Держатель usecount должен вызвать vnode_getwithref ()/vnode_put () для выполнения любых операций на этом vnode.

Обсуждение

vnode_rele () вызывают к relese персистентной ссылкой на vnode. Выпуск последнего usecount открывает дверь для vnode, который будет снова использован как новый файл; это также инициировало вызов VNOP_INACTIVE к файловой системе, хотя это сразу не произойдет, если будут выдающиеся iocount ссылки.

Обсуждение

Должен только быть вызван один раз на vnode (во время предъявления претензий), и только после того, как vnode был или создан с VNFS_ADDFSREF или отмечен vnode_addfsref ().

Обсуждение

Атрибуты для установки отмечены с VATTR_SET_ACTIVE и VNODE_ATTR* макросы. Атрибуты успешно набор определяются после вызова с VATTR_IS_SUPPORTED.

Обсуждение

Блочное устройство, отмеченное как смонтированный на, не может быть открыто.

Обсуждение

«Многопутевой» vnodes может быть достигнут посредством больше чем одной записи в файловой системе, и так должен быть обработан по-другому в целях уведомления о событии и кэшировании. Файловая система должна отметить vnode с многократным hardlinks этот путь.

Обсуждение

Устанавливает тег, указывающий, какая файловая система vnode принадлежит, например, VT_HFS, VT_UDF, VT_ZFS. Ядро никогда не проверяет эти данные, хотя теги файловой системы определяются в vnode.h; это в пользу пользовательских программ через getattrlist.

Обсуждение

Также будит потоки, ожидающие количества записи для отбрасывания, как в vnode_waitforwrites.

Обсуждение

Получает тег, указывающий, какая файловая система vnode принадлежит, например, VT_HFS, VT_UDF, VT_ZFS. Ядро никогда не проверяет эти данные, хотя теги файловой системы определяются в vnode.h; это в пользу пользовательских программ через getattrlist.

Обсуждение

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

Обсуждение

vfs namecache является центральным к отслеживанию данных vnode-идентификации и к располагающимся файлам в системе. vnode_update_identity () используется для обновления vnode данных, связанных с кэшем. Это может установить родителя и/или имя vnode (также потенциально установленный vnode_create ()) или сбрасывать данные кэша.

Обсуждение

Это - архаичная конструкция; большинство файловых систем присваивается число типа на основе порядка, в котором они регистрируются в системе.

Обсуждение

Также будит потоки, ожидающие количества записи для отбрасывания, как в vnode_waitforwrites.