.TH "incrontab" "5" "0.5.12" "Lukas Jelinek" "مستندات incron" .SH "نام (NAME)" incrontab \- جداول برای دیمن inotify cron (incrond) .SH "توضیحات (DESCRIPTION)" یک پرونده .B incrontab حاوی دستورالعمل‌هایی برای دیمن .BR incrond (8) به شکل کلی: «اجرای این دستور هنگام وقوع این رویدادهای فایلی» است. دو دسته جدول وجود دارد: جداول سیستمی (با دسترسی‌های root) و جداول کاربری (با دسترسی‌های کاربر). .PP جداول سیستمی (به‌طور پیش‌فرض) در مسیر .I /etc/incron.d قرار دارند و می‌توانند هر نامی داشته باشند. هر جدول سیستمی به‌صورت جداگانه در داخل incron وجود دارد و پایش‌های آن‌ها هرگز با یکدیگر تداخل ندارند. .PP هر کاربر جدول اختصاصی خود را دارد، و دستورات موجود در هر .B incrontab با دسترسی کاربری که مالک آن است اجرا خواهند شد. کاربران سیستمی (مانند apache، postfix، nobody و غیره) نیز می‌توانند .B incrontab اختصاصی خود را داشته باشند. .PP پرونده‌های .B incrontab هنگام راه‌اندازی دیمن .BR incrond (8) و پس از هرگونه تغییر خوانده می‌شوند (پرونده‌های incrontab در زمان اجرای incrond متصل و قلاب می‌شوند). .PP خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند. قالب کلی خطوط به شرح زیر است: .PP .nf .fi .PP که در آن .I path یک مسیر مطلق در سامانه پرونده، .I mask یک ماسک رویداد (به صورت نمادین یا عددی) و .I command یک پرونده اجرایی (یا یک اسکریپت) به همراه آرگومان‌های آن است. نمادهای ماسک رویداد در زیر توضیح داده شده‌اند. پرونده اجرایی را می‌توان به صورت یک مسیر مطلق یا تنها نام آن مشخص کرد (مسیرهای متغیر PATH بررسی می‌شوند). .PP لطفاً به یاد داشته باشید که هر مسیر تنها یک بار در هر جدول می‌تواند تکرار شود (در غیر این صورت تنها اولین مورد اعمال شده و پیام خطایی در گزارش‌های سیستم ثبت می‌شود). .PP لطفاً توجه داشته باشید که استفاده از نویسه عام * برای پایش محدوده‌ای از فایل‌ها مجاز است. .SH "نمادهای رویداد (EVENT SYMBOLS)" این نمادهای پایه برای ماسک رویداد تعریف شده‌اند: .PP .nf \fBIN_ACCESS\fR دسترسی به فایل (خواندن) (*) \fBIN_ATTRIB\fR تغییر متاداده (مجوزها، برچسب‌های زمانی، ویژگی‌های گسترده و غیره) (*) \fBIN_CLOSE_WRITE\fR بسته شدن فایلی که برای نوشتن باز شده بود (*) \fBIN_CLOSE_NOWRITE\fR بسته شدن فایلی که برای نوشتن باز نشده بود (*) \fBIN_CREATE\fR ایجاد فایل/دایرکتوری در دایرکتوری مورد پایش (*) \fBIN_DELETE\fR حذف فایل/دایرکتوری از دایرکتوری مورد پایش (*) \fBIN_DELETE_SELF\fR حذف خود فایل/دایرکتوری مورد پایش \fBIN_MODIFY\fR تغییر و اصلاح فایل (*) \fBIN_MOVE_SELF\fR جابه‌جایی خود فایل/دایرکتوری مورد پایش \fBIN_MOVED_FROM\fR انتقال فایل به بیرون از دایرکتوری مورد پایش (*) \fBIN_MOVED_TO\fR انتقال فایل به درون دایرکتوری مورد پایش (*) \fBIN_OPEN\fR باز شدن فایل (*) .fi .PP هنگام پایش یک دایرکتوری، رویدادهایی که با ستاره (*) در بالا مشخص شده‌اند می‌توانند برای فایل‌های درون آن دایرکتوری رخ دهند؛ در این حالت، فیلد نام در داده‌های رویداد بازگردانده‌شده، نام فایل درون دایرکتوری را مشخص می‌کند. .PP نماد .B IN_ALL_EVENTS به عنوان ماسک بیتی از تمام رویدادهای بالا تعریف شده است. دو نماد تسهیل‌کننده دیگر عبارتند از .B IN_MOVE که ترکیبی از .B IN_MOVED_FROM و .B IN_MOVED_TO است، و .B IN_CLOSE که .B IN_CLOSE_WRITE و .B IN_CLOSE_NOWRITE را ترکیب می‌کند. .PP نمادهای زیر نیز می‌توانند در ماسک تعیین شوند: .PP .nf \fBIN_DONT_FOLLOW\fR دنبال نکردن مسیر در صورت پیوند نمادین بودن \fBIN_ONESHOT\fR پایش مسیر تنها برای یک رویداد \fBIN_ONLYDIR\fR پایش مسیر تنها در صورتی که دایرکتوری باشد .fi .PP علاوه بر این، نمادی وجود دارد که در مجموعه نمادهای inotify دیده نمی‌شود: نماد .BR loopable=true . این نماد پایش رویدادها را تا زمانی که رویداد کنونی به طور کامل رسیدگی شود (تا زمانی که فرآیند فرزند خارج شود) غیرفعال می‌کند. .PP همچنین نماد .B recursive=false وجود دارد. این نماد پایش را به دایرکتوری مشخص‌شده محدود کرده و شامل زیردایرکتوری‌ها نمی‌شود. .PP در نهایت نماد .B dotdirs=true نیز وجود دارد. این نماد دایرکتوری‌های پنهان (که نامشان با نقطه آغاز می‌شود) را در پایش لحاظ می‌کند. .SH "نویسه‌های عام (WILDCARDS)" نویسه‌های عام زیر می‌توانند در مشخصات دستور به کار روند: .PP .nf \fB$$\fR علامت دلار \fB$@\fR مسیر سامانه پرونده مورد پایش (به بالا مراجعه کنید) \fB$#\fR نام فایل مرتبط با رویداد \fB$%\fR فلگ‌های رویداد (به صورت متنی) \fB$&\fR فلگ‌های رویداد (به صورت عددی) .fi .SH "مثال‌ها (EXAMPLES)" این‌ها نمونه قواعدی هستند که می‌توان در یک پرونده incrontab استفاده کرد: .PP .nf \fB/tmp IN_ALL_EVENTS abcd $@/$# $%\fR \fB/usr/bin IN_ACCESS,loopable=true abcd $#\fR \fB/home IN_CREATE /usr/local/bin/abcd $#\fR \fB/home IN_CREATE,dotdirs=true /usr/local/bin/abcd $#\fR \fB/home IN_CREATE,recursive=false /usr/local/bin/abcd $#\fR \fB/var/log 12 abcd $@/$#\fR .fi .PP خط اول تمام رویدادهای دایرکتوری .I /tmp را پایش می‌کند. هنگامی که رویدادی رخ دهد، برنامه‌ای به نام 'abcd' را با مسیر کامل فایل به عنوان آرگومان اول و فلگ‌های رویداد به عنوان آرگومان دوم اجرا می‌کند. .PP خط دوم دسترسی‌ها (خواندن‌ها) در دایرکتوری .I /usr/bin را پایش می‌کند. برنامه 'abcd' به عنوان گرداننده اجرا شده و پایش رویداد مربوطه تا پایان برنامه غیرفعال می‌شود. نام فایل (بدون مسیر دایرکتوری) به عنوان یک آرگومان منتقل می‌شود. .PP مثال سوم برای پایش دایرکتوری .I /home جهت شناسایی فایل‌ها یا دایرکتوری‌های جدیداً ایجاد شده به کار می‌رود (عملاً بدین معناست که هنگام افزوده شدن کاربر جدید، یک رویداد ارسال می‌شود). این رویداد توسط برنامه‌ای که با مسیر مطلق مشخص شده پردازش می‌گردد. .PP مثال چهارم همانند مثال سوم است، اما دایرکتوری‌های پنهان را نیز در پایش لحاظ می‌کند. .PP مثال پنجم همانند مثال سوم است، اما زیردایرکتوری‌ها را از پایش مستثنی می‌کند. .PP خط پایانی نشان می‌دهد که چگونه می‌توان از ماسک رویداد عددی به جای متنی استفاده کرد. مقدار 12 دقیقاً معادل .B IN_ATTRIB,IN_CLOSE_WRITE است. .SH "همچنین ببینید (SEE ALSO)" .BR incrond (8)، .BR incrontab (1)، .BR incron.conf (5) .SH "نویسندگان (AUTHORS)" Andreas Altair Redmer (لطفاً اشکالات را به https://github.com/ar-/incron/issues گزارش دهید). .br Lukas Jelinek . .SH "حق نشر (COPYING)" این برنامه یک نرم‌افزار آزاد است. می‌توان از آن استفاده کرد، آن را بازتوزیع نمود و/یا تحت شرایط پروانه عمومی همگانی گنو (GPL)، نسخه ۲، تغییر داد.