Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: filesystems: convert automount-support.txt to ReST

- Add a SPDX header;
- Add a document title;
- Adjust section titles;
- Mark literal blocks as such;
- Add it to filesystems/index.rst.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/ba7e2f2bf9aa2c7096772f5e7e8e609cb5fce07c.1588021877.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Mauro Carvalho Chehab and committed by
Jonathan Corbet
41defb4d 175cc46f

+16 -9
+14 -9
Documentation/filesystems/automount-support.txt Documentation/filesystems/automount-support.rst
··· 1 + .. SPDX-License-Identifier: GPL-2.0 2 + 3 + ================= 4 + Automount Support 5 + ================= 6 + 7 + 1 8 Support is available for filesystems that wish to do automounting 2 9 support (such as kAFS which can be found in fs/afs/ and NFS in 3 10 fs/nfs/). This facility includes allowing in-kernel mounts to be ··· 12 5 also be requested by userspace. 13 6 14 7 15 - ====================== 16 - IN-KERNEL AUTOMOUNTING 8 + In-Kernel Automounting 17 9 ====================== 18 10 19 11 See section "Mount Traps" of Documentation/filesystems/autofs.rst 20 12 21 - Then from userspace, you can just do something like: 13 + Then from userspace, you can just do something like:: 22 14 23 15 [root@andromeda root]# mount -t afs \#root.afs. /afs 24 16 [root@andromeda root]# ls /afs ··· 27 21 [root@andromeda root]# ls /afs/cambridge/afsdoc/ 28 22 ChangeLog html LICENSE pdf RELNOTES-1.2.2 29 23 30 - And then if you look in the mountpoint catalogue, you'll see something like: 24 + And then if you look in the mountpoint catalogue, you'll see something like:: 31 25 32 26 [root@andromeda root]# cat /proc/mounts 33 27 ... ··· 36 30 #afsdoc. /afs/cambridge.redhat.com/afsdoc afs rw 0 0 37 31 38 32 39 - =========================== 40 - AUTOMATIC MOUNTPOINT EXPIRY 33 + Automatic Mountpoint Expiry 41 34 =========================== 42 35 43 36 Automatic expiration of mountpoints is easy, provided you've mounted the ··· 48 43 hung. 49 44 50 45 (2) When a new mountpoint is created in the ->d_automount method, add 51 - the mnt to the list using mnt_set_expiry() 46 + the mnt to the list using mnt_set_expiry():: 47 + 52 48 mnt_set_expiry(newmnt, &afs_vfsmounts); 53 49 54 50 (3) When you want mountpoints to be expired, call mark_mounts_for_expiry() ··· 76 70 same expiration list. 77 71 78 72 79 - ======================= 80 - USERSPACE DRIVEN EXPIRY 73 + Userspace Driven Expiry 81 74 ======================= 82 75 83 76 As an alternative, it is possible for userspace to request expiry of any
+2
Documentation/filesystems/index.rst
··· 25 25 locking 26 26 directory-locking 27 27 28 + automount-support 29 + 28 30 caching/index 29 31 30 32 porting