'\" t .\" Title: dbwrap_tool .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/16/2026 .\" Manual: ابزارهای مدیریت سیستم .\" Source: Samba 4.24.6 .\" Language: Persian .\" .TH "DBWRAP_TOOL" "1" "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)" dbwrap_tool \- ابزار سطح پایین دستکاری TDB/CTDB با استفاده از رابط dbwrap .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u dbwrap_tool [\-?|\-\-help] [\-\-usage] [\-\-persistent] [\-\-non\-persistent] [\-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 برنامهٔ dbwrap_tool برای خواندن و دستکاری پایگاه‌های دادهٔ TDB/CTDB با استفاده از رابط dbwrap به کار می‌رود\&. .PP عملیات‌های پایگاه دادهٔ زیر در دسترس هستند: .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} fetch: واکشی یک رکورد .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} store: ایجاد یا تغییر یک رکورد .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} delete: حذف یک رکورد .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} exists: بررسی وجود داشتن یک رکورد .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} erase: حذف تمام رکوردها .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} listkeys: فهرست کردن تمام رکوردهای موجود .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} listwatchers: فهرست کردن فرایندهایی که منتظر ایجاد تغییر در یک رکورد هستند .RE .sp .RE .PP انواع داده‌ای زیر در دسترس هستند: .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} int32: عدد صحیح ۳۲ بیتی علامت‌دار .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} uint32: عدد صحیح ۳۲ بیتی بدون علامت .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} string: "hello world" .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} hex: رشته‌های هگز مانند "68656C6C6F20776F726C6400" ("hello world") .RE .sp .RE.SH "گزینه‌ها (OPTIONS)" .PP \-\-persistent .RS 4 پایگاه داده را به عنوان یک پایگاه داده پایا (persistent) باز می‌کند\&. .sp دقیقاً یکی از گزینه‌های \-\-persistent یا \-\-non\-persistent باید مشخص شود\&. .RE .PP \-\-non\-persistent .RS 4 پایگاه داده را به عنوان یک پایگاه داده ناپایا (non\-persistent) باز می‌کند\&. .sp هشدار: باز کردن پایگاه داده به صورت ناپایا در صورتی که در حال حاضر بازکننده دیگری وجود نداشته باشد، محتویات پایگاه داده را پاک خواهد کرد\&. .sp دقیقاً یکی از گزینه‌های \-\-persistent یا \-\-non\-persistent باید مشخص شود\&. .RE .PP \-?|\-\-help .RS 4 خلاصه‌ای از گزینه‌های خط فرمان را چاپ می‌کند\&. .RE .PP \-\-usage .RS 4 پیام کوتاهی از نحوه استفاده را نمایش می‌دهد\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 \fIlevel\fR یک عدد صحیح از 0 تا 10 است\&. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض برای برنامه‌های کلاینت برابر با 1 است\&. .sp هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیت‌های سرور در فایل‌های گزارش (log) ثبت خواهد شد\&. در سطح 0، تنها خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند\&. سطح 1 یک سطح معقول برای اجرای روزمره است \- مقدار کمی اطلاعات درباره عملیات انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از 1 مقادیر قابل توجهی داده‌های لاگ تولید می‌کنند و تنها باید هنگام بررسی یک مشکل استفاده شوند\&. سطوح بالاتر از 3 فقط برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم بسیار عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار نامفهوم هستند\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، پارامتر \m[blue]\fBlog level\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی (override) می‌کند\&. .RE .PP \-\-debug\-stdout .RS 4 خروجی اشکال‌زدایی (debug) را به 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) با نام "" به مقدار "" از خط فرمان\&. این کار مقادیر پیش‌فرض زمان کامپایل و گزینه‌های خوانده‌شده از فایل پیکربندی را بازنویسی می‌کند\&. اگر یک نام یا مقدار حاوی فاصله (space) است، کل عبارت \-\-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 "دستورها (COMMANDS)" .SS "fetch" .HP \w'\ 'u dbwrap_tool fetch .SS "store" .HP \w'\ 'u dbwrap_tool store .SS "delete" .HP \w'\ 'u dbwrap_tool delete .SS "exists" .HP \w'\ 'u dbwrap_tool exists .SS "erase" .HP \w'\ 'u dbwrap_tool erase .SS "listkeys" .HP \w'\ 'u dbwrap_tool listkeys .SS "listwatchers" .HP \w'\ 'u dbwrap_tool listwatchers .SH "مثال‌ها (EXAMPLES)" .PP فهرست کردن تمام کلیدها از winbindd_idmap\&.tdb .RS 4 dbwrap_tool \-\-persistent winbindd_idmap\&.tdb listkeys .RE .PP واکشی رکورد با کلید "USER HWM" در قالب uint32 .RS 4 dbwrap_tool \-\-persistent winbindd_idmap\&.tdb fetch "USER HWM" uint32 .RE .PP حذف رکورد با کلید "USER HWM" .RS 4 dbwrap_tool \-\-persistent winbindd_idmap\&.tdb remove "USER HWM" .RE .PP ذخیره و بازنویسی رکورد "USER HWM" با مقدار 214 .RS 4 uint32: dbwrap_tool \-\-persistent winbindd_idmap\&.tdb store "USER HWM" uint32 214 hex: dbwrap_tool \-\-persistent winbindd_idmap\&.tdb store "USER HWM" hex D6000000 .RE .SH "نکات (NOTES)" .PP با احتیاط استفاده شود! .SH "نسخه (VERSION)" .PP این صفحهٔ راهنما بخشی از نسخهٔ 4\&.24\&.6 از مجموعهٔ Samba است\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBsmbd\fR(8), \fBsamba\fR(7) .SH "نویسندگان (AUTHORS)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند\&. اکنون Samba توسط Samba Team به‌عنوان پروژه‌ای متن‌باز، به شیوه‌ای مشابه توسعهٔ هستهٔ لینوکس، توسعه داده می‌شود\&. .PP صفحهٔ راهنمای dbwrap_tool توسط Bjoern Baumbach نوشته شده است\&.