.\" -*- 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 "INNUPGRADE 8"
.TH INNUPGRADE 8 2022-07-10 "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)"
innupgrade \- ارتقای پرونده‌های پیکربندی INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBinnupgrade\fR \fIdirectory\fR
.PP
\&\fBinnupgrade\fR [\fB\-t\fR \fItype\fR] \fB\-f\fR \fIfile\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBinnupgrade\fR
برای اجرا در هنگام یک ارتقای عمدهٔ INN به‌منظور اصلاح پرونده‌های پیکربندی با تغییرات لازم در نظر گرفته شده است.
اگر یک دایرکتوری به آن داده شود، آن دایرکتوری را برای هر پرونده‌ای که به‌روزرسانی‌هایی برای آن تعریف شده باشد پویش می‌کند، تلاش می‌کند آن به‌روزرسانی‌ها را انجام دهد، و در صورتی که اعمال به‌روزرسانی‌ها منجر به هرگونه تغییری شود، پرونده‌ها را با نسخه‌های به‌روزشده جایگزین می‌کند.
نسخه‌های قدیمی پرونده‌ها با پسوند
\f(CW\*(C`.OLD\*(C'\fR
ذخیره خواهند شد.
.PP
اگر گزینهٔ
\fB\-f\fR
استفاده شود، تنها همان پرونده به‌روزرسانی خواهد شد. اگر نام پرونده با نام استاندارد یک پروندهٔ پیکربندی INN مطابقت نداشته باشد، می‌توان از گزینهٔ اختیاری
\fB\-t\fR
برای تعیین نوع استفاده کرد. برای مثالی از این مورد، به بخش «مثال‌ها (EXAMPLES)» مراجعه کنید.
.PP
در حال حاضر،
\&\fBinnupgrade\fR
می‌داند چگونه به‌روزرسانی‌های زیر را اعمال کند:
.IP \fIincoming.conf\fR 2
.IX Item "incoming.conf"
.RS 2
.PD 0
.IP \(bu 2
.PD
تغییر نام \fInolist\fR و \fInoresendid\fR به ترتیب به \fIlist\fR و \fIresendid\fR.
معکوس کردن مقادیر بولی مرتبط (از INN\ 2.7).
.IP \(bu 2
کامنت کردن پارامترهای حذف‌شدهٔ \fIcomment\fR و \fIemail\fR (از INN\ 2.7).
.RE
.RS 2
.RE
.IP \fIinn.conf\fR 2
.IX Item "inn.conf"
.RS 2
.PD 0
.IP \(bu 2
.PD
قرار دادن مقادیر دارای فاصله در علامت نقل‌قول و کامنت کردن کلیدهای بدون مقدار، که برای تغییر تجزیه‌کننده‌های پیکربندی معرفی‌شده در INN\ 2.4 لازم است. قالب جدید با تجزیه‌کنندهٔ پیشین سازگار به عقب نیست، زیرا تجزیه‌کنندهٔ پیشین علامت‌های نقل‌قول دوتایی را در مقدار پارامتر لحاظ می‌کند.
.IP \(bu 2
افزودن پارامتر \fIhismethod\fR در صورت پیدا نشدن (معرفی‌شده در INN\ 2.4، با مقدار پیش‌فرض \f(CW\*(C`hisv6\*(C'\fR).
.IP \(bu 2
تغییر نام \fInntpactsync\fR به \fIincominglogfrequency\fR (از INN\ 2.5).
تغییر نام \fIaddnntppostingdate\fR و \fIaddnntppostinghost\fR به ترتیب به
\&\fIaddinjectiondate\fR و \fIaddinjectionpostinghost\fR (از INN\ 2.6).
.IP \(bu 2
حذف پارامترهای \fIrefusecybercancels\fR و \fIverifycancels\fR (از INN\ 2.7).
.IP \(bu 2
اگر پروندهٔ \fIoverview.fmt\fR وجود داشته باشد، محتوای آن در پارامترهای
\&\fIextraoverviewadvertised\fR و \fIextraoverviewhidden\fR معرفی‌شده در INN\ 2.5 ادغام می‌شود. سپس پرونده به \fIoverview.fmt.OLD\fR تغییر نام می‌یابد.
.IP \(bu 2
اگر پروندهٔ \fIsasl.conf\fR وجود داشته باشد، محتوای آن در پارامترهای \fItlscapath\fR،
\&\fItlscafile\fR، \fItlscertfile\fR و \fItlskeyfile\fR معرفی‌شده در INN\ 2.5 ادغام می‌شود. سپس پرونده به \fIsasl.conf.OLD\fR تغییر نام می‌یابد.
.RE
.RS 2
.RE
.IP \fIinn\-secrets.conf\fR 2
.IX Item "inn-secrets.conf"
.RS 2
.PD 0
.IP \(bu 2
.PD
ایجاد پروندهٔ \fIinn\-secrets.conf\fR غیرقابل خواندن برای همگان (non-world-readable) در \fIpathetc\fR در صورتی که از قبل وجود نداشته باشد (جدید در INN\ 2.7).
.RE
.RS 2
.RE
.IP \fInewsfeeds\fR 2
.IX Item "newsfeeds"
.RS 2
.PD 0
.IP \(bu 2
.PD
جایگزینی استفاده از \fBstartinnfeed\fR با فراخوانی مستقیم مناسبِ
\&\fBinnfeed\fR یا \fBimapfeed\fR (\fBstartinnfeed\fR در INN\ 2.5 حذف شد).
.IP \(bu 2
جایگزینی استفاده از \fBfilechan\fR با \fBbuffchan\fR در حالت بدون بافر (unbuffered)
(\fBfilechan\fR در INN\ 2.7 حذف شد).
.RE
.RS 2
.RE
.IP \fIreaders.conf\fR 2
.IX Item "readers.conf"
.RS 2
.PD 0
.IP \(bu 2
.PD
تغییر نام \fIrequire_ssl\fR به \fIrequire_encryption\fR (از INN\ 2.7).
.RE
.RS 2
.RE
.PP
چند برنامه یا پروندهٔ پیکربندی منسوخ توسط \fBinnupgrade\fR با پسوند
\f(CW\*(C`.OLD\*(C'\fR
تغییر نام می‌یابند. صفحه‌های راهنمای منسوخ مستقیماً حذف می‌شوند.
.PP
به‌طور معمول،
\&\fBinnupgrade\fR
باید حداقل بر روی دایرکتوری \fIpathetc\fR پس از هر ارتقای INN غیر از انتشار وصله (هر ارتقایی که اعداد نگارش اول یا دوم را تغییر می‌دهد) اجرا شود. این کار ممکن است به‌طور خودکار در طول فرایند ارتقا رخ دهد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfile\fR" 4
.IX Item "-f file"
تنها روی \fIfile\fR عمل کند به‌جای کار روی کل یک دایرکتوری.
.IP "\fB\-t\fR \fItype\fR" 4
.IX Item "-t type"
برای پرونده‌ای که با \fB\-f\fR مشخص شده است، آن را طوری تجزیه و ارتقا دهد که گویی نام آن \fItype\fR بوده است. برای ارتقای پرونده‌هایی با ساختار نحوی مشابه پرونده‌های پیکربندی معمولی INN اما با نام‌های دیگر استفاده می‌شود. تنها در ترکیب با \fB\-f\fR کاربرد دارد.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
ارتقای تمام پرونده‌های پیکربندی یافت‌شده در \fIpathetc\fR و افزودن پسوند \f(CW\*(C`.OLD\*(C'\fR به پرونده‌های منسوخ در \fIpathetc\fR:
.PP
.Vb 1
\&    innupgrade <pathetc in inn.conf>
.Ve
.PP
ارتقای تنها \fI/news/etc/inn.conf\fR:
.PP
.Vb 1
\&    innupgrade \-f /news/etc/inn.conf
.Ve
.PP
ارتقای پرونده‌ای به نام \fIinn\-special.conf\fR که باید ساختار نحوی مشابهی با \fIinn.conf\fR داشته باشد:
.PP
.Vb 1
\&    innupgrade \-t inn.conf \-f inn\-special.conf
.Ve
.PP
هر قانون ارتقایی که برای \fIinn.conf\fR اعمال شود، بر روی پروندهٔ جایگزین نیز اعمال خواهد شد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Russ Allbery <eagle@eyrie.org> برای InterNetNews.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
incoming.conf(5), inn.conf(5), inn\-secrets.conf(5), newsfeeds(5),
readers.conf(5).