.\" -*- 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 "GENCANCEL 1" .TH GENCANCEL 1 2023-04-16 "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)" gencancel \- تولید پیام‌های کنترلی لغو .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBgencancel\fR [\fB\-adkLm\fR] [\fB\-b\fR \fIbody\fR] [\fB\-c\fR \fIcharset\fR] [\fB\-f\fR \fIfrom\fR] [\fB\-n\fR \fInewsgroups\fR] [\fB\-s\fR \fIsubject\fR] \fImessage-id\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBgencancel\fR ابزاری کارآمد در اختیار مدیر سرور خبری (news administrator) قرار می‌دهد تا پیام‌های کنترلی لغو (cancel control messages) را تولید کرده و در خروجی استاندارد بنویسد. سپس مقالهٔ لغوِ تولیدشده می‌تواند توسط \fBinews\fR تزریق شود (مثال‌های زیر را ببینید). .PP دستور \&\fBgencancel\fR انتظار شناسهٔ Message-ID مقاله‌ای را دارد که قرار است لغو شود؛ این آرگومان \fImessage-id\fR باید به درستی برای شل نقل‌قول‌بندی (quote) شده و درون علامت‌های قلاب شکسته (< >) قرار گیرد. سپس \&\fBgencancel\fR تلاش می‌کند مقالهٔ اصلی را در news spool بخواند تا گروه‌های خبری اولیه‌ای را که مقاله به آن‌ها ارسال شده بود شناسایی کند و از این اطلاعات برای پیام کنترلی لغو استفادهٔ مجدد به عمل آورد. اگر مایلید آن را تغییر دهید یا اطلاعات یافت نشد، باید آن را با پرچم \fB\-n\fR مشخص کنید. .PP اگر INN با پشتیبانی از Cancel-Lock ساخته شده باشد، \&\fBgencancel\fR فیلد سرایند مناسب Cancel-Key مدیر را برای احراز هویت لغوها تولید خواهد کرد. چنانچه به هر دلیلی نیاز به لغو مقاله‌ای داشته باشید که از سرور خبری شما با فیلد سرایند Cancel-Lock ارسال شده است، برای احراز هویت درخواست پس‌گیری (withdrawal request) به درهم‌سازی‌های متناظر با Cancel-Key مدیر نیاز خواهد بود. این اطلاعات با پارامتر \fIcanlockadmin\fR که در \fIinn\-secrets.conf\fR تعیین شده محاسبه می‌شود. .PP در صورتی که تنها به درهم‌سازی‌های Cancel-Key مدیر نیاز دارید، می‌توانید از پرچم \fB\-k\fR استفاده کنید. در این صورت، تنها بدنهٔ فیلد سرایند Cancel-Key در خروجی استاندارد نوشته خواهد شد. سپس می‌توانید برای نمونه از آن در یک درخواست جایگزینی (supersede) یا از درون اسکریپتی دیگر مجدداً استفاده کنید. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-a\fR 4 .IX Item "-a" دستور \&\fBgencancel\fR به‌طور پیش‌فرض یک فیلد سرایند Approved تولید می‌کند و از همان مقدار بدنهٔ فیلد سرایند From استفاده می‌نماید. اگر \fB\-a\fR استفاده شود، هیچ فیلد سرایند Approved در خروجی درج نمی‌شود. .Sp این فیلد سرایند برای لغو مقالاتی مفید است که در ابتدا به گروه‌های خبری اداره‌شونده (moderated newsgroups) ارسال شده‌اند. اگر یک مقالهٔ کنترلی لغو، در فیلد سرایند Newsgroups خود یک گروه خبری اداره‌شونده را فهرست کرده باشد و فیلد سرایند Approved وجود نداشته باشد، لغو در ابتدا جهت تأیید نزد ناظر (moderator) ارسال خواهد شد. پیام‌های کنترلی لغو خارج از گروه‌های خبری اداره‌شونده الزامی به داشتن فیلد سرایند Approved ندارند، اما می‌توانند داشته باشند؛ بنابراین معمولاً نباید از \fB\-a\fR استفاده کنید مگر اینکه واقعاً بخواهید لغوهای شما توسط یک ناظر تأیید شوند، یا مطمئن باشید که فیلد سرایند Newsgroups هیچ گروه خبری اداره‌شونده‌ای را شامل نمی‌شود. .IP "\fB\-b\fR \fIbody\fR" 4 .IX Item "-b body" دستور \&\fBgencancel\fR به‌طور پیش‌فرض مقدار \f(CW\*(C`Admin cancel.\*(C'\fR را در بدنهٔ پیام‌های کنترلی لغو می‌نویسد. استفاده از این آرگومان امکان نوشتن مقداری متفاوت را فراهم می‌کند، که می‌تواند خالی یا چندخطی باشد. .IP "\fB\-c\fR \fIcharset\fR" 4 .IX Item "-c charset" به‌طور پیش‌فرض، مقدار \f(CW\*(C`ISO\-8859\-1\*(C'\fR به عنوان مجموعه نویسهٔ (charset) استفاده‌شده در فیلد سرایند Content-Type مشخص شده است. در صورتی که بدنهٔ پیش‌فرض را با \fB\-b\fR تغییر می‌دهید، ممکن است بخواهید \fIcharset\fR را نیز متناسب با آن تغییر دهید. .IP \fB\-d\fR 4 .IX Item "-d" دستور \&\fBgencancel\fR فیلد سرایند Date را به وقت محلی سرور خبری شما تولید می‌کند. استفاده از \fB\-d\fR باعث استفاده از تاریخ و زمان بر مبنای UTC خواهد شد. .IP "\fB\-f\fR \fIfrom\fR" 4 .IX Item "-f from" دستور \&\fBgencancel\fR به‌طور پیش‌فرض از مقدار \fIcomplaints\fR در \fIinn.conf\fR برای فیلد سرایند From استفاده می‌کند. استفاده از این آرگومان امکان تعیین مقدار دلخواه را می‌دهد. همین مقدار برای فیلد سرایند Approved نیز استفاده خواهد شد (در صورت تولید، هنگامی که \fB\-a\fR داده نشده باشد). .IP \fB\-k\fR 4 .IX Item "-k" به جای خروجی دادن کل یک پیام کنترلی لغو، \&\fBgencancel\fR صرفاً بدنهٔ فیلد سرایند Cancel-Key را همراه با درهم‌سازی‌های مدیر در خروجی می‌نویسد. .Sp این پرچم تنها در صورتی در دسترس است که INN با پشتیبانی از Cancel-Lock ساخته شده باشد. .IP \fB\-L\fR 4 .IX Item "-L" دستور \&\fBgencancel\fR به‌طور پیش‌فرض یک فیلد سرایند Cancel-Key را برای احراز هویت پیام کنترلی لغو خروجی می‌دهد. اگر \fB\-L\fR استفاده شود، هیچ فیلد سرایند Cancel-Key در خروجی تولید نمی‌شود. .Sp این پرچم تنها در صورتی در دسترس است که INN با پشتیبانی از Cancel-Lock ساخته شده باشد. .IP \fB\-m\fR 4 .IX Item "-m" دستور \&\fBgencancel\fR به‌طور پیش‌فرض یک Message-ID تصادفی تولید کرده و از آن به عنوان شناسهٔ یکتای پیام کنترلی لغو استفاده می‌کند. اگر \fB\-m\fR استفاده شود، هیچ فیلد سرایند Message-ID در خروجی درج نمی‌شود. .IP "\fB\-n\fR \fInewsgroups\fR" 4 .IX Item "-n newsgroups" دستور \&\fBgencancel\fR به‌طور پیش‌فرض همان فیلد سرایند Newsgroups را تولید می‌کند که در مقالهٔ اصلیِ مورد نظر برای لغو وجود داشته است. این کار به این منظور انجام می‌شود که حداکثر اطمینان حاصل شود پیام کنترلی لغو به همان سرورهای خبری که پیام اصلی به آن‌ها فرستاده شده بازپخش (relay) خواهد شد. .Sp در صورتی که سرور خبری شما مقالهٔ اصلی را به‌طور محلی ذخیره نکرده باشد (یا دیگر نداشته باشد)، باید با این پرچم یک گروه خبری مشخص یا فهرستی از گروه‌های خبری جداشده با کاما را تعیین کنید که به عنوان فیلد سرایند Newsgroups پیام لغو استفاده خواهد شد. .IP "\fB\-s\fR \fIsubject\fR" 4 .IX Item "-s subject" دستور \&\fBgencancel\fR به‌طور پیش‌فرض از \f(CW\*(C`cmsg cancel \*(C'\fR به عنوان موضوع پیام‌های کنترلی لغو استفاده می‌کند. استفاده از این آرگومان امکان تعیین مقداری متفاوت را برای فیلد سرایند Subject فراهم می‌آورد. اطمینان حاصل کنید که مقدار آن به‌درستی با MIME کدگذاری شده باشد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" تنها برای دریافت درهم‌سازی‌های Cancel-Key مدیرِ مرتبط با Message-ID داده‌شده: .PP .Vb 1 \& gencancel \-k \*(Aq\*(Aq .Ve .PP اگر از نویسه‌های غیر ASCII در سرایندها استفاده می‌کنید، مطمئن شوید که آن‌ها را به درستی به شیوهٔ MIME کدگذاری کرده‌اید. برای نمونه، از ماژول پرل \f(CW\*(C`Encode\*(C'\fR استفاده کنید: .PP .Vb 4 \& FROM=$(perl \-e \*(Aquse Encode; \& print encode("MIME\-Q", \& decode("UTF\-8", "Julien ÉLIE"));\*(Aq) \& gencancel \-f "$FROM " \*(Aq\*(Aq .Ve .PP سپس در خروجی یک فیلد سرایند را که به درستی با MIME کدگذاری شده است مشاهده خواهید کرد: .PP .Vb 1 \& From: =?UTF\-8?Q?Julien_=C3=89LIE?= .Ve .PP نمونه‌ای از فراخوانی با بدنهٔ سفارشی چندخطی: .PP .Vb 1 \& gencancel \-b "$(echo \-e "Multi\enLine\enBody.")" \*(Aq\*(Aq .Ve .PP (از \fB\-c\fR برای تغییر charset پیش‌فرض Content-Type بدنه استفاده کنید.) .PP سپس می‌توانید خروجی را به دستور \f(CW\*(C`inews \-h \-P \-D\*(C'\fR لوله‌کشی (pipe) کنید (به این معنی که \fBinews\fR انتظار یک مقاله همراه با سرایندها را دارد، فیلد سرایند Sender را اضافه نمی‌کند، و به جای تزریق واقعی آن، نتیجه را در خروجی استاندارد می‌نویسد): .PP .Vb 1 \& gencancel \*(Aq\*(Aq | inews \-h \-P \-D .Ve .PP اگر همه چیز درست به نظر می‌رسد، آن را به سیستم خبری تزریق کنید (بدون دادن \f(CW\*(C`\-D\*(C'\fR به \fBinews\fR): .PP .Vb 1 \& gencancel \*(Aq\*(Aq | inews \-h \-P .Ve .PP توجه داشته باشید که \fBinews\fR پیام را به سروری که در پارامتر \fIserver\fR در \fIinn.conf\fR مشخص شده است ارسال می‌کند. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Julien Élie برای InterNetNews. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inews(1), inn\-secrets.conf(5).