.\" Copyright (C) 2002, 2004  Silicon Graphics, Inc. All rights reserved.
.\" Copyright (C) 2002, 2004  Andreas Gruenbacher <agruen@suse.de>
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses>.
.\"
.\" 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 SETFATTR 1 "Extended Attributes" "Dec 2001" "File Utilities"
.SH "نام (NAME)"
setfattr \- تنظیم ویژگی‌های گسترش‌یافته اشیاء سیستم‌فایل
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBsetfattr\fR [\fB\-h\fR] \fB\-n name\fR [\fB\-v value\fR] \fBpathname\fR...
\fBsetfattr\fR [\fB\-h\fR] \fB\-x name\fR \fBpathname\fR...
\fBsetfattr\fR [\fB\-hP\fR] \fB\-\-restore=file\fR
.fi
.SH "توضیحات (DESCRIPTION)"
دستور
.B setfattr
یک
.I value
(مقدار) جدید را به
.I name
(نام) ویژگی گسترش‌یافته برای هر فایل مشخص‌شده منتسب می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 4
.BR \-n " \fIname\fR, " \-\-name "=\fIname\fR"
نام ویژگی گسترش‌یافته برای تنظیم را مشخص می‌کند.
.TP
.BR \-v " \fIvalue\fR, " \-\-value "=\fIvalue\fR"
مقدار جدید ویژگی گسترش‌یافته را مشخص می‌کند. سه روش برای کدگذاری مقدار در دسترس است. اگر رشته داده‌شده داخل علامت نقل‌قول دوتایی (کوتیشن) قرار گیرد، متن درون آن به عنوان متن ساده در نظر گرفته می‌شود. در این حالت، کاراکترهای بک‌اسلش و علامت‌های نقل‌قول معانی خاصی دارند و باید با یک بک‌اسلش قبلی اسکیپ شوند. هر یک از نویسه‌های کنترلی می‌توانند به صورت یک بک‌اسلش به همراه سه رقم هشت‌هشتی (اکتال) کد اسکی (ASCII) مربوطه کدگذاری شوند. اگر رشته مشخص‌شده با
.B 0x
یا
.B 0X
آغاز شود، بیانگر یک عدد در مبنای ۱۶ (هگزادسیمال) است. اگر رشته با
.B 0s
یا
.B 0S
شروع شود، کدگذاری base64 مورد انتظار است. همچنین گزینه
.B \-\-encoding
در
.BR getfattr (1)
را ببینید.
.TP
.BR \-x " \fIname\fR, " \-\-remove "=\fIname\fR"
ویژگی گسترش‌یافته نام‌گذاری‌شده را به طور کامل حذف می‌کند.
.TP
.BR \-h ", " \-\-no-dereference
پیوندهای نمادین دنبال نشوند (عدم ارجاع‌زدایی). اگر
.I pathname
یک پیوند نمادین باشد، دنبال نمی‌شود، بلکه خود پیوند نمادین اصلاح می‌گردد.
.TP
.BR \-P ", " \-\-physical
در هنگام بازیابی، پیوندهای نمادین موجود در مسیرها پیمایش نشوند. این گزینه می‌تواند با گزینه
.B \-h
ترکیب شود.
.TP
.BR \-\-restore =\fIfile\fR
بازیابی ویژگی‌های گسترش‌یافته از فایل.
فایل ورودی باید در قالب تولیدشده توسط دستور
.B getfattr
همراه با گزینه
.B \-\-dump
باشد.
اگر یک خط تیره (\c
.IR \- )
به عنوان نام فایل مشخص شود،
.B setfattr
داده‌ها را از ورودی استاندارد می‌خواند.
.TP
.B \-\-raw
مقدار ویژگی رمزگشایی نشود. می‌تواند برای تنظیم مقادیر به‌دست‌آمده توسط دستور
.B "getfattr \-\-only\-values"
استفاده شود.
.TP
.B \-\-version
چاپ نسخه
.B setfattr
و خروج.
.TP
.B \-\-help
نمایش راهنما برای توضیح گزینه‌های خط فرمان.
.TP
.B \-\-
پایان گزینه‌های خط فرمان.
تمام پارامترهای باقی‌مانده به عنوان نام فایل در نظر گرفته می‌شوند، حتی اگر با کاراکتر خط تیره (داش) آغاز شوند.
.SH "مثال‌ها (EXAMPLES)"
افزودن ویژگی گسترش‌یافته به فضای نام کاربر (user):
.PP
.nf
.B "$ setfattr -n user.foo -v bar file.txt"
.fi
.PP
افزودن مقدار md5sum فایل به عنوان یک ویژگی گسترش‌یافته:
.PP
.nf
.B "# setfattr -n trusted.md5sum -v d41d8cd98f00b204e00998ecf8427e file.txt"
.fi
.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 xattr (7)