.\" Copyright (C) 2001, 2002, 2004  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 CHACL 1 "ACL File Utilities" "September 2001" "Access Control Lists"
.SH "نام (NAME)"
chacl \- تغییر لیست کنترل دسترسی یک فایل یا دایرکتوری
.SH "خلاصه دستور (SYNOPSIS)"
.B chacl acl pathname...
.br
.B chacl \-b acl dacl pathname...
.br
.B chacl \-d dacl pathname...
.br
.B chacl \-R pathname...
.br
.B chacl \-D pathname...
.br
.B chacl \-B pathname...
.br
.B chacl \-l pathname...
.br
.B chacl \-r pathname...
.br
.SH "توضیحات (DESCRIPTION)"
دستور
.B chacl
یک ابزار سازگاری با IRIX است و برای آن دسته از کاربرانی نگهداری می‌شود که با کاربرد آن در XFS یا IRIX آشنایی دارند. برای شرح ابزارهایی که با پیش‌نویس (پس‌گرفته‌شده) استاندارد POSIX 1003.1e توصیف‌کننده لیست‌های کنترل دسترسی
.RB ( ACL )
تطابق بیشتری دارند، به بخش
.B "همچنین ببینید (SEE ALSO)"
در ادامه مراجعه فرمایید.
.PP
دستور
.B chacl
لیست(های) کنترل دسترسی
.RB ( ACL )
یک فایل یا دایرکتوری را تغییر می‌دهد. لیست(های) مشخص‌شده بر روی هر یک از فایل‌های تعیین‌شده در آرگومان‌های
.I pathname
اعمال می‌شوند.
.PP
هر ACL یک رشته متنی است که با استفاده از روال
.IR acl_from_text (3)
تفسیر می‌گردد. این رشته‌ها از بندهایی تشکیل شده‌اند که با ویرگول از یکدیگر جدا شده و هر کدام به قالب
.BR tag:name:perm
هستند. در این ساختار،
.I tag
می‌تواند یکی از مقادیر زیر باشد:
.TP
.BR user " (یا " u ")"
نشان‌دهنده این است که ورودی، یک مدخل ACL کاربری
.RB ( user )
است.
.TP
.BR group " (یا " g ")"
نشان‌دهنده این است که ورودی، یک مدخل ACL گروهی
.RB ( group )
است.
.TP
.BR other " (یا " o ")"
نشان‌دهنده این است که ورودی، یک مدخل ACL برای سایرین
.RB ( other )
است.
.TP
.BR mask " (یا " m ")"
نشان‌دهنده این است که ورودی، یک مدخل ماسک
.RB ( mask )
است.
.PP
.I name
رشته‌ای است که نام کاربر یا گروه را برای مدخل ACL تعیین می‌کند. یک
.I name
خالی در مدخل ACL کاربر یا گروه، نشان‌دهنده مالک فایل یا گروه فایل است.
.PP
.I perm
رشته‌ای از نویسه‌های "rwx" است که در آن هر یک از نویسه‌ها می‌تواند با یک "\-" جایگزین شود تا عدم دسترسی از آن نوع را نشان دهد؛ مانند "r\-x"، "\-\-x" یا "\-\-\-".
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-b
نشان می‌دهد که دو ACL برای تغییر وجود دارد؛ اولی ACL دسترسی فایل و دومی ACL پیش‌فرض دایرکتوری است.
.TP
.B \-d
تنها برای تنظیم ACL پیش‌فرض یک دایرکتوری به کار می‌رود.
.TP
.B \-R
تنها ACL دسترسی فایل را حذف می‌کند.
.TP
.B \-D
تنها ACL پیش‌فرض دایرکتوری را حذف می‌کند.
.TP
.B \-B
تمام ACLها را حذف می‌کند.
.TP
.B \-l
لیست کنترل دسترسی و در صورت وجود، ACL پیش‌فرض مرتبط با فایل‌ها یا دایرکتوری‌های مشخص‌شده را فهرست می‌کند. این گزینه در حین پورت XFS به لینوکس افزوده شد و با IRIX سازگار نیست.
.TP
.B \-r
لیست کنترل دسترسی را به صورت بازگشتی برای هر زیرشاخه با ریشه در
.I pathname
تنظیم می‌کند. این گزینه نیز در حین پورت XFS به لینوکس اضافه شد و با IRIX سازگار نیست.
.SH "مثال‌ها (EXAMPLES)"
یک ACL پایه و حداقل:
.PP
.nf
  \fBchacl u::rwx,g::r\-x,o::r\-\- file\fP
.fi
.PP
در این مثال، ACL فایل به‌گونه‌ای تنظیم می‌شود که مالک فایل دارای دسترسی "rwx"، گروه فایل دارای دسترسی خواندن و اجرا (r\-x) و سایرین تنها دارای دسترسی خواندن (r\-\-) به فایل باشند.
.PP
یک ACL که فراتر از حداقل باشد—یعنی کاربری یا گروهی غیر از مالک فایل یا گروه مالک را تعیین کند—باید حتماً شامل یک مدخل ماسک (mask) باشد:
.PP
.nf
  \fBchacl u::rwx,g::r\-x,o::r\-\-,u:bob:r\-\-,m::r\-x file1 file2\fP
.fi
.PP
برای تنظیم ACLهای دسترسی و پیش‌فرض در دایرکتوری
.I newdir
به طوری که دقیقاً مشابه
.I olddir
باشد، می‌توانید دستور زیر را وارد نمایید:
.PP
.nf
  \fBchacl \-b `chacl \-l olddir | \\
      sed \-e 's/.*\\[//' \-e 's#/# #' \-e 's/]$//'` newdir\fP
.fi
.SH "هشدارها (CAUTIONS)"
دستور
.B chacl
می‌تواند ACL موجود را جایگزین کند. برای افزودن یا حذف مدخل‌ها، باید ابتدا از دستور
.B "chacl \-l"
برای دریافت ACL موجود استفاده کرده و از خروجی آن برای تشکیل آرگومان‌های دستور
.B chacl
بهره بگیرید.
.PP
تغییر بیت‌های مجوز دسترسی یک فایل، تنظیمات ACL دسترسی فایل را تغییر خواهد داد (ببینید:
.IR chmod (1)).
با این حال، ماسک‌های حالت ایجاد فایل (ببینید:
.IR umask (1))
بر تنظیمات ACL دسترسی فایل‌هایی که با استفاده از ACLهای پیش‌فرض دایرکتوری ایجاد شده‌اند، تأثیری نخواهد گذاشت.
.PP
لیست‌های کنترل دسترسی
.RB ( ACLs )
ویژگی‌های توسعه‌یافته سیستم‌فایل هستند و به همین دلیل معمولاً توسط ابزارهای مرسوم و سنتی پشتیبان‌گیری، ذخیره یا بازیابی نمی‌شوند. برای اطلاعات بیشتر درباره ویژگی‌های توسعه‌یافته به
.IR attr (5)
و برای اطلاع از نحوه پشتیبان‌گیری از آن‌ها تحت سیستم‌فایل XFS به
.IR xfsdump (8)
مراجعه فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.BR getfacl (1),
.BR setfacl (1),
.BR chmod (1),
.BR umask (1),
.BR acl_from_text (3),
.BR acl (5),
.BR xfsdump (8)