نام (NAME)

dbwrap_tool - ابزار سطح پایین دستکاری TDB/CTDB با استفاده از رابط dbwrap

خلاصه دستور (SYNOPSIS)

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] {<database>} {<operation>} [<key> [<type> [<value>]]]

توضیحات (DESCRIPTION)

این ابزار بخشی از مجموعهٔ samba(7) است.

برنامهٔ dbwrap_tool برای خواندن و دستکاری پایگاه‌های دادهٔ TDB/CTDB با استفاده از رابط dbwrap به کار می‌رود.

عملیات‌های پایگاه دادهٔ زیر در دسترس هستند:

•fetch: واکشی یک رکورد

•store: ایجاد یا تغییر یک رکورد

•delete: حذف یک رکورد

•exists: بررسی وجود داشتن یک رکورد

•erase: حذف تمام رکوردها

•listkeys: فهرست کردن تمام رکوردهای موجود

•listwatchers: فهرست کردن فرایندهایی که منتظر ایجاد تغییر در یک رکورد هستند

انواع داده‌ای زیر در دسترس هستند:

•int32: عدد صحیح ۳۲ بیتی علامت‌دار

•uint32: عدد صحیح ۳۲ بیتی بدون علامت

•string: "hello world"

•hex: رشته‌های هگز مانند "68656C6C6F20776F726C6400" ("hello world")

--persistent

پایگاه داده را به عنوان یک پایگاه داده پایا (persistent) باز می‌کند.

دقیقاً یکی از گزینه‌های --persistent یا --non-persistent باید مشخص شود.

--non-persistent

پایگاه داده را به عنوان یک پایگاه داده ناپایا (non-persistent) باز می‌کند.

هشدار: باز کردن پایگاه داده به صورت ناپایا در صورتی که در حال حاضر بازکننده دیگری وجود نداشته باشد، محتویات پایگاه داده را پاک خواهد کرد.

دقیقاً یکی از گزینه‌های --persistent یا --non-persistent باید مشخص شود.

-?|--help

خلاصه‌ای از گزینه‌های خط فرمان را چاپ می‌کند.

--usage

پیام کوتاهی از نحوه استفاده را نمایش می‌دهد.

-d|--debuglevel=level

level یک عدد صحیح از 0 تا 10 است. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض برای برنامه‌های کلاینت برابر با 1 است.

هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیت‌های سرور در فایل‌های گزارش (log) ثبت خواهد شد. در سطح 0، تنها خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند. سطح 1 یک سطح معقول برای اجرای روزمره است - مقدار کمی اطلاعات درباره عملیات انجام‌شده تولید می‌کند.

سطوح بالاتر از 1 مقادیر قابل توجهی داده‌های لاگ تولید می‌کنند و تنها باید هنگام بررسی یک مشکل استفاده شوند. سطوح بالاتر از 3 فقط برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم بسیار عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار نامفهوم هستند.

توجه داشته باشید که مشخص کردن این پارامتر در اینجا، پارامتر log level را در فایل /etc/samba/smb.conf بازنویسی (override) می‌کند.

--debug-stdout

خروجی اشکال‌زدایی (debug) را به STDOUT هدایت می‌کند. به طور پیش‌فرض، تمام کلاینت‌ها وقایع را در STDERR ثبت می‌کنند.

--configfile=<configuration file>;

فایل مشخص‌شده شامل جزئیات پیکربندی مورد نیاز کلاینت است. اطلاعات موجود در این فایل می‌تواند برای کلاینت و سرور عمومی باشد یا تنها گزینه‌های مختص به کلاینت نظیر client smb encrypt را ارائه دهد. برای اطلاعات بیشتر به /etc/samba/smb.conf مراجعه کنید. نام پیش‌فرض فایل پیکربندی در زمان کامپایل تعیین می‌شود.

--option=<name>=<value>

تنظیم گزینه smb.conf(5) با نام "<name>" به مقدار "<value>" از خط فرمان. این کار مقادیر پیش‌فرض زمان کامپایل و گزینه‌های خوانده‌شده از فایل پیکربندی را بازنویسی می‌کند. اگر یک نام یا مقدار حاوی فاصله (space) است، کل عبارت --option=name=value را درون گیومه قرار دهید.

-l|--log-basename=logdirectory

نام دایرکتوری پایه برای فایل‌های لاگ/اشکال‌زدایی. پسوند ".progname" پیوست خواهد شد (به عنوان مثال log.smbclient،‏ log.smbd و غیره). فایل لاگ هرگز توسط کلاینت حذف نمی‌شود.

--leak-report

فعال‌سازی گزارش نشت حافظه talloc در هنگام خروج.

--leak-report-full

فعال‌سازی گزارش کامل نشت حافظه talloc در هنگام خروج.

-V|--version

شماره نسخه برنامه را چاپ می‌کند.

fetch

dbwrap_tool <database> fetch <key> <type>

store

dbwrap_tool <database> store <key> <type> <value>

delete

dbwrap_tool <database> delete <key>

exists

dbwrap_tool <database> exists <key>

erase

dbwrap_tool <database> erase

listkeys

dbwrap_tool <database> listkeys

listwatchers

dbwrap_tool <database> listwatchers

مثال‌ها (EXAMPLES)

فهرست کردن تمام کلیدها از winbindd_idmap.tdb

dbwrap_tool --persistent winbindd_idmap.tdb listkeys

واکشی رکورد با کلید "USER HWM" در قالب uint32

dbwrap_tool --persistent winbindd_idmap.tdb fetch "USER HWM" uint32

حذف رکورد با کلید "USER HWM"

dbwrap_tool --persistent winbindd_idmap.tdb remove "USER HWM"

ذخیره و بازنویسی رکورد "USER HWM" با مقدار 214

uint32: dbwrap_tool --persistent winbindd_idmap.tdb store "USER HWM" uint32 214 hex: dbwrap_tool --persistent winbindd_idmap.tdb store "USER HWM" hex D6000000

نکات (NOTES)

با احتیاط استفاده شود!

نسخه (VERSION)

این صفحهٔ راهنما بخشی از نسخهٔ 4.24.6 از مجموعهٔ Samba است.

همچنین ببینید (SEE ALSO)

smbd(8), samba(7)

نویسندگان (AUTHORS)

نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند. اکنون Samba توسط Samba Team به‌عنوان پروژه‌ای متن‌باز، به شیوه‌ای مشابه توسعهٔ هستهٔ لینوکس، توسعه داده می‌شود.

صفحهٔ راهنمای dbwrap_tool توسط Bjoern Baumbach نوشته شده است.