'" t
."     Title: idmap_tdb2
."    Author: [see the "AUTHOR" section]
." Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
."      Date: 08/16/2026
."    Manual: ابزارهای مدیریت سیستم
."    Source: Samba 4\&.24\&.6
."  Language: Persian
."
.TH "IDMAP_TDB2" "8" "08/16/2026" "Samba 4\&.24\&.6" "ابزارهای مدیریت سیستم"
." -----------------------------------------------------------------
." * 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)"
idmap_tdb2 \- پشتیبان idmap_tdb2 سامبا برای Winbind
.SH "توضیحات (DESCRIPTION)"
.PP
پلاگین
.B idmap_tdb2
جایگزینی برای پشتیبان پیش‌فرض
.B idmap_tdb
است که توسط
.B winbindd
جهت ذخیره جدول‌های نگاشت SID/uid/gid در محیط‌های خوشه‌ای به همراه Samba و CTDB استفاده می‌شود.
.PP
در مقایسه با پشتیبان‌های فقط‌خواندنی مانند
.BR idmap_rid ،
این یک پشتیبان تخصیص‌دهنده است؛ بدین معنی که برای ایجاد نگاشت‌های جدید باید شناسه‌های کاربری و گروهی جدید تخصیص دهد.
.SH "گزینه‌های IDMAP (IDMAP OPTIONS)"
.PP
range = low \- high
.RS 4
محدوده معتبر شناسه‌های uid و gid در دسترس را که این پشتیبان برای آن‌ها مرجعیت دارد تعریف می‌کند.
.RE
.PP
script
.RS 4
از این گزینه می‌توان برای پیکربندی یک برنامه خارجی جهت انجام نگاشت شناسه‌ها به جای استفاده از شمارنده tdb استفاده کرد. سپس نگاشت‌ها در پایگاه‌داده idmap مربوط به tdb2 ذخیره می‌شوند. برای جزئیات بخش اسکریپت IDMAP را در زیر ببینید.
.RE
.SH "اسکریپت IDMAP (IDMAP SCRIPT)"
.PP
پشتیبان idmap مربوط به tdb2 از اجرای یک برنامه خارجی برای انجام نگاشت‌های شناسه از طریق گزینه
\fIidmap config * : script\fR
در فایل smb\&.conf یا شکل قدیمی و منسوخ آن یعنی
\fIidmap : script\fR
پشتیبانی می‌کند.
.PP
نگاشت‌های دریافت‌شده توسط اسکریپت به جای نگاشت‌های ایجادشده توسط شمارنده‌های افزایشی شناسه، در پایگاه‌داده idmap tdb2 ذخیره می‌شوند. بنابراین بسیار مهم است که اسکریپت تمام دامنه SIDهایی را که ممکن است برای نگاشت SID به شناسه یونیکس ارسال شوند پوشش دهد؛ زیرا در غیر این صورت ممکن است SIDهایی که توسط اسکریپت نگاشت نشده‌اند به شناسه‌هایی نگاشت شوند که قبلاً توسط اسکریپت تخصیص یافته‌اند.
.PP
اسکریپت باید گزینه‌های خط فرمان زیر را بپذیرد:
.sp
.if n \{\
.RS 4
.\}
.nf
	SIDTOID S\-1\-xxxx
	IDTOSID UID xxxx
	IDTOSID GID xxxx
.fi
.if n \{\
.RE
.\}
.PP
و باید یکی از پاسخ‌های زیر را به عنوان یک خط متن برگرداند:
.sp
.if n \{\
.RS 4
.\}
.nf
	UID:yyyy
	GID:yyyy
	SID:yyyy
	ERR:yyyy
.fi
.if n \{\
.RE
.\}
.SH "مثال‌ها (EXAMPLES)"
.PP
این مثال نحوه استفاده از tdb2 را به عنوان پشتیبان پیش‌فرض idmap نشان می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
	[global]
	idmap config * : backend = tdb2
	idmap config * : range = 1000000\-2000000
.fi
.if n \{\
.RE
.\}
.PP
این مثال نحوه استفاده از tdb2 را به عنوان پشتیبان پیش‌فرض idmap با استفاده از یک برنامه خارجی از طریق پارامتر script نشان می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
	[global]
	idmap config * : backend = tdb2
	idmap config * : range = 1000000\-2000000
	idmap config * : script = /usr/local/samba/bin/idmap_script\&.sh
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.PP
نرم‌افزار اصلی سامبا و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند. سامبا اکنون توسط تیم سامبا (Samba Team) به عنوان یک پروژه متن‌باز مشابه روش توسعه هسته لینوکس توسعه داده می‌شود.