.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MAKEDBZ 8"
.TH MAKEDBZ 8 2024-05-19 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
makedbz \- بازسازی پایگاه داده تاریخچه INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBmakedbz\fR [\fB\-io\fR] [\fB\-f\fR \fIfilename\fR] [\fB\-s\fR \fIsize\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBmakedbz\fR
پایگاه داده
\&\fIdbz\fR
(که به عنوان فایل
\&\fIhistory\fR
نیز شناخته می‌شود) را بازسازی می‌کند.
نام پیش‌فرض فایل متنی
\&\fIpathdb\fR/history
است؛ برای مشخص کردن نامی دیگر، از فلگ
\&\fB\-f\fR
استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfilename\fR" 4
.IX Item "-f filename"
اگر فلگ
\&\fB\-f\fR
استفاده شود، نام فایل‌های پایگاه داده به صورت
\&\f(CW\*(C`\fR\f(CIfilename\fR\f(CW.dir\*(C'\fR،
\&\f(CW\*(C`\fR\f(CIfilename\fR\f(CW.index\*(C'\fR
و
\&\f(CW\*(C`\fR\f(CIfilename\fR\f(CW.hash\*(C'\fR
خواهد بود. اگر از فلگ
\&\fB\-f\fR
استفاده نشود، یک پیوند موقت به نام
\&\f(CW\*(C`history.n\*(C'\fR
ایجاد می‌شود و فایل‌های پایگاه داده به صورت
\&\f(CW\*(C`history.n.index\*(C'\fR،
\&\f(CW\*(C`history.n.hash\*(C'\fR
و
\&\f(CW\*(C`history.n.dir\*(C'\fR
نوشته می‌شوند.
.IP \fB\-i\fR 4
.IX Item "-i"
برای نادیده گرفتن پایگاه داده قدیمی هنگام تعیین اندازه پایگاه داده جدید، از فلگ
\&\fB\-i\fR
استفاده کنید. استفاده از فلگ‌های
\&\fB\-o\fR
یا
\&\fB\-s\fR
به معنای اعمال ضمنی فلگ
\&\fB\-i\fR
است.
.Sp
هنگامی که پایگاه داده قدیمی نادیده گرفته شود و اندازه با
\&\fB\-s\fR
مشخص نشده باشد،
\&\fBmakedbz\fR
تعداد خطوط فایل متنی فعلی
\&\fIhistory\fR
را می‌شمارد، 10% به این تعداد اضافه می‌کند (برای مقالاتی که در ادامه می‌رسند)، و 50% دیگر (یا در صورت استفاده از قالب کندتر هش برچسب‌دار، 100%) اضافه می‌کند تا اندازه پایگاه داده جدید مشخص شود. هدف، بهینه‌سازی عملکرد پایگاه داده و نگه داشتن میزان پر شدن آن زیر 2/3 اندازه‌اش (یا 1/2 در قالب هش برچسب‌دار) است.
.Sp
اگر هیچ فایل متنی
\&\fIhistory\fR
وجود نداشته باشد، پایگاه داده جدید اندازه پیش‌فرض ایجاد را خواهد داشت (به
\&\fB\-s\fR
مراجعه کنید).
.IP \fB\-o\fR 4
.IX Item "-o"
اگر فلگ
\&\fB\-o\fR
استفاده شود، پیوند موقت به
\&\f(CW\*(C`history.n\*(C'\fR
(یا نام مشخص‌شده با فلگ
\&\fB\-f\fR)
ایجاد نمی‌شود و تمام فایل‌های موجود
\&\fIhistory\fR
بازنویسی می‌شوند. اگر پایگاه داده قدیمی وجود داشته باشد،
\&\fBmakedbz\fR
از آن برای تعیین اندازه پایگاه داده جدید استفاده خواهد کرد (به
\&\fB\-i\fR
مراجعه کنید).
.IP "\fB\-s\fR \fIsize\fR" 4
.IX Item "-s size"
همچنین اگر از فلگ
\&\fB\-s\fR
برای مشخص کردن تعداد تقریبی مدخل‌ها در پایگاه داده جدید استفاده شود،
\&\fBmakedbz\fR
هرگونه پایگاه داده قدیمی را نادیده می‌گیرد. مشخص کردن دقیق اندازه، یک بهینه‌سازی است که پایگاه داده کارآمدتری ایجاد می‌کند. کارساز اخبار همچنان مقالات بیشتری را خواهد پذیرفت، اما کندتر خواهد بود. اندازه بر حسب جفت‌های کلید\-مقدار (یعنی خطوط) اندازه‌گیری می‌شود. (اندازه باید برآورد اندازه نهایی فایل باشد، که معمولاً همان اندازه فایل قدیمی است.)
.Sp
اندازه مؤثر به‌کاررفته برای بهینه‌سازی عملکرد پایگاه داده بزرگتر خواهد بود. برای اطلاعات بیشتر، به
\&\fB\-i\fR
و بحث درباره
\&\fBdbzfresh\fR
و
\&\fBdbzsize\fR
در
\&\fBlibinn_dbz\fR(3)
مراجعه کنید.
.Sp
مقدار پیش‌فرض هنگام ایجاد پایگاه داده جدید
\&\fIhistory\fR
برابر با 6,666,666 است. (اگر از قالب کندتر هش برچسب‌دار استفاده شود، مقدار پیش‌فرض 500,000 است.)
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Katsuhiro Kondou <kondou@nec.co.jp> برای InterNetNews. تبدیل به POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBhistory\fR(5)،
\&\fBlibinn_dbz\fR(3).