نام (NAME)

captree - نمایش درخت قابلیتهای (capabilities) فرآیندها

خلاصه دستور (SYNOPSIS)

captree [OPTIONS] [(pid|glob-name) ...]

توضیحات (DESCRIPTION)

دستور captree قابلیت‌های فرآیندهای اشاره‌شده را که با مقدار(های) pid یا glob-name ارائه‌شده در خط فرمان مشخص می‌شوند، نمایش می‌دهد. اگر مقداری برای pid و غیره ارائه نشود، pid=1 در نظر گرفته می‌شود. مقدار pid برابر با ۰، تمام فرآیندهای شناخته‌شده برای هسته را نمایش می‌دهد.

قابلیت‌های POSIX.1e در قالب cap_from_text(3) داخل گیومه دوتایی (double quotes) نمایش داده می‌شوند. چندتایی (تاپل) قابلیت‌های IAB بین براکت‌ها (square brackets) و در قالب متنی شرح‌داده‌شده در cap_iab(3) نمایش داده می‌شود. هر دوی این قالب‌های متنی در cap_text_formats(7) شرح داده شده‌اند. توجه داشته باشید که متن تاپل IAB در صورتی که مؤلفه‌های A و B آن خالی باشند حذف می‌شود، زیرا متن استاندارد POSIX.1e از قبل حاوی اطلاعات مربوط به پرچم Inheritable است. این رفتار را می‌توان با آرگومان خط فرمان --verbose تغییر داد.

گزینهها (OPTIONS)

آرگومان‌های اختیاری (که باید پیش از فهرست مقادیر pid|glob-name قرار گیرند):

--help

اطلاعات نحوه استفاده را نمایش داده و خارج می‌شود. توجه داشته باشید که زمان‌های اجرای امروزی Go در این حالت با وضعیت ۰ خارج می‌شوند، اما زمان‌های اجرای قدیمی‌تر با وضعیت ۲ خارج می‌شوند.

--verbose

مجموعه‌های قابلیت و تاپل‌های IAB را حتی زمانی که خالی یا زائد هستند نمایش می‌دهد.

--depth=n

درخت فرآیند را تا عمق n نمایش می‌دهد. توجه داشته باشید که مقدار پیش‌فرض برای این پارامتر ۰ است که به معنای عمق نامحدود است.

--colo[u]r=false

در صورتی که خروجی استاندارد یک TTY باشد، PIDهای مورد نظر را به رنگ قرمز نمایش می‌دهد. این گزینه هنگام اجرا از طریق TTY به صورت پیش‌فرض فعال (true) است. آرگومان --color=false این رنگ را غیرفعال می‌کند. هدایت خروجی به برنامه‌ای دیگر نیز استفاده از رنگ را غیرفعال خواهد کرد.

وضعیت خروج (EXIT STATUS)

اگر هدف ارائه‌شده یافت نشود، وضعیت خروج ۱ است. در صورتی که گزینه ناشناخته‌ای ارائه شود، وضعیت خروج ۲ خواهد بود. در غیر این صورت، captree با وضعیت ۰ خارج می‌شود.

گزارش اشکال (REPORTING BUGS)

لطفاً اشکالات را از طریق نشانی زیر گزارش دهید:

component=libcap&list_id=1090757">https://bugzilla.kernel.org/buglist.cgi?component=libcap&list_id=1090757

همچنین ببینید (SEE ALSO)

cap_from_text(3), cap_text_formats(7), capabilities(7) و cap_iab(3).

مقاله جامع‌تری درباره captree که شامل چند مثال است، در اینجا موجود است:

https://sites.google.com/site/fullycapable/captree

نویسندگان (AUTHORS)

Andrew G. Morgan <morgan@kernel.org>