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

Documentation/filesystems: fix title underline lengths in path-lookup.rst

Fix Sphinx warnings in path-lookup.rst:

Documentation/filesystems/path-lookup.rst:347: WARNING: Title underline too short.
Documentation/filesystems/path-lookup.rst:358: WARNING: Title underline too short.
[...]

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: NeilBrown <neilb@suse.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Randy Dunlap and committed by
Jonathan Corbet
9f63df26 bfeffd15

+12 -12
+12 -12
Documentation/filesystems/path-lookup.rst
··· 344 344 table, and the mount point hash table. 345 345 346 346 Bringing it together with ``struct nameidata`` 347 - -------------------------------------------- 347 + ---------------------------------------------- 348 348 349 349 .. _First edition Unix: http://minnie.tuhs.org/cgi-bin/utree.pl?file=V1/u2.s 350 350 ··· 355 355 other fields): 356 356 357 357 ``struct path path`` 358 - ~~~~~~~~~~~~~~~~~~ 358 + ~~~~~~~~~~~~~~~~~~~~ 359 359 360 360 A ``path`` contains a ``struct vfsmount`` (which is 361 361 embedded in a ``struct mount``) and a ``struct dentry``. Together these ··· 366 366 held. 367 367 368 368 ``struct qstr last`` 369 - ~~~~~~~~~~~~~~~~~~ 369 + ~~~~~~~~~~~~~~~~~~~~ 370 370 371 371 This is a string together with a length (i.e. _not_ ``nul`` terminated) 372 372 that is the "next" component in the pathname. 373 373 374 374 ``int last_type`` 375 - ~~~~~~~~~~~~~~~ 375 + ~~~~~~~~~~~~~~~~~ 376 376 377 377 This is one of ``LAST_NORM``, ``LAST_ROOT``, ``LAST_DOT``, ``LAST_DOTDOT``, or 378 378 ``LAST_BIND``. The ``last`` field is only valid if the type is ··· 381 381 fairly self-explanatory. 382 382 383 383 ``struct path root`` 384 - ~~~~~~~~~~~~~~~~~~ 384 + ~~~~~~~~~~~~~~~~~~~~ 385 385 386 386 This is used to hold a reference to the effective root of the 387 387 filesystem. Often that reference won't be needed, so this field is ··· 510 510 to three different flags that might be set in ``dentry->d_flags``: 511 511 512 512 ``DCACHE_MANAGE_TRANSIT`` 513 - ~~~~~~~~~~~~~~~~~~~~~~~ 513 + ~~~~~~~~~~~~~~~~~~~~~~~~~ 514 514 515 515 If this flag has been set, then the filesystem has requested that the 516 516 ``d_manage()`` dentry operation be called before handling any possible ··· 529 529 ``d_manage()`` by returning ``-EISDIR``. 530 530 531 531 ``DCACHE_MOUNTED`` 532 - ~~~~~~~~~~~~~~~~ 532 + ~~~~~~~~~~~~~~~~~~ 533 533 534 534 This flag is set on every dentry that is mounted on. As Linux 535 535 supports multiple filesystem namespaces, it is possible that the ··· 542 542 and a new ``dentry`` (both with counted references). 543 543 544 544 ``DCACHE_NEED_AUTOMOUNT`` 545 - ~~~~~~~~~~~~~~~~~~~~~~~ 545 + ~~~~~~~~~~~~~~~~~~~~~~~~~ 546 546 547 547 If ``d_manage()`` allowed us to get this far, and ``lookup_mnt()`` didn't 548 548 find a mount point, then this flag causes the ``d_automount()`` dentry ··· 698 698 the bigger picture of how RCU-walk uses seqlocks. 699 699 700 700 ``mount_lock`` and ``nd->m_seq`` 701 - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 701 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 702 702 703 703 We already met the ``mount_lock`` seqlock when REF-walk used it to 704 704 ensure that crossing a mount point is performed safely. RCU-walk uses ··· 727 727 at least for vfsmount structures. 728 728 729 729 ``dentry->d_seq`` and ``nd->seq`` 730 - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 730 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 731 731 732 732 In place of taking a count or lock on ``d_reflock``, RCU-walk samples 733 733 the per-dentry ``d_seq`` seqlock, and stores the sequence number in the ··· 774 774 the old dentry which we saw in REF-walk. 775 775 776 776 No ``inode->i_rwsem`` or even ``rename_lock`` 777 - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 777 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 778 778 779 779 A semaphore is a fairly heavyweight lock that can only be taken when it is 780 780 permissible to sleep. As ``rcu_read_lock()`` forbids sleeping, ··· 796 796 rename_lock would bring no significant value. 797 797 798 798 ``unlazy walk()`` and ``complete_walk()`` 799 - ------------------------------------- 799 + ----------------------------------------- 800 800 801 801 That "dropping down to REF-walk" typically involves a call to 802 802 ``unlazy_walk()``, so named because "RCU-walk" is also sometimes