dnotify.txt
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:3k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. Linux Directory Notification
  2. ============================
  3.    Stephen Rothwell <sfr@canb.auug.org.au>
  4. The intention of directory notification is to allow user applications
  5. to be notified when a directory, or any of the files in it, are changed.
  6. The basic mechanism involves the application registering for notification
  7. on a directory using a fcntl(2) call and the notifications themselves
  8. being delivered using signals.
  9. The application decides which "events" it wants to be notified about.
  10. The currently defined events are:
  11. DN_ACCESS A file in the directory was accessed (read)
  12. DN_MODIFY A file in the directory was modified (write,truncate)
  13. DN_CREATE A file was created in the directory
  14. DN_DELETE A file was unlinked from directory
  15. DN_RENAME A file in the directory was renamed
  16. DN_ATTRIB A file in the directory had its attributes
  17. changed (chmod,chown)
  18. Usually, the application must reregister after each notification, but
  19. if DN_MULTISHOT is or'ed with the event mask, then the registration will
  20. remain until explicitly removed (by registering for no events).
  21. By default, SIGIO will be delivered to the process and no other useful
  22. information.  However, if the F_SETSIG fcntl(2) call is used to let the
  23. kernel know which signal to deliver, a siginfo structure will be passed to
  24. the signal handler and the si_fd member of that structure will contain the
  25. file descriptor associated with the directory in which the event occurred.
  26. Preferably the application will choose one of the real time signals
  27. (SIGRTMIN + <n>) so that the notifications may be queued.  This is
  28. especially important if DN_MULTISHOT is specified.
  29. Implementation expectations (features and bugs :-))
  30. ---------------------------
  31. The notification should work for any local access to files even if the
  32. actual file system is on a remote server.  This implies that remote
  33. access to files served by local user mode servers should be notified.
  34. Also, remote accesses to files served by a local kernel NFS server should
  35. be notified.
  36. In order to make the impact on the file system code as small as possible,
  37. the problem of hard links to files has been ignored.  So if a file (x)
  38. exists in two directories (a and b) then a change to the file using the
  39. name "a/x" should be notified to a program expecting notifications on
  40. directory "a", but will not be notified to one expecting notifications on
  41. directory "b".
  42. Also, files that are unlinked, will still cause notifications in the
  43. last directory that they were linked to.
  44. Example
  45. -------
  46. #define _GNU_SOURCE /* needed to get the defines */
  47. #include <fcntl.h> /* in glibc 2.2 this has the needed
  48.    values defined */
  49. #include <signal.h>
  50. #include <stdio.h>
  51. #include <unistd.h>
  52. static volatile int event_fd;
  53. static void handler(int sig, siginfo_t *si, void *data)
  54. {
  55. event_fd = si->si_fd;
  56. }
  57. int main(void)
  58. {
  59. struct sigaction act;
  60. int fd;
  61. act.sa_sigaction = handler;
  62. sigemptyset(&act.sa_mask);
  63. act.sa_flags = SA_SIGINFO;
  64. sigaction(SIGRTMIN, &act, NULL);
  65. fd = open(".", O_RDONLY);
  66. fcntl(fd, F_SETSIG, SIGRTMIN);
  67. fcntl(fd, F_NOTIFY, DN_MODIFY|DN_CREATE|DN_MULTISHOT);
  68. /* we will now be notified if any of the files
  69.    in "." is modified or new files are created */
  70. while (1) {
  71. pause();
  72. printf("Got event on fd=%dn", event_fd);
  73. }
  74. }