'\"macro stdmacro
.TH FIND-FILTER 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
find-filter \- انتخاب دقیق فایل‌ها بر اساس مشخصه‌های زمانی
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_BINADM_DIR/find-filter\f1
[\f3\-v?\f1]
\f2predicate\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B find-filter
فیلتری برای فهرستی از نام‌های فایل خوانده‌شده از ورودی استاندارد است و در صورتی که فایل‌ها با
.I predicate
مطابقت داشته باشند، نام آن‌ها در خروجی استاندارد نوشته می‌شود.
.PP
شکل‌های پشتیبانی‌شدهٔ
.I predicate
بر اساس زمان ایجاد یا زمان تغییر فایل هستند و به صورت
.B ctime
یا
.B mtime
به‌همراه یک مشخصهٔ زمانی تعریف می‌شوند.
یک مشخصهٔ زمانی به صورت علامت \f3+\f1 یا
\f3-\f1 به‌همراه تعداد روزها (یک عدد صحیح غیرمنفی) می‌آید،
که می‌تواند اختیاری با یک دونقطه (\f3:\f1) و ساعت
(یک عدد صحیح در بازهٔ ۰ تا ۲۳)،
و سپس اختیاری با یک دونقطهٔ دیگر (\f3:\f1)
و دقیقه (یک عدد صحیح در بازهٔ ۰ تا ۵۹) همراه باشد.
.PP
مفهوم مشخصهٔ زمانی بدین صورت است که یک فایل با گزاره مطابقت دارد اگر مشخصهٔ زمانی انتخاب‌شده برای فایل،
.I "کمتر از"
(\f3+\f1) زمان فعلی منهای مشخصهٔ زمانی باشد؛ در غیر این صورت
.I "بیشتر یا مساوی با"
(\f3-\f1) زمان فعلی منهای مشخصهٔ زمانی است.
به بیان دیگر، \f3+\f1 به معنای
.I پیش از
زمان فعلی منهای مشخصهٔ زمانی، و
\f3-\f1 به معنای
.I هم‌زمان
یا
.I پس از
زمان فعلی منهای مشخصهٔ زمانی است.
.PP
.B find-filter
برای ارائهٔ انتخابی دقیق‌تر و مستقل از سکو در مقایسه با گزینه‌های
.B \-mtime
یا
.B \-ctime
در
.BR find (1)
طراحی شده است.
انتظار می‌رود
.B find-filter
به‌عنوان یک پس‌پالایه (post-filter) برای خروجی
.BR find (1)
به کار رود؛ و این همان شیوه‌ای است که در اسکریپت‌های
.BR pmlogger_daily (1)
برای انتخاب فایل‌ها جهت فشرده‌سازی یا پاک‌سازی استفاده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
مثال‌های
.I predicate
زیر برخی از کاربردهای رایج را نشان می‌دهند.
.IP "\fBmtime +3" 12n
فایل‌هایی را که بیش از ۳ روز پیش تغییر یافته‌اند تطابق می‌دهد.
.IP "\fBctime -0:2" 12n
فایل‌هایی را که در ۲ ساعت گذشته ایجاد شده‌اند تطابق می‌دهد.
.IP "\fBctime +0:0:15" 12n
فایل‌هایی را که بیش از ۱۵ دقیقه پیش ایجاد شده‌اند تطابق می‌دهد.
.SH "خطاها (DIAGNOSTICS)"
هیچ پیامی وجود ندارد، مگر اینکه از گزینهٔ
.B \-v
استفاده شود که در این صورت برخی پیام‌های تشخیصی در خطای استاندارد نوشته می‌شوند.
.PP
وضعیت خروج همواره صفر است، مگر اینکه در زمان تجزیهٔ آرگومان‌های خط فرمان خطایی رخ دهد.
.SH "همچنین ببینید (SEE ALSO)"
.BR find (1)
و
.BR pmlogger_daily (1).

.\" control lines for scripts/man-spell
.\" +ok+ mtime