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

docs: filesystems: convert dnotify.txt to ReST

- Add a SPDX header;
- Add a document title;
- Some whitespace fixes and new line breaks;
- Add table markups;
- Add it to filesystems/index.rst

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: Jan Kara <jack@suse.cz>
Link: https://lore.kernel.org/r/b39d6430d1c28438e833f01cb4597eff78703c75.1588021877.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Mauro Carvalho Chehab and committed by
Jonathan Corbet
b31763cf 01478b83

+10 -4
+8 -3
Documentation/filesystems/dnotify.txt Documentation/filesystems/dnotify.rst
··· 1 - Linux Directory Notification 2 - ============================ 1 + .. SPDX-License-Identifier: GPL-2.0 2 + 3 + ============================ 4 + Linux Directory Notification 5 + ============================ 3 6 4 7 Stephen Rothwell <sfr@canb.auug.org.au> 5 8 ··· 15 12 The application decides which "events" it wants to be notified about. 16 13 The currently defined events are: 17 14 15 + ========= ===================================================== 18 16 DN_ACCESS A file in the directory was accessed (read) 19 17 DN_MODIFY A file in the directory was modified (write,truncate) 20 18 DN_CREATE A file was created in the directory ··· 23 19 DN_RENAME A file in the directory was renamed 24 20 DN_ATTRIB A file in the directory had its attributes 25 21 changed (chmod,chown) 22 + ========= ===================================================== 26 23 27 24 Usually, the application must reregister after each notification, but 28 25 if DN_MULTISHOT is or'ed with the event mask, then the registration will ··· 41 36 is often blocked, so it is better to use (at least) SIGRTMIN + 1. 42 37 43 38 Implementation expectations (features and bugs :-)) 44 - --------------------------- 39 + --------------------------------------------------- 45 40 46 41 The notification should work for any local access to files even if the 47 42 actual file system is on a remote server. This implies that remote
+1
Documentation/filesystems/index.rst
··· 25 25 locking 26 26 directory-locking 27 27 devpts 28 + dnotify 28 29 29 30 automount-support 30 31
+1 -1
MAINTAINERS
··· 4996 4996 R: Amir Goldstein <amir73il@gmail.com> 4997 4997 L: linux-fsdevel@vger.kernel.org 4998 4998 S: Maintained 4999 - F: Documentation/filesystems/dnotify.txt 4999 + F: Documentation/filesystems/dnotify.rst 5000 5000 F: fs/notify/dnotify/ 5001 5001 F: include/linux/dnotify.h 5002 5002