.\" Copyright (C) 2002, 2004, 2007  Silicon Graphics, Inc. All rights reserved.
.\" Copyright (C) 2002, 2004, 2007  Andreas Gruenbacher <agruen@suse.de>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual.  If not, see
.\" <http://www.gnu.org/licenses>.
.\"
.TH GETFATTR 1 "Extended Attributes" "Dec 2001" "File Utilities"
.SH "نام (NAME)"
getfattr \- دریافت ویژگیهای گسترشیافته فایل
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBgetfattr\fR [\fB\-hRLP\fR] \fB\-n name\fR [\fB\-e en\fR] \c
\fBpathname\fR...
\fBgetfattr\fR [\fB\-hRLP\fR] \fB\-d\fR [\fB\-e en\fR] \c
[\fB\-m pattern\fR] \fBpathname\fR...
.fi
.SH "توضیحات (DESCRIPTION)"
برای هر فایل،
.B getfattr
نام فایل و مجموعه‌ای از نام‌های ویژگی‌های گسترش‌یافته (و در صورت تمایل مقادیر آن‌ها) را که به آن فایل مرتبط هستند، نمایش می‌دهد. به صورت پیش‌فرض تنها ویژگی‌های موجود در فضای نام کاربر (user) نمایش داده می‌شوند، گزینه
.B \-m
را ببینید.
.PP
فرمت خروجی
.B "getfattr \-d"
به صورت زیر است:
.fam C
.RS
.nf
 1:  # file: somedir/
 2:  user.name0="value0"
 3:  user.name1="value1"
 4:  user.name2="value2"
 5:  ...
.fi
.RE
.fam T
.PP
خط ۱ نام فایلی را مشخص می‌کند که خطوط بعدی برای آن گزارش می‌شوند.
خطوط باقی‌مانده (خطوط ۲ تا ۴ در بالا) جفت‌های
.I name
و
.I value
(نام و مقدار) مرتبط با فایل مشخص‌شده را نشان می‌دهند.
.SH "گزینه‌ها (OPTIONS)"
.TP 4
.BR \-n " \fIname\fR, " \-\-name "=\fIname\fR"
استخراج و نمایش مقدار ویژگی گسترش‌یافته نام‌گذاری‌شده.
.TP
.BR \-d ", " \-\-dump
استخراج و نمایش مقادیر تمام ویژگی‌های گسترش‌یافته منطبق.
.TP
.BR \-e " \fIen\fR, " \-\-encoding "=\fIen\fR"
کدگذاری مقادیر پس از بازیابی آن‌ها.
مقادیر معتبر برای
.I en
عبارتند از "text" (متن)، "hex" (هگزادسیمال) و "base64".
مقادیر کدگذاری‌شده به صورت رشته‌های متنی داخل علامت نقل‌قول دوتایی (") قرار می‌گیرند، در حالی که رشته‌های کدگذاری‌شده به صورت هگزادسیمال و base64 به ترتیب با پیشوندهای
.B 0x
و
.B 0s
مشخص می‌شوند.
.TP
.BR \-h ", " \-\-no-dereference
پیوندهای نمادین دنبال نشوند (عدم ارجاع‌زدایی). به جای فایلی که پیوند نمادین به آن اشاره می‌کند، خود پیوند نمادین بررسی می‌شود. به جز در مواردی که پیمایش منطقی با گزینه
.B \-L
انجام می‌شود، پیوندهای نمادین به دایرکتوری‌ها پیمایش نخواهند شد.
.TP
.BR \-m " \fIpattern\fR, " \-\-match "=\fIpattern\fR"
تنها ویژگی‌هایی را شامل شود که نام آن‌ها با عبارت باقاعده
.I pattern
مطابقت دارد.
مقدار پیش‌فرض برای
.I pattern
برابر با "^user\\." است،
که تمام ویژگی‌های موجود در فضای نام کاربر (user) را شامل می‌شود. برای در بر گرفتن تمام ویژگی‌ها، مقدار "\-" را مشخص کنید. جهت مشاهده توضیحات مفصل‌تر درباره فضاهای نام، به
.BR xattr (7)
مراجعه فرمایید.
.TP
.B \-\-absolute-names
کاراکترهای اسلش آغازین ('/') حذف نشوند.
رفتار پیش‌فرض، حذف کاراکترهای اسلش ابتدایی است.
.TP
.B \-\-only-values
استخراج و چاپ مقادیر خام ویژگی(های) گسترش‌یافته بدون کدگذاری آن‌ها.
.TP
.BR \-R ", " \-\-recursive
فهرست کردن ویژگی‌های تمام فایل‌ها و دایرکتوری‌ها به صورت بازگشتی.
.TP
.BR \-L ", " \-\-logical
پیمایش منطقی؛ دنبال کردن پیوندهای نمادین به دایرکتوری‌ها.
رفتار پیش‌فرض دنبال کردن آرگومان‌های پیوند نمادین است مگر اینکه گزینه
.B \-\-no\-dereference
مشخص شده باشد، و نادیده گرفتن پیوندهای نمادین دیده‌شده در زیردایرکتوری‌ها است.
این گزینه تنها در ترکیب با
.B \-R
مؤثر است.
.TP
.BR \-P ", " \-\-physical
پیمایش فیزیکی؛ دنبال نکردن پیوندهای نمادین به دایرکتوری‌ها.
این حالت همچنین آرگومان‌های پیوند نمادین را نادیده می‌گیرد.
این گزینه تنها در ترکیب با
.B \-R
مؤثر است.
.TP
.B \-\-version
چاپ نسخه
.B getfattr
و خروج.
.TP
.B \-\-help
نمایش راهنما برای توضیح گزینه‌های خط فرمان.
.TP
.B \-\-
پایان گزینه‌های خط فرمان.
تمام پارامترهای باقی‌مانده به عنوان نام فایل در نظر گرفته می‌شوند، حتی اگر با کاراکتر خط تیره (داش) آغاز شوند.
.SH "نویسنده (AUTHOR)"
آندریاس گرونباخر (Andreas Gruenbacher)،
.RI < andreas.gruenbacher@gmail.com >
و تیم توسعه SGI XFS،
.RI < linux-xfs@oss.sgi.com >.
.P
لطفاً گزارش‌های اشکال یا نظرات خود را به نشانی
.RI < https://savannah.nongnu.org/bugs/?group=attr >
یا
.RI < acl-devel@nongnu.org >
ارسال فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.BR setfattr (1),
.BR xattr (7)