.\" SPDX-License-Identifier: GPL-2.0-or-later
.\" Copyright (c) 2009,2017-18 Red Hat Inc.

.TH FILECAP "8" "Aug 2018" "Red Hat" "ابزارهای مدیریت سیستم"
.SH "نام (NAME)"
filecap \- برنامه‌ای برای مشاهده قابلیت‌های مبتنی بر فایل
.SH "خلاصه دستور (SYNOPSIS)"
.B filecap [ \-a | \-d | /dir | /dir/file [cap1 cap2 ...] ]
.SH "توضیحات (DESCRIPTION)"
برنامه
\fBfilecap\fP
گزارشی از برنامه‌های دارای قابلیت‌های مبتنی بر فایل (file based capabilities) چاپ می‌کند. اگر فایلی در گزارش نباشد یا اصلاً گزارشی تولید نشود، هیچ قابلیتی یافت نشده است. برای سرعت بیشتر، حالت پیش‌فرض تنها بررسی دایرکتوری‌های موجود در متغیر محیطی PATH است. اگر گزینه خط فرمان
.B \-a
داده شود، تمام دایرکتوری‌ها بررسی خواهند شد. اگر یک دایرکتوری داده شود، آن دایرکتوری را به صورت بازگشتی بررسی می‌کند. اگر مسیر یک فایل مشخص شود، تنها همان فایل را بررسی خواهد کرد. اگر یک فایل و به دنبال آن قابلیت‌ها مشخص شوند، آن قابلیت‌ها بر روی فایل نوشته می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-a
این گزینه به برنامه می‌گوید تا تمام قابلیت‌ها را از دایرکتوری / به بعد نمایش دهد. در حالت عادی از متغیر محیطی PATH برای نمایش قابلیت‌های فایل‌هایی که احتمالاً اجرا می‌کنید استفاده می‌شود.
.TP
.B \-d
تمام قابلیت‌ها را جهت ارجاع و مرجع تخلیه و نمایش می‌دهد.

.SH "مثال‌ها (EXAMPLES)"
.nf
برای بررسی قابلیت‌های فایل در $PATH:
.B filecap

برای بررسی قابلیت‌های فایل در کل سیستم:
.B filecap -a

برای بررسی بازگشتی قابلیت‌های فایل در یک دایرکتوری:
.B filecap /usr

برای بررسی قابلیت‌های فایل مربوط به یک برنامه خاص:
.B filecap /bin/passwd

برای فهرست کردن تمامی قابلیت‌های ممکن:
.B filecap -d

برای تنظیم یک قابلیت فایل بر روی یک برنامه خاص:
.B filecap /bin/ping net_raw net_admin

برای حذف قابلیت‌های فایل از یک برنامه خاص:
.B filecap /bin/ping none 
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR pscap (8),
.BR netcap (8),
.BR capabilities (7).

.SH "نویسندگان (AUTHORS)"
Steve Grubb