.\" -*- 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 "SHRINKFILE 1"
.TH SHRINKFILE 1 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)"
shrinkfile \- کوتاه کردن فایل‌ها بر اساس مرز خطوط
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBshrinkfile\fR [\fB\-nv\fR] [\fB\-m\fR \fImaxsize\fR] [\fB\-s\fR \fIsize\fR] \fIfile\fR [\fIfile\fR
\&...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامه \fBshrinkfile\fR اندازه فایل‌ها را در صورتی که بزرگ‌تر از \fImaxsize\fR باشند، حداکثر تا \fIsize\fR مشخص‌شده کاهش می‌دهد، در حالی که داده‌های انتهای فایل حفظ می‌شوند.
کوتاه‌سازی بر روی مرز خطوط انجام می‌شود؛ به این معنی که یک خط دنباله‌ای از بایت‌ها است که به نویسه خط جدید (\f(CW\*(C`\en\*(C'\fR) ختم می‌شود. هیچ محدودیتی برای طول خط وجود ندارد و فایل‌ها می‌توانند حاوی هرگونه داده دودویی باشند.
.PP
اگر اولین خط طولانی‌تر از مقدار مطلق \fIsize\fR باشد، اندازه فایل به صفر کاهش می‌یابد.
.PP
حداکثر اندازه فایلی که \fBshrinkfile\fR می‌تواند پردازش کند ۲٬۱۴۷٬۴۸۳٬۶۴۷ بایت است.
.PP
فایل‌های موقت در دایرکتوری \fIpathtmp\fR که در \fIinn.conf\fR تنظیم شده است ایجاد می‌شوند.
متغیر محیطی \f(CW\*(C`TMPDIR\*(C'\fR می‌تواند برای تعیین یک دایرکتوری متفاوت استفاده شود.
.PP
به هر فایل غیرخالی که به نویسه خط جدید ختم نمی‌شود، یک نویسه خط جدید افزوده خواهد شد؛ البته مشروط بر اینکه این افزایش باعث نشود اندازه نهایی فایل از \fIsize\fR فراتر رود.
.PP
این برنامه در حال حاضر فقط توسط nntpsend(8) استفاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-m\fR \fImaxsize\fR" 4
.IX Item "-m maxsize"
این گزینه حداکثر اندازه مجاز پیش از اعمال کوتاه‌سازی را تعیین می‌کند.
.Sp
به‌طور پیش‌فرض، مقدار \fImaxsize\fR با \fIsize\fR (که با گزینه \fB\-s\fR تعیین می‌شود) یکسان است.
اگر \fImaxsize\fR کمتر از \fIsize\fR باشد، مقدار \fImaxsize\fR به \fIsize\fR بازنشانی می‌شود.
.Sp
این پارامتر می‌تواند به \f(CW\*(C`k\*(C'\fR، \f(CW\*(C`m\*(C'\fR یا \f(CW\*(C`g\*(C'\fR ختم شود که نشان‌دهنده اندازه بر حسب کیلوبایت (۱٬۰۲۴ بایت)، مگابایت (۱٬۰۴۸٬۵۷۶ بایت) یا گیگابایت (۱٬۰۷۳٬۷۴۱٬۸۲۴ بایت) است.
حروف بزرگ نیز مجاز هستند.
.IP \fB\-n\fR 4
.IX Item "-n"
این گزینه برای بررسی اینکه آیا فایلی بیش از حد بزرگ است یا خیر استفاده می‌شود. در این حالت هیچ فایلی تغییر داده نخواهد شد.
.Sp
اگر هر فایلی بزرگ‌تر از \fImaxsize\fR (تعیین‌شده با گزینه \fB\-m\fR) باشد با کد وضعیت \f(CW\*(C`0\*(C'\fR خارج می‌شود، و در غیر این صورت با کد وضعیت \f(CW\*(C`1\*(C'\fR خاتمه می‌یابد.
.IP "\fB\-s\fR \fIsize\fR" 4
.IX Item "-s size"
به‌طور پیش‌فرض، مقدار \fIsize\fR صفر در نظر گرفته می‌شود و اندازه فایل‌ها به صفر بایت کاهش می‌یابد. این گزینه برای تغییر اندازه کوتاه‌سازی استفاده می‌شود. از آنجا که برنامه فقط بر روی مرز خطوط کوتاه‌سازی می‌کند، اندازه نهایی ممکن است کوچک‌تر از اندازه تعیین‌شده باشد.
.Sp
این پارامتر می‌تواند به \f(CW\*(C`k\*(C'\fR، \f(CW\*(C`m\*(C'\fR یا \f(CW\*(C`g\*(C'\fR ختم شود که بیانگر اندازه بر حسب کیلوبایت (۱٬۰۲۴ بایت)، مگابایت (۱٬۰۴۸٬۵۷۶ بایت) یا گیگابایت (۱٬۰۷۳٬۷۴۱٬۸۲۴ بایت) است.
حروف بزرگ نیز مجاز هستند.
.IP \fB\-v\fR 4
.IX Item "-v"
در صورتی که فایلی کوتاه شده باشد، یک خط وضعیت در خروجی استاندارد چاپ می‌کند.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
نمونه استفاده:
.PP
.Vb 4
\&    shrinkfile \-s 4m curds
\&    shrinkfile \-s 1g \-v whey
\&    shrinkfile \-s 500k \-m 4m \-v curds whey
\&    if shrinkfile \-n \-s 100m whey; then echo "whey is way too big"; fi
.Ve
.PP
دستور اول، فایل \fIcurds\fR را در صورتی که بزرگ‌تر از ۴ مگابایت باشد به ۴ مگابایت کاهش می‌دهد.
دستور دوم، فایل \fIwhey\fR را به ۱ گیگابایت کاهش می‌دهد و در صورتی که فایل بزرگ‌تر از این مقدار باشد، یک خط گزارش خروجی می‌دهد.
دستور سوم، هر دو فایل \fIcurds\fR و \fIwhey\fR را در صورتی که بزرگ‌تر از ۴ مگابایت باشند به ۵۰۰ کیلوبایت کاهش می‌دهد و برای فایل‌های کوتاه‌شده گزارش ثبت می‌کند.
دستور چهارم، در صورتی که \f(CW\*(C`whey\*(C'\fR بزرگ‌تر از ۱۰۰ مگابایت باشد فقط یک پیام چاپ می‌کند، بدون اینکه آن را کوتاه کند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Landon Curt Noll <chongo@toad.com> و Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. بازنویسی در قالب POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
nntpsend(8).