.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH shar 1 "30 May 2015" "GNU sharutils (4.15.2)" "User Commands"
.\"
.\" DO NOT EDIT THIS FILE (in-mem file)
.\"
.\" It has been AutoGen-ed
.\" From the definitions shar-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
\f\*[B-Font]shar\fP
\- ایجاد آرشیو شل (shell archive)
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]shar\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
[<file>...]
.sp \n(Ppu
.ne 2

اگر هیچ \fIfile\fPی مشخص نشود، فهرست فایل‌های ورودی از ورودی استاندارد خوانده می‌شود. ورودی استاندارد نباید یک پایانه باشد.
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBshar\fP «آرشیوهای شل» (یا فایل‌های shar) ایجاد می‌کند که در قالب متنی هستند و می‌توان آن‌ها را از طریق رایانامه (ایمیل) ارسال کرد. این فایل‌ها می‌توانند بعداً با اجرا شدن از طریق \fI/bin/sh\fP باز شوند. آرشیو حاصل به خروجی استاندارد فرستاده می‌شود، مگر اینکه گزینهٔ \fB-o\fP مشخص شده باشد. طیف گسترده‌ای از ویژگی‌ها انعطاف‌پذیری بالایی را در تولید فابل‌های shar و در تعیین میزان «هوشمندی» \fBshar\fP فراهم می‌کنند. آرشیوها می‌توانند کاملاً ساده باشند (\fB--vanilla-operation\fP) یا اساساً یک آرشیو \fBtar\fP قابل ارسال با ایمیل باشند.
.sp
گزینه‌ها ممکن است به هر ترتیبی تا قبل از شناخته‌شدن یک آرگومان \fBfile\fP مشخص شوند. اگر گزینهٔ \fB--intermix-type\fP مشخص شده باشد، گزینه‌های فشرده‌سازی و کدگذاری بیشتری در بین آرگومان‌های \fIfile\fP شناسایی خواهند شد.
.sp
اگرچه این برنامه از فایل‌های با کدگذاری \fBuuencode\fP پشتیبانی می‌کند، اما آن‌ها منسوخ شده‌اند. اگر فایل‌ها را با رایانامه ارسال می‌کنید، لطفاً فایل‌های با کدگذاری mime را در نظر بگیرید. اگر از \fBuuencode\fP استفاده می‌کنید، base64 روش کدگذاری ترجیحی است.
.SH "گزینه‌ها (OPTIONS)"
.SS "تعیین فشرده‌سازی (Specifying compression)"
.TP
.NOP \f\*[B-Font]\-p\f[], \f\*[B-Font]\-\-intermix\-type\f[]
تعیین فشرده‌سازی برای فایل‌های ورودی.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود:
vanilla-operation.
.sp
اجازه دادن به گزینه‌های پارامتر موضعی (positional). گزینه‌های روش فشرده‌سازی و روش کدگذاری می‌توانند با نام‌های فایل‌ها ترکیب شوند.
فایل‌هایی که نام آن‌ها پس از این گزینه‌ها مشخص شود، به روش تعیین‌شده پردازش خواهند شد.
.TP
.NOP \f\*[B-Font]\-C\f[] \f\*[I-Font]program\f[], \f\*[B-Font]\-\-compactor\f[]=\f\*[I-Font]program\f[]
تعیین برنامهٔ فشرده‌ساز (compactor).
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود:
vanilla-operation.
.sp
دستورهای فشرده‌ساز \fBgzip\fP، \fBbzip2\fP و \fBcompress\fP می‌توانند با نام برنامه به عنوان نام گزینه مشخص شوند، مانند \fB--gzip\fP. با این حال، آن گزینه‌ها در حال منسوخ شدن هستند. اکنون فشرده‌ساز \fBxz\fP نیز وجود دارد. \fBxz\fP را با \fB-C xz\fP یا \fB--compactor=xz\fP مشخص کنید.
.sp
        مشخص کردن فشرده‌ساز «\fBnone\fP» فشرده‌سازی فایل را غیرفعال می‌کند. فایل‌های فشرده‌شده هرگز به صورت متن ساده پردازش نمی‌شوند. آن‌ها همیشه با uuencode کدگذاری می‌شوند و گیرنده باید برای باز کردن آن‌ها \fBuudecode\fP را داشته باشد.
.sp
مشخص کردن فشرده‌ساز \fBcompress\fP منسوخ شده است.
.TP
.NOP \f\*[B-Font]\-g\f[] \f\*[I-Font]level\f[], \f\*[B-Font]\-\-level\-of\-compression\f[]=\f\*[I-Font]level\f[]
ارسال \fILEVEL\fP برای فشرده‌سازی.
این گزینه یک عدد صحیح را به عنوان آرگومان خود می‌پذیرد.
مقدار
\f\*[I-Font]level\f[]
محدود است به:
.in +4
.nf
.na
در محدوده  1 تا 9
.fi
.in -4
مقدار پیش‌فرض
\f\*[I-Font]level\f[]
برای این گزینه به این صورت است:
.ti +4
 9
.sp
برخی از برنامه‌های فشرده‌سازی امکان تعیین سطح فشرده‌سازی را می‌دهند. مقدار پیش‌فرض \fB9\fP است، اما این گزینه به شما اجازه می‌دهد مقدار دیگری را مشخص کنید. این مقدار توسط \fBgzip\fP، \fBbzip2\fP و \fBxz\fP استفاده می‌شود، اما نه توسط \fBcompress\fP.
.TP
.NOP \f\*[B-Font]\-j\f[], \f\*[B-Font]\-\-bzip2\f[]
فشرده‌سازی با \fBbzip2\fP و کدگذاری با \fBuuencode\fP برای فایل‌ها.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
فشرده‌سازی تمام فایل‌ها با \fBbzip2\fP و کدگذاری با \fBuuencode\fP پیش از بسته‌بندی. گیرنده باید برای باز کردن \fBuudecode\fP و \fBbzip2\fP را داشته باشد.
.sp
.B
نکته: این گزینه منسوخ شده است
.TP
.NOP \f\*[B-Font]\-z\f[], \f\*[B-Font]\-\-gzip\f[]
فشرده‌سازی با \fBgzip\fP و کدگذاری با \fBuuencode\fP برای فایل‌ها.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
فشرده‌سازی تمام فایل‌ها با \fBgzip\fP و کدگذاری با \fBuuencode\fP پیش از بسته‌بندی. گیرنده برای باز کردن باید \fBuudecode\fP و \fBgzip\fP را داشته باشد.
.sp
.B
نکته: این گزینه منسوخ شده است
.TP
.NOP \f\*[B-Font]\-Z\f[], \f\*[B-Font]\-\-compress\f[]
فشرده‌سازی با \fBcompress\fP و کدگذاری با \fBuuencode\fP برای فایل‌ها.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
فشرده‌سازی تمام فایل‌ها با \fBcompress\fP و کدگذاری با \fBuuencode\fP پیش از بسته‌بندی. گیرنده برای باز کردن باید \fBuudecode\fP و \fBcompress\fP را داشته باشد.
.sp
.B
نکته: این گزینه منسوخ شده است
.TP
.NOP \f\*[B-Font]\-\-level-for-gzip\f[]
این یک نام مستعار برای گزینهٔ \fI--level-of-compression\fR است.
.sp
.B
نکته: این گزینه منسوخ شده است
.TP
.NOP \f\*[B-Font]\-b\f[] \f\*[I-Font]bits\f[], \f\*[B-Font]\-\-bits\-per\-code\f[]=\f\*[I-Font]bits\f[]
ارسال \fIbits\fP (پیش‌فرض ۱۲) به compress.
مقدار پیش‌فرض
\f\*[I-Font]bits\f[]
برای این گزینه به این صورت است:
.ti +4
 12
.sp
این ضریب فشرده‌سازی مورد استفاده توسط برنامهٔ \fBcompress\fP است.
.sp
.B
نکته: این گزینه منسوخ شده است.SS "تعیین روش کدگذاری فایل"
فایل‌ها ممکن است در shar به صورت متن ساده یا کدگذاری‌شده با uuencode ذخیره شوند.
به طور پیش‌فرض، برنامه با بررسی فایل روش مناسب را انتخاب می‌کند.
شما می‌توانید انتخاب را برای تمام فایل‌ها اجباری کنید. در حالت ترکیب
گزینه/فایل، این تنظیم می‌تواند در طول پردازش تغییر کند.
.TP
.NOP \f\*[B-Font]\-M\f[], \f\*[B-Font]\-\-mixed\-uuencode\f[]
تصمیم‌گیری درباره کدگذاری با uuencode برای هر فایل به صورت جداگانه.
این گزینه عضوی از رده گزینه‌های mixed-uuencode است.
.sp
به طور خودکار متنی یا باینری بودن فایل‌ها را تشخیص داده و آنها را به درستی
بایگانی می‌کند. فایل‌هایی که باینری تشخیص داده شوند پیش از بسته‌بندی با uuencode کدگذاری می‌شوند.
این رفتار پیش‌فرض برای \fBshar\fP است.
.sp
برای اینکه فایلی به جای باینری، یک فایل متنی در نظر گرفته شود،
باید تمام شرایط زیر برقرار باشد:
.sp 1
فایل فاقد هرگونه نویسه کنترلی ASCII به جز \fIBS\fP
(پس‌بر)، \fIHT\fP (تب افقی)، \fILF\fP (خط جدید) یا
\fIFF\fP (برگه‌بر) باشد.
.sp 1
فایل فاقد هرگونه نویسه‌ای باشد که بیت هشتم آن یک (set) شده باشد.
.sp 1
فایل فاقد هر خطی باشد که با پنج حرف
«\fBfrom \fP»، چه با حروف بزرگ یا کوچک، آغاز شود. (برنامه‌های مدیریت ایمیل
اغلب بدون دلیل یک نویسه \fB>\fP پیش از آن درج می‌کنند.)
.sp 1
فایل یا خالی باشد یا با یک بایت \fILF\fP (خط جدید) پایان یابد.
.sp 1
هیچ خطی در فایل شامل بیش از ۲۰۰ نویسه نباشد. به منظور شمارش،
خطوط با یک \fILF\fP (خط جدید) جدا می‌شوند.
.br
.TP
.NOP \f\*[B-Font]\-B\f[], \f\*[B-Font]\-\-uuencode\f[]
رفتار با تمام فایل‌ها به عنوان باینری.
این گزینه عضوی از رده گزینه‌های mixed-uuencode است.
.sp
استفاده از \fBuuencode\fP پیش از بسته‌بندی تمام فایل‌ها. این کار
حجم بایگانی را افزایش می‌دهد. گیرنده باید برای باز کردن بایگانی
\fBuudecode\fP را داشته باشد. فایل‌های فشرده‌شده همیشه
کدگذاری می‌شوند.
.TP
.NOP \f\*[B-Font]\-T\f[], \f\*[B-Font]\-\-text\-files\f[]
رفتار با تمام فایل‌ها به عنوان متنی.
این گزینه عضوی از رده گزینه‌های mixed-uuencode است.
.sp
اگر فایل‌هایی با بایت‌های غیر ASCII یا متنی دارید که برخی برنامه‌های پردازش ایمیل
با آن سازگار نیستند، ممکن است دچار مشکل شوید. با این حال، اگر از
FTP یا SSH/SCP استفاده می‌کنید، فایل‌های متنی ناسازگار معمولاً مشکلی نخواهند داشت.
.SS "تعیین انتخاب فایل و حالت‌های خروجی"
.TP
.NOP \f\*[B-Font]\-o\f[] \f\*[I-Font]prefix\f[], \f\*[B-Font]\-\-output\-prefix\f[]=\f\*[I-Font]prefix\f[]
چاپ خروجی در فایل PREFIX.nn.
.sp
ذخیره بایگانی در فایل‌های \fIprefix.01\fP تا \fIprefix.nn\fP
به جای ارسال تمام خروجی به خروجی استاندارد. در صورت مشخص شدن
گزینه‌های \fB--whole-size-limit\fP یا \fB--split-size-limit\fP،
تعیین این گزینه الزامی است.
.sp
هنگامی که \fBprefix\fP شامل یک نویسه \fB%\fP باشد، \fBprefix\fP به عنوان
یک قالب \fBsprintf\fP تفسیر می‌شود که باید بتواند یک عدد ده‌دهی تکی را نمایش دهد.
هنگامی که \fBprefix\fP فاقد نویسه \fB%\fP باشد، رشته \fB.%02d\fP
به طور داخلی به انتهای آن افزوده می‌شود.
.TP
.NOP \f\*[B-Font]\-l\f[] \f\*[I-Font]size\f[], \f\*[B-Font]\-\-whole\-size\-limit\f[]=\f\*[I-Font]size\f[]
تقسیم بایگانی، و نه فایل‌ها، به اندازه \fIsize\fP.
این گزینه عضوی از رده گزینه‌های whole-size-limit است.
این گزینه باید در ترکیب با گزینه زیر ظاهر شود:
output-prefix.
این گزینه یک عدد صحیح را به عنوان آرگومان خود می‌پذیرد.
مقدار
\f\*[I-Font]size\f[]
محدود به موارد زیر است:
.in +4
.nf
.na
در محدوده  8 تا 1023، یا
در محدوده  8192 تا 4194304
.fi
.in -4
.sp
اندازه فایل خروجی را به \fIsize\fP بایت محدود می‌کند، اما فایل‌های ورودی را
تقسیم نمی‌کند. اگر \fIsize\fP کمتر از ۱۰۲۴ باشد، در ۱۰۲۴ ضرب خواهد شد.
این مقدار می‌تواند با پسوند k، K، m یا M نیز مشخص شود.
سپس عدد به ترتیب در ۱۰۰۰، ۱۰۲۴، ۱۰۰۰۰۰۰ یا ۱۰۴۸۵۷۶ ضرب می‌شود.
مقدار 4M (۴۱۹۴۳۰۴) حداکثر مجاز است.
.sp
برخلاف گزینه \fBsplit-size-limit\fP، این گزینه به گیرنده فایل‌های shar
اجازه می‌دهد تا آن‌ها را به هر ترتیبی باز کند.
.TP
.NOP \f\*[B-Font]\-L\f[] \f\*[I-Font]size\f[], \f\*[B-Font]\-\-split\-size\-limit\f[]=\f\*[I-Font]size\f[]
تقسیم بایگانی یا فایل‌ها به اندازه \fIsize\fP.
این گزینه عضوی از رده گزینه‌های whole-size-limit است.
این گزینه باید در ترکیب با گزینه زیر ظاهر شود:
output-prefix.
این گزینه یک عدد صحیح را به عنوان آرگومان خود می‌پذیرد.
مقدار
\f\*[I-Font]size\f[]
محدود به موارد زیر است:
.in +4
.nf
.na
در محدوده  8 تا 1023، یا
در محدوده  8192 تا 4194304
.fi
.in -4
.sp
اندازه فایل خروجی را به \fIsize\fP بایت محدود می‌کند و در صورت نیاز
فایل‌ها را تقسیم می‌کند. مقادیر مجاز همانند گزینه \fB--whole-size-limit\fP
تعیین می‌شوند.
.sp
بخش‌های بایگانی ایجادشده با این گزینه باید به ترتیب صحیح باز شوند.
اگر گیرنده بایگانی‌های شل بخواهد تمام آن‌ها را در یک پوشه (فایل) ایمیل واحد
قرار دهد، باید به ترتیب درست ذخیره شوند تا \fBunshar\fP بتواند همه آن‌ها را
یکجا باز کند (با استفاده از یکی از گزینه‌های split archive).
ببینید: فراخوانی unshar.
.TP
.NOP \f\*[B-Font]\-I\f[] \f\*[I-Font]file\f[], \f\*[B-Font]\-\-input\-file\-list\f[]=\f\*[I-Font]file\f[]
خواندن فهرست فایل‌ها از یک فایل.
.sp
این گزینه موجب می‌شود \fIfile\fP مجدداً به عنوان ورودی استاندارد باز شود.
اگر هیچ فایلی در خط ورودی یافت نشود، ورودی استاندارد برای خواندن نام فایل‌های
ورودی بررسی می‌شود. استفاده از این گزینه مانع از ذکر فایل‌های ورودی در
خط فرمان خواهد شد.
.sp
ورودی باید به شکلی مشابه خروجی تولیدشده توسط \fBfind\fP باشد، هر نام فایل
در یک خط. این سوییچ به‌ویژه زمانی مفید است که خط فرمان گنجایش فهرست
فایل‌های مورد نظر برای بایگانی را ندارد.
.sp
اگر گزینه \fB--intermix-type\fP در خط فرمان مشخص شده باشد، گزینه‌های فشرده‌سازی
می‌توانند در خطوطی جداگانه در ورودی استاندارد گنجانده شوند و هیچ نام فایلی
نباید با یک خط تیره شروع شود.
.sp
برای مثال:
.nf
    { echo \--compact xz
       find . \-type f \-print | sort
    } | shar \-S \-p \-L50K \-o /somewhere/big
.fi
.TP
.NOP \f\*[B-Font]\-S\f[], \f\*[B-Font]\-\-stdin\-file\-list\f[]
خواندن فهرست فایل‌ها از ورودی استاندارد.
.sp
این گزینه در واقع هیچ عملی انجام نمی‌دهد (no-op). این گزینه یک پوشش برای
\fB--input-file-list=-\fP است.
.sp
.B
نکته: این گزینه منسوخ شده است.SS "کنترل سرایندهای shar"
.TP
.NOP \f\*[B-Font]\-n\f[] \f\*[I-Font]name\f[], \f\*[B-Font]\-\-archive\-name\f[]=\f\*[I-Font]name\f[]
استفاده از \fIname\fP برای ثبت مشخصات آرشیو.
.sp
نام آرشیو جهت درج در سرایند موضوع فایل‌های shar.
گزینهٔ \fB--net-headers\fP را ببینید.
.TP
.NOP \f\*[B-Font]\-s\f[] \f\*[I-Font]who@where\f[], \f\*[B-Font]\-\-submitter\f[]=\f\*[I-Font]who@where\f[]
بازنویسی نام ارسال‌کننده.
.sp
\fBshar\fP به طور معمول نام ارسال‌کننده را با استعلام از سیستم تعیین می‌کند.
اگر این کار به نمایندگی از شخص دیگری انجام می‌شود، از این گزینه استفاده کنید.
.TP
.NOP \f\*[B-Font]\-a\f[], \f\*[B-Font]\-\-net\-headers\f[]
خروجی دادن سرایندهای Submitted-by: و Archive-name:.
این گزینه باید در ترکیب با گزینهٔ زیر مشخص شود:
archive-name.
.sp
سرایندهای ایمیل تخصصی زیر را اضافه می‌کند:
.nf
    Submitted-by: \fIwho@@where\fP
    Archive-name: \fIname\fP/part##
.fi
بخش \fIwho@@where\fP به طور معمول از سیستم به دست می‌آید، اما می‌تواند با گزینهٔ \fB--submitter\fP نیز مشخص شود.
مقدار \fIname\fP باید همراه با گزینهٔ \fB--archive-name\fP ارائه شود.
اگر نام آرشیو شامل نویسهٔ خط مورب (\fB/\fP) باشد، بخش \fB/part##\fP حذف می‌شود.
بنابراین دستور \fB-n xyzzy\fP موارد زیر را تولید می‌کند:
.nf
    xyzzy/part01
    xyzzy/part02
.fi
.sp
در حالی که دستور \fB-n xyzzy/patch\fP خروجی زیر را به همراه دارد:
.nf
    xyzzy/patch01
    xyzzy/patch02
.fi
.sp
و دستور \fB-n xyzzy/patch01.\fP خروجی زیر را تولید می‌کند:
.nf
    xyzzy/patch01.01
    xyzzy/patch01.02
.fi
.TP
.NOP \f\*[B-Font]\-c\f[], \f\*[B-Font]\-\-cut\-mark\f[]
آغاز کردن shar با یک خط برش.
.sp
یک سطر با متن 'Cut here' در ابتدای هر فایل خروجی قرار می‌گیرد.
.TP
.NOP \f\*[B-Font]\-t\f[], \f\*[B-Font]\-\-translate\f[]
ترجمهٔ پیام‌ها درون اسکریپت.
.sp
ترجمهٔ پیام‌ها در اسکریپت. اگر متغیر محیطی \fBLANG\fP را تنظیم کرده باشید، پیام‌های چاپ‌شده توسط \fBshar\fP به زبان مشخص‌شده خواهند بود.
با این وجود، اسکریپت تولیدشده همچنان با استفاده از پیام‌هایی به زبان مشترک دنیای رایانه یعنی انگلیسی صادر خواهد شد.
این گزینه باعث می‌شود پیام‌های درون اسکریپت به زبان‌های تعیین‌شده توسط متغیر محیطی \fBLANG\fP که هنگام تولید اسکریپت فعال بوده است ظاهر شوند.
.SS "محافظت در برابر مشکلات انتقال"
.TP
.NOP \f\*[B-Font]\-\-no\-character\-count\f[]
عدم استفاده از \(lqwc \-c\(rq برای بررسی اندازه.
.sp
پس از استخراج (unpack)، هر فایل با 'wc \-c' بررسی نشود.
حالت پیش‌فرض بررسی اندازه است.
.TP
.NOP \f\*[B-Font]\-D\f[], \f\*[B-Font]\-\-no\-md5\-digest\f[]
عدم استفاده از خلاصهٔ \fBmd5sum\fP برای اعتبارسنجی.
.sp
از خلاصهٔ \fBmd5sum\fP برای اعتبارسنجی فایل‌های استخراج‌شده استفاده \fIنشود\fP.
حالت پیش‌فرض بررسی و اعتبارسنجی است.
.TP
.NOP \f\*[B-Font]\-F\f[], \f\*[B-Font]\-\-force\-prefix\f[]
اعمال نویسهٔ پیشوند در آغاز تمامی سطرها.
.sp
افزودن نویسهٔ پیشوند را به ابتدای تمامی سطرها اجباری می‌کند، حتی اگر نیازی به آن نباشد.
این گزینه ممکن است حجم آرشیو را اندکی افزایش دهد، به‌ویژه در صورت استفاده از \fB--uuencode\fP یا یکی از گزینه‌های فشرده‌سازی.
.TP
.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]delim\f[], \f\*[B-Font]\-\-here\-delimiter\f[]=\f\*[I-Font]delim\f[]
استفاده از \fIdelim\fP برای جداسازی فایل‌ها.
مقدار پیش‌فرض
\f\*[I-Font]delim\f[]
برای این گزینه برابر است با:
.ti +4
 SHAR_EOF
.sp
استفاده از DELIM برای جداسازی فایل‌ها در shar به جای SHAR_EOF.
این گزینه برای افرادی است که مایل‌اند فایل‌های shar خود را شخصی‌سازی کنند.
جداکننده همواره با نویسهٔ خط زیرین (underscore) به عنوان پیشوند و پسوند همراه خواهد بود.
.SS "تولید انواع مختلف shar"
.TP
.NOP \f\*[B-Font]\-V\f[], \f\*[B-Font]\-\-vanilla\-operation\f[]
تولید sharهای بسیار ساده.
.sp
این گزینه sharهای بسیار ساده (\fBvanilla\fP) تولید می‌کند که در محیط استخراج، تنها به وجود ابزارهای \fBecho\fP، \fBtest\fP و \fBsed\fP متکی هستند.
.sp
این گزینه رفتار پیش‌فرض را از حالت ترکیبی (\fB--mixed-uuencode\fP) به حالت متنی (\fB--text-files\fP) تغییر می‌دهد.
در صورتی که گزینه‌هایی انتخاب شوند که به فشرده‌زدایی یا رمزگشایی در محیط استخراج نیاز داشته باشند، هشدارهایی نمایش داده خواهد شد.
.TP
.NOP \f\*[B-Font]\-P\f[], \f\*[B-Font]\-\-no\-piping\f[]
استفاده از فایل‌های موقت به جای لوله‌کشی (pipe) بین برنامه‌ها.
.sp
درون فایل \fIshar\fP، به جای استفاده از لوله‌ها (pipes)، از یک فایل موقت برای نگه‌داری محتویات فایل‌ها بین مراحل مختلف استخراج استفاده شود.
هنگامی که اطمینان دارید عملیات استخراج روی سیستم‌هایی فاقد پشتیبانی از لوله‌کشی انجام می‌شود، استفاده از این گزینه الزامی است.
.TP
.NOP \f\*[B-Font]\-x\f[], \f\*[B-Font]\-\-no\-check\-existing\f[]
رونویسی بدون بررسی بر روی فایل‌های موجود.
.sp
آرشیو را به گونه‌ای می‌سازد که هنگام پردازش، فایل‌های موجود بدون بررسی قبلی رونویسی شوند.
چنانچه نه این گزینه و نه گزینهٔ \fB--query-user\fP تعیین نشده باشند، فرآیند استخراج بر روی فایل‌های از پیش موجود رونویسی نخواهد کرد.
با این وجود در تمام حالات، اگر پارامتر \fB--cut-mark\fP هنگام استخراج به اسکریپت داده شود، فایل‌های موجود بدون هیچ قید و شرطی رونویسی خواهند شد.
.sp
.nf
    sh shar-archive-file \-c
.fi
.TP
.NOP \f\*[B-Font]\-X\f[], \f\*[B-Font]\-\-query\-user\f[]
پرسش از کاربر پیش از رونویسی فایل‌ها.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر به کار رود:
vanilla-operation.
.sp
هنگام استخراج، از کاربر به صورت تعاملی پرسیده می‌شود که آیا فایل‌ها رونویسی شوند یا خیر.
از این گزینه برای sharهایی که قرار است در شبکه ارسال شوند استفاده نکنید.
.sp
استفاده از این گزینه sharهایی تولید می‌کند که برای برخی رویه‌ها و فرآیندهای به سبک unshar مشکلاتی ایجاد \fIخواهند کرد\fP، به‌ویژه اگر همراه با حالت ساده (\fB--vanilla-operation\fP) استفاده شود.
از این قابلیت بیشتر برای آرشیوهایی استفاده کنید که قرار است میان افراد با توافق دوجانبه رد و بدل شوند.
مسلماً گزینهٔ \fB-X\fP برای آرشیوهای پوسته‌ای که قرار است به Usenet یا سایر شبکه‌های عمومی ارسال شوند مناسب \fIنیست\fP.
.sp
دلیل این مشکل آن است که برنامه‌ها یا رویه‌های \fBunshar\fP اغلب \fI/bin/sh\fP را از طریق ورودی استاندارد آن تغذیه می‌کنند و بنابراین \fI/bin/sh\fP و اسکریپت آرشیو پوسته برای خواندن سطرهای ورودی به رقابت می‌افتند.
به عنوان تلاشی برای تخفیف این مشکل، \fBshar\fP بررسی می‌کند که آیا \fI/dev/tty\fP در سیستم گیرنده وجود دارد یا خیر و از آن برای دریافت پاسخ‌های کاربر استفاده خواهد کرد؛
اما این راهکار در تمامی شرایط کارساز نیست و ممکن است کاربر گیرنده مجبور شود از به کار بردن برنامه‌ها یا رویه‌های \fBunshar\fP خودداری کرده و مستقیماً \fI/bin/sh\fP را فراخوانی کند.
در حالت ساده (vanilla)، حتی تلاشی برای استفاده از \fI/dev/tty\fP انجام نمی‌شود.
.TP
.NOP \f\*[B-Font]\-m\f[], \f\*[B-Font]\-\-no\-timestamp\f[]
عدم بازیابی زمان‌های ویرایش فایل‌ها.
.sp
جلوگیری از ایجاد دستورات 'touch' برای بازیابی تاریخ‌های ویرایش فایل هنگام استخراج آن‌ها از آرشیو.
.sp
هنگامی که زمان‌های ویرایش فایل‌ها حفظ نشوند، برنامه‌های ساخت پروژه مانند "make"، فایل‌های ساخته‌شده را قدیمی‌تر از فایل‌های منبعی که از آن‌ها ساخته شده‌اند در نظر می‌گیرند.
به همین دلیل، زمانی که این گزینه استفاده نمی‌شود، تلاش ویژه‌ای برای بازیابی برچسب‌های زمانی انجام می‌گیرد.
.TP
.NOP \f\*[B-Font]\-Q\f[], \f\*[B-Font]\-\-quiet\-unshar\f[]
جلوگیری از ارسال پیام‌های پرگو (verbose) هنگام استخراج با unshar.
.sp
غیرفعال‌سازی حالت پرگو (Verbose OFF). قرار دادن توضیحاتی که هنگام استخراج آرشیو در خروجی نمایش داده می‌شوند را غیرفعال می‌کند.
.TP
.NOP \f\*[B-Font]\-f\f[], \f\*[B-Font]\-\-basename\f[]
بازیابی تمامی فایل‌ها در یک پوشه، صرف‌نظر از ساختار سلسله‌مراتبی.
.sp
بازیابی تنها بر پایهٔ نام اصلی فایل و نادیده گرفتن مسیر کامل آن. این گزینه سبب می‌شود تنها نام فایل‌ها استفاده شود، که هنگام ساخت shar از چندین پوشه یا یک پوشهٔ دیگر بسیار کاربردی است.
توجه داشته باشید که اگر نام یک پوشه به shar داده شود، ساختار داخلی آن پوشه چه این گزینه تعیین شده باشد چه نشده باشد، بازیابی خواهد شد..SS "گزینه‌های بین‌المللی‌سازی (Internationalization options)"
.TP
.NOP \f\*[B-Font]\-\-no\-i18n\f[]
عدم بین‌المللی‌سازی.
.sp
آرشیوهای شل بین‌المللی‌سازی‌شده تولید نشود، از پیام‌های پیش‌فرض انگلیسی
استفاده شود. به‌طور پیش‌فرض، shar آرشیوهایی تولید می‌کند که هنگام
استخراج، تلاش خواهند کرد پیام‌ها را به زبان ترجیحی استخراج‌کننده
(که توسط متغیرهای محیطی LANG/LC_MESSAGES مشخص می‌شود) نمایش دهند.
اگر هنگام استخراج هیچ فایل پیامی برای زبان استخراج‌کننده یافت نشود،
پیام‌ها به زبان انگلیسی خواهند بود.
.TP
.NOP \f\*[B-Font]\-\-print\-text\-domain\-dir\f[]
چاپ دایرکتوری پیام‌های shar.
.sp
دایرکتوری‌ای را که shar برای یافتن فایل‌های پیام زبان‌های گوناگون
جستجو می‌کند چاپ کرده و بلافاصله خارج می‌شود.
.SS "بازخورد کاربر/سرگرمی (User feedback/entertainment)"
.TP
.NOP \f\*[B-Font]\-q\f[], \f\*[B-Font]\-\-quiet\f[]
پیام‌های پرحرف چاپ نشوند.
.sp
حذف پیام‌های پیشرفت کار.
.TP
.NOP \f\*[B-Font]\-\-silent\f[]
این یک نام مستعار برای گزینه \fI--quiet\fR است.
.TP
.NOP \f\*[B-Font]\-h\f[], \f\*[B-Font]\-\-help\f[]
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[]
نمایش اطلاعات تفصیلی نحوه استفاده از طریق یک صفحه‌بند (pager).
.TP
.NOP \f\*[B-Font]\-R\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]]
ذخیره وضعیت گزینه‌ها در \fIcfgfile\fP. پیش‌فرض، \fIآخرین\fP فایل
پیکربندی فهرست‌شده در بخش \fBپیش‌تنظیمات گزینه‌ها (OPTION PRESETS)\fP
در ادامه است. دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد.
.TP
.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no-load-opts\f[]
بارگذاری گزینه‌ها از \fIcfgfile\fP.
فرم \fIno-load-opts\fP بارگذاری فایل‌های پیکربندی/rc/ini قبلی را غیرفعال
می‌کند. گزینه \fI\-\-no-load-opts\fP در مراحل اولیه و خارج از نوبت معمول
پردازش می‌شود.
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
چاپ نسخه برنامه و خروج. حالت پیش‌فرض `v'، یک نسخه ساده است.
حالت `c' اطلاعات حق نشر و `n' اعلان کامل حق نشر را چاپ خواهد کرد.
.PP
.SH "پیش‌تنظیمات گزینه‌ها (OPTION PRESETS)"
هر گزینه‌ای که به عنوان \fInot presettable\fP علامت‌گذاری نشده باشد،
می‌تواند با بارگذاری مقادیر از فایل(های) پیکربندی ("RC" یا ".INI")
از پیش تنظیم شود. در صورت وجود، از فایل "\fI$HOME/.sharrc\fP"
استفاده خواهد شد.
.SH "هشدارها (WARNINGS)"
هیچ تلاشی برای بازیابی مجوزهای دسترسی و تاریخ‌های تغییر دایرکتوری‌ها
صورت نمی‌گیرد، حتی با اینکه این کار به‌طور پیش‌فرض برای فایل‌ها انجام می‌شود.
بنابراین، اگر دایرکتوری‌ای به \fBshar\fP داده شود، مجوزها و تاریخ‌های تغییر
دایرکتوری استخراج‌شده متناظر ممکن است با دایرکتوری اصلی همخوانی نداشته باشد.
.sp
اگر دایرکتوری‌ای به shar ارسال شود، ممکن است برای صرفه‌جویی در مصرف حافظه،
بیش از یک بار پویش شود. بنابراین، محتویات دایرکتوری را در حین اجرای shar
تغییر ندهید.
.sp
دقت کنید که فایل(های) خروجی در میان ورودی‌ها قرار نگیرند؛ در غیر این صورت
ممکن است shar وارد حلقه‌ای شود تا زمانی که دیسک پر شود. به‌ویژه هنگام
ارسال یک دایرکتوری به shar مراقب باشید که فایل‌های خروجی درون آن دایرکتوری
یا زیردایرکتوری‌های آن نباشند.
.sp
استفاده از گزینه‌های فشرده‌سازی و کدگذاری، فرایند ساخت آرشیو را،
احتمالاً به میزان قابل توجهی، کند خواهد کرد.
.sp
استفاده از \fB\-\-query\-user\fP فایل‌های sharای تولید می‌کند که رویه‌های
\fBunshar\fP بسیاری را دچار مشکل \fIخواهد کرد\fP. از این ویژگی تنها برای
آرشیوهایی استفاده کنید که قرار است بین افراد هماهنگ و موافق رد و بدل شوند.
قطعاً \fBquery\-user\fP برای آرشیوهای شلی که قرار است در سطح شبکه توزیع شوند
مناسب نیست. استفاده از فشرده‌سازی در آرشیوهای متنی شبکه باعث انتقادهای شدیدی
از سوی کاربران خواهد شد. همچنین عدم استفاده از گزینه‌های \fB\-\-no\-timestamp\fP
یا \fB\-\-force\-prefix\fP نیز ممکن است گهگاه شکایت‌هایی در پی داشته باشد.
این گزینه‌ها را در فایل \fI~/.sharrc\fP خود قرار دهید.
.SH "فایل‌ها (FILES)"
برای فایل‌های پیکربندی به بخش \fBپیش‌تنظیمات گزینه‌ها (OPTION PRESETS)\fP مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
مثال نخست نحوه ساخت یک آرشیو شل از تمام سورس‌کدهای برنامه‌های C را نشان
می‌دهد. مثال دوم یک آرشیو شل شامل همه فایل‌های \fI.c\fP و \fI.h\fP تولید
می‌کند که بدون نمایش پیام استخراج می‌شود. مثال سوم یک آرشیو شل از همه
فایل‌های \fI.arc\fP با کدگذاری uuencode را در قالب فایل‌های شماره‌گذاری‌شده
که از \fIarc.sh.01\fP آغاز می‌شوند ایجاد می‌کند. مثال آخر یک آرشیو شل
ارائه می‌دهد که هنگام استخراج تنها از نام فایل‌ها استفاده خواهد کرد.
.sp
.br
.in +4
.nf
shar *.c > cprog.shar
shar \-Q *.[ch] > cprog.shar
shar \-B \-l28 \-oarc.sh *.arc
shar \-f /lcl/src/u*.c > u.sh
.in -4
.fi
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_OPTION_ERROR)"
گزینه‌های دستور به‌درستی پیکربندی نشده بودند.
.TP
.NOP 2 " (EXIT_FILE_NOT_FOUND)"
ورودی مشخص‌شده پیدا نشد.
.TP
.NOP 3 " (EXIT_CANNOT_OPENDIR)"
باز کردن/بستن دایرکتوری مشخص‌شده ناموفق بود.
.TP
.NOP 4 " (EXIT_FAILED)"
محدودیت منابع/شکست در اجرای دستور متفرقه shar.
.TP
.NOP 63 " (EXIT_BUG)"
باگی در دستور shar وجود دارد. لطفاً آن را گزارش دهید.
.TP
.NOP 66 " (EX_NOINPUT)"
فایل پیکربندی مشخص‌شده قابل بارگذاری نبود.
.TP
.NOP 70 " (EX_SOFTWARE)"
خطای عملیاتی داخلی در libopts رخ داد. لطفاً آن را به
autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP.SH "همچنین ببینید (SEE ALSO)"
unshar(1)
.SH "نویسندگان (AUTHORS)"
برنامه‌های \fIshar\fP و \fIunshar\fP حاصل تلاش جمعی نویسندگان بسیاری است. افراد زیادی با گزارش مشکلات، پیشنهاد بهبودهای مختلف یا ارسال کدهای مفید در توسعهٔ آن مشارکت کرده‌اند. فهرستی از این افراد در فایل \fITHANKS\fP در توزیع sharutils قرار دارد.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
کپی‌رایت (C) 1994-2015 متعلق به Free Software Foundation, Inc. تمامی حقوق محفوظ است.
این برنامه تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License)، نسخهٔ ۳ یا بالاتر منتشر شده است.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً در موضوع ایمیل‌های گزارش باگ، عبارت \fBsharutils\fP را درج کنید. این کار به تشخیص و پیگیری بهتر پیام کمک می‌کند.
.sp \n(Ppu
.ne 2

لطفاً گزارش باگ‌ها را به این نشانی بفرستید: bug-gnu-utils@gnu.org
.SH "نکات (NOTES)"
این صفحهٔ راهنما با استفاده از \fIAutoGen\fP و از روی تعاریف گزینه‌های \fBshar\fP تولید شده است.