Linux Certif

Toute la documentation sur la certification Linux LPI

inotify_add_watch

̾Á°

inotify_add_watch - ½é´ü²½ºÑ¤ß inotify ¥¤¥ó¥¹¥¿¥ó¥¹¤Ë´Æ»ëÂоݤòÄɲ乤ë

½ñ¼°

#include <sys/inotify.h>

int inotify_add_watch(int fd, const char *pathname, uint32_t mask);

ÀâÌÀ

inotify_add_watch() ¤Ï¡¢ pathname ¤Ç»ØÄꤵ¤ì¤¿°ÌÃ֤ˤ¢¤ë¥Õ¥¡¥¤¥ë¤ò´Æ»ë¤¹¤ë´Æ»ë¥¢¥¤¥Æ¥à (watch) ¤Î¿·µ¬Äɲᢠ¤Þ¤¿¤Ï´û¸¤Î´Æ»ë¥¢¥¤¥Æ¥à¤ÎÊѹ¹¤ò¹Ô¤¦¡£ ¸Æ¤Ó½Ð¤·¸µ¤Ï¡¢´Æ»ëÂоݤΥե¡¥¤¥ë¤ËÂФ¹¤ëÆɤ߽Ф·µö²Ä¤ò »ý¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£ fd °ú¤­¿ô¤Ï¡¢Êѹ¹¤ò¹Ô¤¦´Æ»ëÂоݥꥹ¥È (watch list) ¤ò»ý¤Ä inotify ¥¤¥ó¥¹¥¿¥ó¥¹¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤¢¤ë¡£ pathname ¤Î¤É¤Î¥¤¥Ù¥ó¥È¤ò´Æ»ë¤¹¤ë¤«¤Ï¡¢°ú¤­¿ô¤Î¥Ó¥Ã¥È¥Þ¥¹¥¯ mask ¤Ç»ØÄꤹ¤ë¡£ mask ¤ËÀßÄê¤Ç¤­¤ë¥Ó¥Ã¥È¤ÎÀâÌÀ¤Ë¤Ä¤¤¤Æ¤Ï inotify(7) ¤ò»²¾È¤Î¤³¤È¡£

inotify_add_watch() ¤Î¸Æ¤Ó½Ð¤·¤¬À®¸ù¤¹¤ë¤È¡¢Êѹ¹ÂоݤΠinotify ¥¤¥ó¥¹¥¿¥ó¥¹¤Ç pathname ¤ËÂбþÉÕ¤±¤é¤ì¤ë°ì°Õ¤Ê´Æ»ëÂоݥǥ£¥¹¥¯¥ê¥×¥¿ (watch descriptor) ¤òÊÖ¤¹¡£ pathname ¤¬¤½¤Î inotify ¥¤¥ó¥¹¥¿¥ó¥¹¤ËÄɲ䵤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¡¢ ´Æ»ëÂоݥǥ£¥¹¥¯¥ê¥×¥¿¤¬¿·µ¬¤Ë³ä¤êÅö¤Æ¤é¤ì¤ë¡£ pathname ¤¬¤¹¤Ç¤Ë´Æ»ëÂоݤˤʤäƤ¤¤ì¤Ð¡¢´û¸¤Î´Æ»ë¥¢¥¤¥Æ¥à¤ËÂФ¹¤ë ¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬ÊÖ¤µ¤ì¤ë¡£

¤³¤ì°Ê¹ß¤Ë inotify ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤é read(2) ¤ò¹Ô¤¦¤È¡¢´Æ»ëÂоݥǥ£¥¹¥¯¥ê¥×¥¿¤¬ÊÖ¤µ¤ì¤ë¡£ ¤³¤ì¤é¤Î read() ¤ò¹Ô¤¦¤È¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥¤¥Ù¥ó¥È¤ò¼¨¤¹ inotify_event ¹½Â¤ÂΤ¬Æɤ߽Фµ¤ì¤ë¡£ÊÖ¤µ¤ì¤¿´Æ»ëÂоݥǥ£¥¹¥¯¥ê¥×¥¿¤Ë¤è¤ê¡¢ ¤É¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤½¤Î¥¤¥Ù¥ó¥È¤¬È¯À¸¤·¤¿¤«¤òÆÃÄê¤Ç¤­¤ë¡£

ÊÖ¤êÃÍ

À®¸ù¤¹¤ë¤È¡¢ inotify_add_watch() ¤ÏÈóÉé¤Î´Æ»ëÂоݥǥ£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£ ¥¨¥é¡¼¤Î¾ì¹ç¡¢-1 ¤òÊÖ¤·¡¢ errno ¤òŬÀÚ¤ËÀßÄꤹ¤ë¡£

¥¨¥é¡¼

EACCES

»ØÄꤵ¤ì¤¿¥Õ¥¡¥¤¥ë¤ËÂФ¹¤ëÆɤ߽Ф·¥¢¥¯¥»¥¹¤¬µö²Ä¤µ¤ì¤Æ¤¤¤Ê¤¤¡£

EBADF

»ØÄꤵ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬Í­¸ú¤Ç¤Ï¤Ê¤¤¡£

EFAULT

pathname ¤¬»Ø¤¹¥¢¥É¥ì¥¹¤¬¥×¥í¥»¥¹¤¬¥¢¥¯¥»¥¹¤Ç¤­¤ë¥¢¥É¥ì¥¹¶õ´Ö³°¤Ç¤¢¤ë¡£

EINVAL

»ØÄꤵ¤ì¤¿¥¤¥Ù¥ó¥È¥Þ¥¹¥¯¤ËÍ­¸ú¤Ê¥¤¥Ù¥ó¥È¤¬´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¡£ ¤â¤·¤¯¤Ï fd ¤¬ inotify ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ï¤Ê¤¤¡£

ENOMEM

¥«¡¼¥Í¥ë¥á¥â¥ê¤¬½½Ê¬¤Ë¤Ê¤«¤Ã¤¿¡£

ENOSPC

inotify ´Æ»ëÂоݤÎÁí¿ô¤¬¥æ¡¼¥¶¤¬ÄɲäǤ­¤ë¾å¸Â¤Ë㤷¤Æ¤¤¤¿¡£ ¤â¤·¤¯¤Ï¡¢É¬Íפʻñ¸»¤Î³ä¤êÅö¤Æ¤Ë¥«¡¼¥Í¥ë¤¬¼ºÇÔ¤·¤¿¡£

¥Ð¡¼¥¸¥ç¥ó

inotify ¤Ï Linux ¥«¡¼¥Í¥ë 2.6.13 ¤ËÁȤ߹þ¤Þ¤ì¤¿¡£

½àµò

¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux Æȼ«¤Ç¤¢¤ë¡£

´ØÏ¢¹àÌÜ

inotify_init(2), inotify_rm_watch(2), inotify(7)