نام (NAME)

getfattr - دریافت ویژگیهای گسترشیافته فایل

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

getfattr [-hRLP] -n name [-e en] 
pathname...
getfattr [-hRLP] -d [-e en] 
[-m pattern] pathname...

توضیحات (DESCRIPTION)

برای هر فایل، getfattr نام فایل و مجموعه‌ای از نام‌های ویژگی‌های گسترش‌یافته (و در صورت تمایل مقادیر آن‌ها) را که به آن فایل مرتبط هستند، نمایش می‌دهد. به صورت پیش‌فرض تنها ویژگی‌های موجود در فضای نام کاربر (user) نمایش داده می‌شوند، گزینه -m را ببینید.

فرمت خروجی getfattr -d به صورت زیر است:

1:  # file: somedir/
2:  user.name0="value0"
3:  user.name1="value1"
4:  user.name2="value2"
5:  ...

خط ۱ نام فایلی را مشخص می‌کند که خطوط بعدی برای آن گزارش می‌شوند. خطوط باقی‌مانده (خطوط ۲ تا ۴ در بالا) جفت‌های name و value (نام و مقدار) مرتبط با فایل مشخص‌شده را نشان می‌دهند.

گزینه‌ها (OPTIONS)

-n name, --name=name: استخراج و نمایش مقدار ویژگی گسترش‌یافته نام‌گذاری‌شده.
-d, --dump: استخراج و نمایش مقادیر تمام ویژگی‌های گسترش‌یافته منطبق.
-e en, --encoding=en: کدگذاری مقادیر پس از بازیابی آن‌ها. مقادیر معتبر برای en عبارتند از "text" (متن)، "hex" (هگزادسیمال) و "base64". مقادیر کدگذاری‌شده به صورت رشته‌های متنی داخل علامت نقل‌قول دوتایی (") قرار می‌گیرند، در حالی که رشته‌های کدگذاری‌شده به صورت هگزادسیمال و base64 به ترتیب با پیشوندهای 0x و 0s مشخص می‌شوند.
-h, --no-dereference: پیوندهای نمادین دنبال نشوند (عدم ارجاع‌زدایی). به جای فایلی که پیوند نمادین به آن اشاره می‌کند، خود پیوند نمادین بررسی می‌شود. به جز در مواردی که پیمایش منطقی با گزینه -L انجام می‌شود، پیوندهای نمادین به دایرکتوری‌ها پیمایش نخواهند شد.
-m pattern, --match=pattern: تنها ویژگی‌هایی را شامل شود که نام آن‌ها با عبارت باقاعده pattern مطابقت دارد. مقدار پیش‌فرض برای pattern برابر با "^user\." است، که تمام ویژگی‌های موجود در فضای نام کاربر (user) را شامل می‌شود. برای در بر گرفتن تمام ویژگی‌ها، مقدار "-" را مشخص کنید. جهت مشاهده توضیحات مفصل‌تر درباره فضاهای نام، به xattr(7) مراجعه فرمایید.
--absolute-names: کاراکترهای اسلش آغازین ('/') حذف نشوند. رفتار پیش‌فرض، حذف کاراکترهای اسلش ابتدایی است.
--only-values: استخراج و چاپ مقادیر خام ویژگی(های) گسترش‌یافته بدون کدگذاری آن‌ها.
-R, --recursive: فهرست کردن ویژگی‌های تمام فایل‌ها و دایرکتوری‌ها به صورت بازگشتی.
-L, --logical: پیمایش منطقی؛ دنبال کردن پیوندهای نمادین به دایرکتوری‌ها. رفتار پیش‌فرض دنبال کردن آرگومان‌های پیوند نمادین است مگر اینکه گزینه --no-dereference مشخص شده باشد، و نادیده گرفتن پیوندهای نمادین دیده‌شده در زیردایرکتوری‌ها است. این گزینه تنها در ترکیب با -R مؤثر است.
-P, --physical: پیمایش فیزیکی؛ دنبال نکردن پیوندهای نمادین به دایرکتوری‌ها. این حالت همچنین آرگومان‌های پیوند نمادین را نادیده می‌گیرد. این گزینه تنها در ترکیب با -R مؤثر است.
--version: چاپ نسخه getfattr و خروج.
--help: نمایش راهنما برای توضیح گزینه‌های خط فرمان.
--: پایان گزینه‌های خط فرمان. تمام پارامترهای باقی‌مانده به عنوان نام فایل در نظر گرفته می‌شوند، حتی اگر با کاراکتر خط تیره (داش) آغاز شوند.

نویسنده (AUTHOR)

آندریاس گرونباخر (Andreas Gruenbacher)، <andreas.gruenbacher@gmail.com> و تیم توسعه SGI XFS، <linux-xfs@oss.sgi.com>.

لطفاً گزارش‌های اشکال یا نظرات خود را به نشانی https://savannah.nongnu.org/bugs/?group=attr یا <acl-devel@nongnu.org> ارسال فرمایید.

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

setfattr(1), xattr(7)