'\" t .\" Title: sharesec .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/16/2026 .\" Manual: User Commands .\" Source: Samba 4.24.6 .\" Language: English .\" .TH "SHARESEC" "1" "08/16/2026" "Samba 4\&.24\&.6" "User Commands" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" sharesec \- تنظیم یا دریافت ACLهای اشتراک .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u sharesec {sharename} [\-r,\ \-\-remove=ACL] [\-m,\ \-\-modify=ACL] [\-a,\ \-\-add=ACL] [\-R,\ \-\-replace=ACLs] [\-D,\ \-\-delete] [\-v,\ \-\-view] [\-\-view\-all] [\-M,\ \-\-machine\-sid] [\-F,\ \-\-force] [\-d,\ \-\-debuglevel=DEBUGLEVEL] [\-s,\ \-\-configfile=CONFIGFILE] [\-l,\ \-\-log\-basename=LOGFILEBASE] [\-S,\ \-\-setsddl=STRING] [\-\-viewsddl] [\-?|\-\-help] [\-\-usage] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-\-configfile=CONFIGFILE] [\-\-option=name=value] [\-l|\-\-log\-basename=LOGFILEBASE] [\-\-leak\-report] [\-\-leak\-report\-full] .SH "توضیحات (DESCRIPTION)" .PP این ابزار بخشی از مجموعهٔ \fBsamba\fR(7) است\&. .PP برنامهٔ sharesec مجوزهای اشتراک را روی اشتراک‌های فایل SMB مدیریت و تنظیم می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های زیر برای برنامهٔ sharesec در دسترس هستند\&. ساختار ACLها در بخش «قالب ACL» شرح داده شده است\&. .PP \-a|\-\-add=ACL .RS 4 افزودن ACEهای مشخص‌شده به فهرست ACL\&. .RE .PP \-D|\-\-delete .RS 4 حذف کامل توصیف‌گر امنیت (security descriptor)\&. .RE .PP \-F|\-\-force .RS 4 اجبار در ذخیره‌سازی ACL\&. .RE .PP \-m|\-\-modify=ACL .RS 4 ویرایش ACEهای موجود\&. .RE .PP \-M|\-\-machine\-sid .RS 4 مقداردهی اولیه SID ماشین\&. .RE .PP \-r|\-\-remove=ACL .RS 4 حذف ACEها\&. .RE .PP \-R|\-\-replace=ACLS .RS 4 بازنویسی و جایگزینی ACL مجوزهای اشتراک موجود\&. .RE .PP \-v|\-\-view .RS 4 نمایش فهرست ACL یک اشتراک\&. .RE .PP \-\-view\-all .RS 4 نمایش فهرست ACLهای تمامی اشتراک‌ها\&. .RE .PP \-S|\-\-setsddl=STRING .RS 4 تنظیم توصیف‌گر امنیت با ارائهٔ ACL در قالب SDDL\&. .RE .PP \-\-viewsddl .RS 4 نمایش فهرست ACL یک اشتراک در قالب SDDL\&. .RE .PP \-?|\-\-help .RS 4 چاپ خلاصه‌ای از گزینه‌های خط فرمان\&. .RE .PP \-\-usage .RS 4 نمایش پیام کوتاه نحوهٔ استفاده از دستور\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 \fIlevel\fR عددی صحیح از 0 تا 10 است\&. مقدار پیش‌فرض در صورت مشخص نشدن این پارامتر برای برنامه‌های کلاینت برابر با 1 است\&. .sp هرچه این مقدار بالاتر باشد، جزئیات بیشتری دربارهٔ فعالیت‌های سرور در فایل‌های لاگ ثبت خواهد شد\&. در سطح 0، فقط خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند\&. سطح 1 سطحی معقول برای اجرای روزمره است \- که حجم کمی از اطلاعات دربارهٔ عملیات‌های انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از 1 مقادیر قابل توجهی داده‌های لاگ تولید خواهند کرد و تنها باید هنگام بررسی یک مشکل استفاده شوند\&. سطوح بالاتر از 3 فقط برای استفادهٔ توسعه‌دهندگان طراحی شده‌اند و حجم عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار فنی و پیچیده هستند\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، پارامتر \m[blue]\fBlog level\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-\-debug\-stdout .RS 4 این گزینه خروجی اشکال‌زدایی را به STDOUT هدایت می‌کند\&. به‌طور پیش‌فرض تمام کلاینت‌ها وقایع را در STDERR ثبت می‌کنند\&. .RE .PP \-\-configfile= .RS 4 فایل مشخص‌شده حاوی جزئیات پیکربندی مورد نیاز کلاینت است\&. اطلاعات موجود در این فایل می‌تواند برای کلاینت و سرور عمومی باشد یا صرفاً گزینه‌های مختص کلاینت مانند \m[blue]\fBclient smb encrypt\fR\m[] را ارائه دهد\&. برای اطلاعات بیشتر فایل /etc/samba/smb\&.conf را ببینید\&. نام پیش‌فرض فایل پیکربندی در زمان کامپایل تعیین می‌شود\&. .RE .PP \-\-option== .RS 4 گزینهٔ \fBsmb.conf\fR(5) «» را روی مقدار «» از طریق خط فرمان تنظیم می‌کند\&. این مقدار پیش‌فرض‌های زمان کامپایل و گزینه‌های خوانده‌شده از فایل پیکربندی را بازنویسی می‌کند\&. اگر نام یا مقداری شامل فاصله باشد، کل عبارت \-\-option=name=value را داخل علامت نقل‌قول قرار دهید\&. .RE .PP \-l|\-\-log\-basename=logdirectory .RS 4 نام دایرکتوری پایه برای فایل‌های لاگ/اشکال‌زدایی\&. پسوند \fB"\&.progname"\fR به انتهای آن افزوده خواهد شد (مانند log\&.smbclient، log\&.smbd و غیره)\&. این فایل لاگ هرگز توسط کلاینت حذف نمی‌شود\&. .RE .PP \-\-leak\-report .RS 4 فعال‌سازی گزارش نشت حافظهٔ talloc هنگام خروج\&. .RE .PP \-\-leak\-report\-full .RS 4 فعال‌سازی گزارش کامل نشت حافظهٔ talloc هنگام خروج\&. .RE .PP \-V|\-\-version .RS 4 شماره نسخهٔ برنامه را چاپ می‌کند\&. .RE.SH "قالب ACL (ACL FORMAT)" .PP قالب یک ACL شامل یک یا چند مدخل ACL است که با ویرگول یا خط جدید از هم جدا شده‌اند\&. هر مدخل ACL یکی از موارد زیر است: .PP .if n \{\ .RS 4 .\} .nf REVISION: OWNER: GROUP: ACL::// .fi .if n \{\ .RE .\} .PP مقدار revision در ACL، نگارش داخلی Windows NT ACL را برای توصیف‌گر امنیت (security descriptor) مشخص می‌کند\&. اگر مشخص نشود، پیش‌فرض آن 1 است\&. استفاده از مقادیری غیر از 1 ممکن است رفتارهای غیرمنتظره‌ای ایجاد کند\&. .PP فیلدهای owner و group شناسهٔ SID مالک و گروه را برای شیء مشخص می‌کنند\&. فهرست‌های کنترل دسترسی اشتراک (Share ACLs) مالک یا گروهی تعیین نمی‌کنند، بنابراین این فیلدها خالی هستند\&. .PP فهرست‌های ACL مجوزهای اعطا شده به SID را تعیین می‌کنند\&. این SID می‌تواند در قالب S\-1\-x\-y\-z یا به‌صورت یک نام مشخص شود که در این حالت توسط سروری که فایل یا دایرکتوری در آن قرار دارد ارزیابی و ترجمه می‌شود\&. مقادیر type،‏ flags و mask نوع دسترسی اعطا شده به SID را تعیین می‌کنند\&. .PP مقدار type می‌تواند برای مجاز کردن یا منع دسترسی SID، یکی از مقادیر ALLOWED یا DENIED باشد\&. مقادیر flags معمولاً برای Share ACLها صفر هستند\&. .PP مقدار mask مقداری است که حق دسترسی اعطا شده به SID را بیان می‌کند\&. این مقدار می‌تواند به‌صورت ده‌دهی یا هگزادسیمال، یا با استفاده از یکی از رشته‌های متنی زیر مشخص شود که با مجوزهای فایل NT با همین نام متناظر هستند\&. .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIR\fR \- مجاز کردن دسترسی خواندن .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIW\fR \- مجاز کردن دسترسی نوشتن .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIX\fR \- مجوز اجرا روی شیء .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fID\fR \- حذف شیء .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIP\fR \- تغییر مجوزها .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIO\fR \- در اختیار گرفتن مالکیت .RE .sp .RE .PP مجوزهای ترکیبی زیر را می‌توان مشخص کرد: .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIREAD\fR \- معادل با مجوزهای \*(AqRX\*(Aq .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fICHANGE\fR \- معادل با مجوزهای \*(AqRXWD\*(Aq .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIFULL\fR \- معادل با مجوزهای \*(AqRWXDPO\*(Aq .RE.SH "وضعیت خروج (EXIT STATUS)" .PP برنامه sharesec وضعیت خروج را بسته به موفقیت یا عدم موفقیت عملیات انجام‌شده تنظیم می‌کند\&. وضعیت خروج ممکن است یکی از مقادیر زیر باشد\&. .PP اگر عملیات با موفقیت انجام شود، sharesec وضعیت خروج 0 را برمی‌گرداند\&. اگر sharesec نتواند به سرور مشخص‌شده متصل شود، یا در دریافت یا تنظیم ACLها خطایی رخ دهد، وضعیت خروج 1 بازگردانده می‌شود\&. اگر در تجزیه هر یک از آرگومان‌های خط فرمان خطایی رخ دهد، وضعیت خروج 2 بازگردانده می‌شود\&. .SH "مثال‌ها (EXAMPLES)" .PP افزودن دسترسی کامل برای SID \fIS\-1\-5\-21\-1866488690\-1365729215\-3963860297\-17724\fR روی \fIshare\fR: .sp .if n \{\ .RS 4 .\} .nf host:~ # sharesec share \-a S\-1\-5\-21\-1866488690\-1365729215\-3963860297\-17724:ALLOWED/0/FULL .fi .if n \{\ .RE .\} .PP فهرست کردن تمام ACEها برای \fIshare\fR: .sp .if n \{\ .RS 4 .\} .nf host:~ # sharesec share \-v REVISION:1 CONTROL:SR|DP OWNER: GROUP: ACL:S\-1\-1\-0:ALLOWED/0x0/FULL ACL:S\-1\-5\-21\-1866488690\-1365729215\-3963860297\-17724:ALLOWED/0x0/FULL .fi .if n \{\ .RE .\} .SH "نسخه (VERSION)" .PP این صفحه راهنما بخشی از نسخه 4\&.24\&.6 مجموعه Samba است\&. .SH "نویسندگان (AUTHORS)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند\&. Samba اکنون توسط Samba Team به عنوان یک پروژه متن‌باز به شیوه‌ای مشابه توسعه هسته لینوکس توسعه داده می‌شود\&.