.\" Copyright (C) 2001, 2002, 2006, 2007  Silicon Graphics, Inc.
.\" All rights reserved.
.\"
.\" 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 ATTR 1 "Extended Attributes" "Dec 2001" "XFS Compatibility API"
.SH "نام (NAME)"
attr \- دستکاری و مدیریت ویژگیها و خصوصیات توسعهیافته در اشیاء سیستمفایل
.SH "نحوه استفاده (SYNOPSIS)"
.nf
\f3attr\f1 [ \f3\-LRSq\f1 ] \f3\-s attrname\f1 [ \f3\-V attrvalue\f1 ] \c
\f3pathname\f1
.sp .8v
\f3attr\f1 [ \f3\-LRSq\f1 ] \f3\-g attrname pathname\f1
.sp .8v
\f3attr\f1 [ \f3\-LRSq\f1 ] \f3\-r attrname pathname\f1
.sp .8v
\f3attr\f1 [ \f3\-LRSq\f1 ] \f3\-l pathname\f1
.sp .8v
.fi
.SH "بررسی اجمالی (OVERVIEW)"
ویژگی‌های توسعه‌یافته امکان الصاق جفت‌های نام:مقدار (name:value) را به اشیاء درون سیستم‌فایل XFS برای کاربر فراهم می‌کنند.
.PP
این سند دستور
.I attr
را شرح می‌دهد که تا حد زیادی با دستور هم‌نام خود در IRIX سازگار است. از این رو این ابزار به‌طور ویژه برای کاربران سیستم‌فایل XFS طراحی شده است؛ برای مدیریت ویژگی‌های توسعه‌یافته به صورت مستقل از سیستم‌فایل، به مستندات دستورات
.IR getfattr (1)
و
.IR setfattr (1)
مراجعه فرمایید.
.PP
از ویژگی‌های توسعه‌یافته می‌توان برای ذخیره فراداده (متا‌دیتا) درباره پرونده استفاده کرد. برای نمونه عبارت "character-set=kanji" می‌تواند به مرورگر سند اعلام کند که هنگام نمایش آن از مجموعه نویسه‌های کانجی استفاده کند، یا "thumbnail=..." می‌تواند پیش‌نمایشی با وضوح پایین‌تر از یک تصویر گرافیکی بزرگ را ارائه دهد.
.PP
در سیستم‌فایل XFS، طول
.I نام‌ها
می‌تواند حداکثر ۲۵۶ بایت باشد که با اولین بایت 0 خاتمه می‌یابد. هدف این است که نام ویژگی‌ها نویسه‌های اسکی (یا دیگر مجموعه‌های کاراکتری) قابل چاپ باشند.
.I مقادیر
می‌توانند حداکثر ۶۴ کیلوبایت از داده‌های دلخواه دودویی (باینری) باشند.
.PP
ویژگی‌ها را می‌توان به انواع گره‌های شاخص (inode) سیستم‌فایل XFS الصاق کرد: پرونده‌های عادی، دایرکتوری‌ها، پیوندهای نمادین، گره‌های دستگاه و غیره.
.PP
سیستم‌فایل XFS از ۲ فضای نام مجزای ویژگی‌ها برای هر شیء سیستم‌فایل بهره می‌برد: فضاهای آدرس
.B root
و
.BR user .
فضای آدرس
.B root
تنها برای کاربر ارشد (superuser) قابل دسترسی است، آن هم تنها با مشخص کردن یک فلگ در فراخوانی تابع. سایر کاربران قادر به دیدن یا تغییر ویژگی‌ها در فضای آدرس
.B root
نخواهند بود. فضای آدرس
.B user
توسط سازوکار معمول دسترسی‌های پرونده محافظت می‌شود، بنابراین مالک پرونده می‌تواند تصمیم بگیرد چه کسی اجازه مشاهده یا دستکاری مقادیر ویژگی‌های یک پرونده خاص را دارد.
.SH "توضیحات (DESCRIPTION)"
ابزار
.I attr
امکان دستکاری ویژگی‌های توسعه‌یافته الصاق‌شده به اشیاء سیستم‌فایل را از طریق اسکریپت‌های پوسته (شل) فراهم می‌سازد.
.PP
چهار عملیات اصلی وجود دارد که
.I attr
می‌تواند انجام دهد:
.TP
.B GET (دریافت)
گزینه
.B \-g attrname
به
.I attr
اعلام می‌کند که شیء مشخص‌شده را جستجو کرده و مقدار الصاق‌شده به آن نام ویژگی را در خروجی استاندارد (\f4stdout\fP) چاپ کند.
با وجود فلگ
.BR \-q ،
خروجی استاندارد (\f4stdout\fP) دقیقاً و تنها مقدار آن ویژگی خواهد بود که جهت ذخیره مستقیم در یک پرونده یا پردازش از طریق خط لوله (pipe) مناسب است.
.TP
.B LIST (فهرست)
گزینه
.B \-l
به
.I attr
دستور می‌دهد تا نام تمام ویژگی‌های الصاق‌شده به شیء و همچنین حجم بایت‌های مقدار هر یک از آن‌ها را فهرست کند.
با استفاده از فلگ
.BR \-q ،
خروجی استاندارد (\f4stdout\fP) تنها یک فهرست ساده از نام ویژگی‌ها (هر نام در یک خط) خواهد بود که برای ورودی اسکریپت‌ها مناسب است.
.TP
.B REMOVE (حذف)
گزینه
.B \-r attrname
به
.I attr
اعلام می‌کند در صورت وجود ویژگی با نام داده‌شده، آن را از شیء حذف کند.
در صورت انجام موفقیت‌آمیز عملیات، هیچ خروجی نمایش داده نخواهد شد.
.TP
.B SET/CREATE (تنظیم/ایجاد)
گزینه
.B \-s attrname
به
.I attr
دستور می‌دهد ویژگی مورد نظر شیء را برابر با مقداری قرار دهد که از ورودی استاندارد (\f4stdin\fP) خوانده می‌شود.
اگر ویژگی با آن نام از قبل موجود باشد، مقدار آن جایگزین خواهد شد.
اگر ویژگی با آن نام وجود نداشته باشد، با این مقدار ایجاد می‌گردد.
با مشخص کردن فلگ
.BR "\-V attrvalue" ،
مقدار ویژگی برابر با
.B attrvalue
قرار می‌گیرد و ورودی استاندارد (\f4stdin\fP) خوانده نمی‌شود.
با وجود فلگ
.BR \-q ،
از خروجی استاندارد (\f4stdout\fP) استفاده نخواهد شد.
بدون فلگ
.BR \-q ،
پیامی حاوی نام ویژگی و مقدار کامل آن چاپ می‌شود.
.PP
هنگامی که گزینه
.B \-L
مشخص شود و شیء داده‌شده یک پیوند نمادین باشد، عملیات روی ویژگی‌های شیئی که پیوند نمادین به آن اشاره می‌کند اعمال خواهد شد.
بدون این گزینه، عملیات روی ویژگی‌های خودِ پیوند نمادین اجرا می‌شود.
.PP
اگر گزینه
.B \-R
مشخص شود و فرایند جاری دسترسی‌های لازم را داشته باشد، عملیات در فضای نام ویژگی‌های
.I root
به جای فضای نام ویژگی‌های
.I USER
انجام خواهد شد.
.PP
گزینه
.B \-S
مشابه است، با این تفاوت که استفاده از فضای نام ویژگی‌های
.I security
را تعیین می‌کند.
.PP
هنگامی که گزینه
.B \-q
داده شود،
.I attr
تلاش می‌کند تا در حالت خاموش کار کند.
پیام‌های خطا در خروجی استاندارد خطا (\f4stderr\fP) نمایش داده می‌شوند، اما پیام‌های وضعیت در خروجی استاندارد (\f4stdout\fP) چاپ نخواهند شد.
.SH "نکات (NOTES)"
برنامه‌های استاندارد بایگانی و تبادل پرونده مانند
.IR tar (1)
و
.IR cpio (1)
ویژگی‌های توسعه‌یافته را بایگانی یا بازیابی نمی‌کنند؛ در حالی که برنامه
.IR xfsdump (8)
از آن‌ها پشتیبانی می‌کند.
.SH "هشدارها (CAVEATS)"
گزینه list موجود در نسخه IRIX این دستور پشتیبانی نمی‌شود. ابزار
.I getfattr
سازوکاری برای دریافت تمامی نام‌های ویژگی‌ها فراهم می‌آورد.
.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 getfattr (1),
.BR setfattr (1),
.BR attr_get (3),
.BR attr_set (3),
.BR attr_multi (3),
.BR attr_remove (3),
.BR xattr (7),
.BR xfsdump (8)