€•å<      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ1/translations/zh_CN/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/zh_TW/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/it_IT/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ja_JP/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ko_KR/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/sp_SP/filesystems/automount-support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒK/var/lib/git/docbuild/linux/Documentation/filesystems/automount-support.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒAutomount Support”h]”hŒAutomount Support”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hX&  Support is available for filesystems that wish to do automounting
support (such as kAFS which can be found in fs/afs/ and NFS in
fs/nfs/). This facility includes allowing in-kernel mounts to be
performed and mountpoint degradation to be requested. The latter can
also be requested by userspace.”h]”hX&  Support is available for filesystems that wish to do automounting
support (such as kAFS which can be found in fs/afs/ and NFS in
fs/nfs/). This facility includes allowing in-kernel mounts to be
performed and mountpoint degradation to be requested. The latter can
also be requested by userspace.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒIn-Kernel Automounting”h]”hŒIn-Kernel Automounting”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÙhžhhŸh³h KubhÊ)”}”(hŒBSee section "Mount Traps" of  Documentation/filesystems/autofs.rst”h]”hŒFSee section â€œMount Trapsâ€ of  Documentation/filesystems/autofs.rst”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhÊ)”}”(hŒ5Then from userspace, you can just do something like::”h]”hŒ4Then from userspace, you can just do something like:”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhŒliteral_block”“”)”}”(hX  [root@andromeda root]# mount -t afs \#root.afs. /afs
[root@andromeda root]# ls /afs
asd  cambridge  cambridge.redhat.com  grand.central.org
[root@andromeda root]# ls /afs/cambridge
afsdoc
[root@andromeda root]# ls /afs/cambridge/afsdoc/
ChangeLog  html  LICENSE  pdf  RELNOTES-1.2.2”h]”hX  [root@andromeda root]# mount -t afs \#root.afs. /afs
[root@andromeda root]# ls /afs
asd  cambridge  cambridge.redhat.com  grand.central.org
[root@andromeda root]# ls /afs/cambridge
afsdoc
[root@andromeda root]# ls /afs/cambridge/afsdoc/
ChangeLog  html  LICENSE  pdf  RELNOTES-1.2.2”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h KhhÙhžhubhÊ)”}”(hŒMAnd then if you look in the mountpoint catalogue, you'll see something like::”h]”hŒNAnd then if you look in the mountpoint catalogue, youâ€™ll see something like:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubj  )”}”(hŒ¬[root@andromeda root]# cat /proc/mounts
...
#root.afs. /afs afs rw 0 0
#root.cell. /afs/cambridge.redhat.com afs rw 0 0
#afsdoc. /afs/cambridge.redhat.com/afsdoc afs rw 0 0”h]”hŒ¬[root@andromeda root]# cat /proc/mounts
...
#root.afs. /afs afs rw 0 0
#root.cell. /afs/cambridge.redhat.com afs rw 0 0
#afsdoc. /afs/cambridge.redhat.com/afsdoc afs rw 0 0”…””}”hj$  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h K hhÙhžhubeh}”(h]”Œin-kernel-automounting”ah ]”h"]”Œin-kernel automounting”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒAutomatic Mountpoint Expiry”h]”hŒAutomatic Mountpoint Expiry”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj:  hžhhŸh³h K(ubhÊ)”}”(hŒ”Automatic expiration of mountpoints is easy, provided you've mounted the
mountpoint to be expired in the automounting procedure outlined separately.”h]”hŒ–Automatic expiration of mountpoints is easy, provided youâ€™ve mounted the
mountpoint to be expired in the automounting procedure outlined separately.”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K*hj:  hžhubhÊ)”}”(hŒ1To do expiration, you need to follow these steps:”h]”hŒ1To do expiration, you need to follow these steps:”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K-hj:  hžhubhŒblock_quote”“”)”}”(hX#  (1) Create at least one list off which the vfsmounts to be expired can be
    hung.

(2) When a new mountpoint is created in the ->d_automount method, add
    the mnt to the list using mnt_set_expiry()::

            mnt_set_expiry(newmnt, &afs_vfsmounts);

(3) When you want mountpoints to be expired, call mark_mounts_for_expiry()
    with a pointer to this list. This will process the list, marking every
    vfsmount thereon for potential expiry on the next call.

    If a vfsmount was already flagged for expiry, and if its usage count is 1
    (it's only referenced by its parent vfsmount), then it will be deleted
    from the namespace and thrown away (effectively unmounted).

    It may prove simplest to simply call this at regular intervals, using
    some sort of timed event to drive it.
”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒLCreate at least one list off which the vfsmounts to be expired can be
hung.
”h]”hÊ)”}”(hŒKCreate at least one list off which the vfsmounts to be expired can be
hung.”h]”hŒKCreate at least one list off which the vfsmounts to be expired can be
hung.”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K/hjt  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jr  hjo  ubjs  )”}”(hŒ When a new mountpoint is created in the ->d_automount method, add
the mnt to the list using mnt_set_expiry()::

        mnt_set_expiry(newmnt, &afs_vfsmounts);
”h]”(hÊ)”}”(hŒnWhen a new mountpoint is created in the ->d_automount method, add
the mnt to the list using mnt_set_expiry()::”h]”hŒmWhen a new mountpoint is created in the ->d_automount method, add
the mnt to the list using mnt_set_expiry():”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K2hjŒ  ubj  )”}”(hŒ'mnt_set_expiry(newmnt, &afs_vfsmounts);”h]”hŒ'mnt_set_expiry(newmnt, &afs_vfsmounts);”…””}”hjž  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h K5hjŒ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jr  hjo  ubjs  )”}”(hX  When you want mountpoints to be expired, call mark_mounts_for_expiry()
with a pointer to this list. This will process the list, marking every
vfsmount thereon for potential expiry on the next call.

If a vfsmount was already flagged for expiry, and if its usage count is 1
(it's only referenced by its parent vfsmount), then it will be deleted
from the namespace and thrown away (effectively unmounted).

It may prove simplest to simply call this at regular intervals, using
some sort of timed event to drive it.
”h]”(hÊ)”}”(hŒÅWhen you want mountpoints to be expired, call mark_mounts_for_expiry()
with a pointer to this list. This will process the list, marking every
vfsmount thereon for potential expiry on the next call.”h]”hŒÅWhen you want mountpoints to be expired, call mark_mounts_for_expiry()
with a pointer to this list. This will process the list, marking every
vfsmount thereon for potential expiry on the next call.”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K7hj²  ubhÊ)”}”(hŒÌIf a vfsmount was already flagged for expiry, and if its usage count is 1
(it's only referenced by its parent vfsmount), then it will be deleted
from the namespace and thrown away (effectively unmounted).”h]”hŒÎIf a vfsmount was already flagged for expiry, and if its usage count is 1
(itâ€™s only referenced by its parent vfsmount), then it will be deleted
from the namespace and thrown away (effectively unmounted).”…””}”(hjÄ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K;hj²  ubhÊ)”}”(hŒkIt may prove simplest to simply call this at regular intervals, using
some sort of timed event to drive it.”h]”hŒkIt may prove simplest to simply call this at regular intervals, using
some sort of timed event to drive it.”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K?hj²  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jr  hjo  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”Œ(”Œsuffix”Œ)”uh1jm  hji  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jg  hŸh³h K/hj:  hžhubhÊ)”}”(hŒ°The expiration flag is cleared by calls to mntput. This means that expiration
will only happen on the second expiration request after the last time the
mountpoint was accessed.”h]”hŒ°The expiration flag is cleared by calls to mntput. This means that expiration
will only happen on the second expiration request after the last time the
mountpoint was accessed.”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KBhj:  hžhubhÊ)”}”(hŒ»If a mountpoint is moved, it gets removed from the expiration list. If a bind
mount is made on an expirable mount, the new vfsmount will not be on the
expiration list and will not expire.”h]”hŒ»If a mountpoint is moved, it gets removed from the expiration list. If a bind
mount is made on an expirable mount, the new vfsmount will not be on the
expiration list and will not expire.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KFhj:  hžhubhÊ)”}”(hŒ­If a namespace is copied, all mountpoints contained therein will be copied,
and the copies of those that are on an expiration list will be added to the
same expiration list.”h]”hŒ­If a namespace is copied, all mountpoints contained therein will be copied,
and the copies of those that are on an expiration list will be added to the
same expiration list.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KJhj:  hžhubeh}”(h]”Œautomatic-mountpoint-expiry”ah ]”h"]”Œautomatic mountpoint expiry”ah$]”h&]”uh1h´hh¶hžhhŸh³h K(ubhµ)”}”(hhh]”(hº)”}”(hŒUserspace Driven Expiry”h]”hŒUserspace Driven Expiry”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj*  hžhhŸh³h KPubhÊ)”}”(hX'  As an alternative, it is possible for userspace to request expiry of any
mountpoint (though some will be rejected - the current process's idea of the
rootfs for example). It does this by passing the MNT_EXPIRE flag to
umount(). This flag is considered incompatible with MNT_FORCE and MNT_DETACH.”h]”hX)  As an alternative, it is possible for userspace to request expiry of any
mountpoint (though some will be rejected - the current processâ€™s idea of the
rootfs for example). It does this by passing the MNT_EXPIRE flag to
umount(). This flag is considered incompatible with MNT_FORCE and MNT_DETACH.”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KRhj*  hžhubhÊ)”}”(hŒÌIf the mountpoint in question is in referenced by something other than
umount() or its parent mountpoint, an EBUSY error will be returned and the
mountpoint will not be marked for expiration or unmounted.”h]”hŒÌIf the mountpoint in question is in referenced by something other than
umount() or its parent mountpoint, an EBUSY error will be returned and the
mountpoint will not be marked for expiration or unmounted.”…””}”(hjI  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KWhj*  hžhubhÊ)”}”(hŒzIf the mountpoint was not already marked for expiry at that time, an EAGAIN
error will be given and it won't be unmounted.”h]”hŒ|If the mountpoint was not already marked for expiry at that time, an EAGAIN
error will be given and it wonâ€™t be unmounted.”…””}”(hjW  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K[hj*  hžhubhÊ)”}”(hŒaOtherwise if it was already marked and it wasn't referenced, unmounting will
take place as usual.”h]”hŒcOtherwise if it was already marked and it wasnâ€™t referenced, unmounting will
take place as usual.”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K^hj*  hžhubhÊ)”}”(hŒdAgain, the expiration flag is cleared every time anything other than umount()
looks at a mountpoint.”h]”hŒdAgain, the expiration flag is cleared every time anything other than umount()
looks at a mountpoint.”…””}”(hjs  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kahj*  hžhubeh}”(h]”Œuserspace-driven-expiry”ah ]”h"]”Œuserspace driven expiry”ah$]”h&]”uh1h´hh¶hžhhŸh³h KPubeh}”(h]”Œautomount-support”ah ]”h"]”Œautomount support”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j´  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jŽ  j‹  j7  j4  j'  j$  j†  jƒ  uŒ	nametypes”}”(jŽ  ‰j7  ‰j'  ‰j†  ‰uh}”(j‹  h¶j4  hÙj$  j:  jƒ  j*  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.