.\" -*- 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 "GREPHISTORY 1" .TH GREPHISTORY 1 2025-05-09 "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)" grephistory \- پرس‌وجوی پایگاه‌دادهٔ تاریخچهٔ INN .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBgrephistory\fR [\fB\-eilnqsv\fR] [\fB\-f\fR \fIdb\fR] [\fImessage-id\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBgrephistory\fR پایگاه‌دادهٔ تاریخچهٔ INN را برای دریافت اطلاعات دربارهٔ message-ID مشخص‌شده پرس‌وجو می‌کند. اگر هیچ پرچمی داده نشود، برنامه نشانهٔ storage API مقالهٔ مربوطه را چاپ می‌کند، یا اگر مقاله در پایگاه‌دادهٔ تاریخچه فهرست شده ولی روی سرور ذخیره نشده باشد، \f(CW\*(C`/dev/null\*(C'\fR را چاپ خواهد کرد. در صورتی که message-ID در پایگاه‌داده یافت نشود، \fBgrephistory\fR عبارت \f(CW\*(C`grephistory: not found\*(C'\fR را چاپ کرده و با وضعیت غیرصفر خارج می‌شود. .PP حتماً نویسه‌های خاص موجود در message ID را در برابر پوسته گریز دهید (escape کنید). استفاده از نقل‌قول‌های تکی (single quotes) برای این منظور پیشنهاد می‌شود، چرا که بسیاری از message-IDها شامل علامت دلار هستند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-e\fR 4 .IX Item "-e" تنها در صورتی نشانهٔ ذخیره‌سازی (storage token) را چاپ می‌کند که مقاله روی سیستم ذخیره شده باشد. (به بیان دیگر، از خروجی \f(CW\*(C`/dev/null\*(C'\fR یا \f(CW\*(C`not found\*(C'\fR برای مقالات مفقود یا به‌خاطرسپرده‌شده صرف‌نظر می‌کند.) .IP "\fB\-f\fR \fIdb\fR" 4 .IX Item "-f db" به جای پایگاه‌دادهٔ پیش‌فرض، پایگاه‌دادهٔ تاریخچهٔ \fIdb\fR را پرس‌وجو می‌کند. .IP \fB\-i\fR 4 .IX Item "-i" به جای انتظار برای دریافت message-ID در خط فرمان، \fBgrephistory\fR فهرستی از شناسهٔ پیام‌ها را از ورودی استاندارد می‌خواند، هر کدام در یک سطر. فاصله‌های سفید ابتدا و انتهای سطر و همچنین سطرهای نامعتبر نادیده گرفته می‌شوند. این گزینه message-IDهایی را که در پایگاه‌دادهٔ تاریخچه یافت نشوند در خروجی استاندارد چاپ می‌کند. این پرچم هنگام پردازش پیام‌های کنترلی \f(CW\*(C`ihave\*(C'\fR به کار می‌رود. .IP \fB\-l\fR 4 .IX Item "-l" به جای نمایشِ صرف نشانهٔ storage API، کل خط مربوطه از پایگاه‌دادهٔ تاریخچه را نمایش می‌دهد. اگر message-ID در پایگاه‌دادهٔ تاریخچه وجود داشته باشد اما فاقد نشانهٔ storage API باشد، \fBgrephistory\fR چیزی چاپ نمی‌کند. .IP \fB\-n\fR 4 .IX Item "-n" اگر message-ID در پایگاه‌دادهٔ تاریخچه موجود باشد اما فاقد نشانهٔ storage API باشد، عبارت \f(CW\*(C`/dev/null\*(C'\fR را چاپ کرده و با موفقیت خارج می‌شود. این حالت ممکن است زمانی رخ دهد که مقاله‌ای لغو یا منقضی شده باشد، اما اطلاعات تاریخچهٔ آن همچنان حفظ شده باشد. این رفتار پیش‌فرض است. .IP \fB\-q\fR 4 .IX Item "-q" هیچ پیامی چاپ نمی‌کند، اما همچنان با وضعیت مناسب خارج می‌شود. .IP \fB\-s\fR 4 .IX Item "-s" به جای انتظار دریافت message-ID در خط فرمان، \fBgrephistory\fR فهرستی از message-IDها را از ورودی استاندارد به‌صورت سطربه‌سطر می‌خواند. فاصله‌های خالی ابتدا و انتهای سطر و همچنین هرگونه سطر نامعتبر نادیده گرفته می‌شوند. این گزینه نشانه‌های storage API را برای تمام مقالاتی که هنوز در دسترس هستند در خروجی استاندارد چاپ می‌کند، در هر خط یکی. این پرچم هنگام پردازش پیام‌های کنترلی \f(CW\*(C`sendme\*(C'\fR استفاده می‌شود. .IP \fB\-v\fR 4 .IX Item "-v" هشِ message-ID را به همراه هر اطلاعات درخواستی دیگر برای اهداف عیب‌یابی چاپ می‌کند. استفاده از این پرچم در کنار \fB\-i\fR یا \&\fB\-s\fR کاربردی ندارد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" در حالتی که مقالهٔ درخواستی در پایگاه‌دادهٔ تاریخچه فهرست نشده باشد: .PP .Vb 4 \& % grephistory \*(Aq\*(Aq \& grephistory: not found \& % grephistory \-v \*(Aq\*(Aq \& grephistory: not found (hash is 501C66C22932BA91131186D7218201EB) .Ve .PP در حالتی که مقالهٔ درخواستی در پایگاه‌دادهٔ تاریخچه فهرست شده باشد اما روی سرور ذخیره نشده باشد: .PP .Vb 2 \& % grephistory \*(Aq\*(Aq \& /dev/null .Ve .PP در حالتی که مقالهٔ درخواستی روی سرور ذخیره شده باشد: .PP .Vb 5 \& % grephistory \*(Aq<87fxeaay1z.fsf@windlord.stanford.edu>\*(Aq \& @02014A2DD6231FCC00000000000000000000@ \& % grephistory \-l \*(Aq<87fxeaay1z.fsf@windlord.stanford.edu>\*(Aq \& [B6DDF69376E3CC199246CEC949B3ACAC] 1244517923~\-~1244517912 \& @02014A2DD6231FCC00000000000000000000@ .Ve .PP به کمک \fBsm\fR می‌توانیم مقاله را بازیابی کرده و تاریخ ارسال (posting date) آن را مشاهده کنیم: .PP .Vb 3 \& % grephistory \*(Aq<87fxeaay1z.fsf@windlord.stanford.edu>\*(Aq \e \& | sm | grep Date \& Date: Mon, 08 Jun 2009 20:25:12 \-0700 \& \& % convdate \-dc 1244517912 \& Tue, 9 Jun 2009 03:25:12 \-0000 (UTC) .Ve .PP این تاریخ با عددی که به عنوان تاریخ ارسال در تاریخچه ثبت شده است مطابقت دارد. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Rich $alz برای InterNetNews. بازنویسی در قالب POD توسط Russ Allbery . .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" history(5), inn.conf(5), sm(8).