.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DBSCAN 1 "March 31, 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
dbscan \- پویش فایل نمایه‌ی پایگاه‌داده‌ی سرور دایرکتوری و استخراج محتویات آن
.SH "خلاصه دستور (SYNOPSIS)"
.B dbscan
\fB-f <filename>\fR [\fI-R\fR] [\fI-t <size>\fR]
[\fI-K <entry_id>\fR] [\fI-k <key>\fR] [\fI-l <size>\fR]
[\fI-G <n>\fR] [\fI-n\fR] [\fI-r\fR] [\fI-s\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
فایل نمایه‌ی پایگاه‌داده سرور دایرکتوری (Directory Server) را پویش کرده و محتویات آن را استخراج و تخلیه (dump) می‌کند.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
.SH "گزینه‌ها (OPTIONS)"
خلاصه‌ای از گزینه‌ها در زیر آمده است:
.IP
گزینه‌های عمومی:
.TP
.B \fB\-A, \-\-ascii\fR
استخراج به صورت داده‌های اسکی (ASCII).
.TP
.B \fB\-D, \-\-db\-type\fR <filename>
تعیین نوع پایگاه‌داده: bdb یا mdb.
.TP
.B \fB\-f, \-\-dbi\fR <filename>
تعیین نمونه پایگاه‌داده (instance).
.TP
.B \fB\-R, \-\-raw\fR
استخراج به صورت داده‌های خام (raw).
.TP
.B \fB\-t, \-\-truncate\-entry\fR <size>
اندازه برش ورودی‌ها (به بایت).
.IP
گزینه‌های فایل ورودی (entry):
.TP
.B \fB\-K, \-\-entry\-id\fR <entry_id>
جستجو و واکشی تنها یک شناسه ورودی خاص.
.IP
گزینه‌های فایل نمایه (index):
.TP
.B \fB\-G, \-\-id\-list\-min\-size\fR <n>
فقط نمایش ورودی‌های نمایه‌ای که بیش از <n> شناسه دارند.
.TP
.B \fB\-I, \-\-import\fR <file>
وارد کردن (ایمپورت) نمونه پایگاه‌داده از فایل. نیازمند پارامتر \-\-do\-it است.
هشدار! تنها نمونه‌های پایگاه‌داده id2entry و replication_changelog توسط dbscan قابل وارد کردن هستند.
.TP
.B \fB\-k, \-\-key\fR <key>
جستجو و واکشی تنها یک کلید مشخص.
.TP
.B \fB\-l, \-\-id\-list\-max\-size\fR <size>
حداکثر طول لیست شناسه‌های استخراج‌شده
(پیش‌فرض ۴۰۹۶؛ ۴۰ بایت <= اندازه <= ۱۰۴۸۵۷۶ بایت).
.TP
.B \fB\-n, \-\-show\-id\-list\-lenghts\fR
نمایش طول لیست‌های شناسه.
.TP
.B \fB\-\-remove\fR
حذف یک نمونه پایگاه‌داده. نیازمند پارامتر \-\-do\-it است.
.TP
.B \fB\-r, \-\-show\-id\-list\fR
نمایش محتویات لیست شناسه.
.TP
.B \fB\-S, \-\-stats\fR
نمایش آمارها.
.TP
.B \fB\-X, \-\-export\fR <file>
صادر کردن (اکسپورت) نمونه پایگاه‌داده به فایل.
.IP
سایر گزینه‌ها:
.TP
.B \fB\-s, \-\-summary\fR
خلاصه تعداد نمایه‌ها.
.TP
.B \fB\-L, \-\-list\fR
فهرست کردن نمونه‌های پایگاه‌داده.
.TP
.B \fB\-\-do\-it\fR
تاییدیه لازم برای اقداماتی که محتویات پایگاه‌داده را تغییر می‌دهند.
.TP
.B \fB\-h, \-\-help\-it\fR
نمایش راهنمای استفاده.
.IP
.SH "نحوه استفاده (USAGE)"
نمونه‌های کاربردی:
.TP
فهرست کردن نمونه‌های پایگاه‌داده:
.B
dbscan -L /var/lib/dirsrv/slapd-supplier1/db
.TP
استخراج فایل ورودی:
.B
dbscan \fB\-f\fR id2entry.db4
.TP
نمایش کلیدهای نمایه در cn.db4:
.B
dbscan \fB\-f\fR cn.db4
.TP
نمایش کلیدهای نمایه در cn روی lmdb:
.B
dbscan \fB\-f\fR /var/lib/dirsrv/slapd\-supplier1/db/userroot/cn.db
 (یادداشت: از \fBdbscan \-L db_home_dir\fR برای دریافت مسیر نمونه پایگاه‌داده استفاده کنید)
.TP
نمایش کلیدهای نمایه و تعداد ورودی‌های دارای آن کلید در mail.db4:
.B
dbscan \fB\-r\fR \fB\-f\fR mail.db4
.TP
نمایش کلیدهای نمایه و شناسه‌های دارای بیش از ۲۰ شناسه در sn.db4:
.B
dbscan \fB\-r\fR \fB\-G\fR 20 \fB\-f\fR sn.db4
.TP
نمایش خلاصه objectclass.db4:
.B
dbscan \fB\-s \-f\fR objectclass.db4
.br
.SH "نویسنده (AUTHOR)"
دستور dbscan توسط پروژه 389 نوشته شده است.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات را به پیوند زیر ارسال کنید:
.br
https://github.com/389ds/389-ds-base/issues/new
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2001 متعلق به Sun Microsystems, Inc. با کسب اجازه استفاده شده است.
.br
حق نشر \(co 2017 متعلق به Red Hat, Inc.
.br
این صفحه راهنما توسط Michele Baldessari <michele@pupazzo.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
.br
این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز Directory Server که در فایل LICENSE این نرم‌افزار قرار دارد بازتوزیع کنید. این مجوز اساساً نسخه ۲ از مجوز عمومی همگانی گنو (GNU GPL) همراه با یک استثنا برای توزیع پلاگین‌ها است.