.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (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 .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "PARL 1" .TH PARL 1 2026-04-05 "perl v5.42.2" "User Contributed Perl 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)" parl \- بارگذار باینری PAR .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" (برای راه‌های ساده‌تر جهت ساخت فایل‌های اجرایی خودکفا، اسکریپت‌ها یا آرشیوهای PAR از برنامه‌های perl، لطفاً pp را ببینید.) .PP برای ساخت یک \fIتوزیع PAR\fR از یک توزیع ماژول CPAN: .PP .Vb 2 \& % parl \-p # ساخت توزیع PAR در مسیر جاری \& % parl \-p Foo\-0.01 # فرض وجود توزیع بازشده CPAN در Foo\-0.01/ .Ve .PP برای دستکاری و مدیریت یک \fIتوزیع PAR\fR: .PP .Vb 6 \& % parl \-i Foo\-0.01\-i386\-freebsd\-5.8.0.par # نصب \& % parl \-i http://foo.com/Foo\-0.01 # افزودن خودکار archname + perlver \& % parl \-i cpan://AUTRIJUS/PAR\-0.74 # استفاده از دایرکتوری نویسنده CPAN \& % parl \-u Foo\-0.01\-i386\-freebsd\-5.8.0.par # حذف نصب \& % parl \-s Foo\-0.01\-i386\-freebsd\-5.8.0.par # امضا \& % parl \-v Foo\-0.01\-i386\-freebsd\-5.8.0.par # اعتبارسنجی .Ve .PP برای استفاده از \fIHello.pm\fR از \fI./foo.par\fR: .PP .Vb 2 \& % parl \-A./foo.par \-MHello \& % parl \-A./foo \-MHello # بخش .par اختیاری است .Ve .PP همان کار، اما با جستجوی \fIfoo.par\fR در \fR\f(CI@INC\fR\fI\fR؛ .PP .Vb 2 \& % parl \-Ifoo.par \-MHello \& % parl \-Ifoo \-MHello # مانند بالا .Ve .PP اجرای \fItest.pl\fR یا \fIscript/test.pl\fR از \fIfoo.par\fR: .PP .Vb 2 \& % parl foo.par test.pl # به‌طور پیش‌فرض به دنبال \*(Aqmain.pl\*(Aq می‌گردد، \& # در غیر این صورت \*(Aqtest.pl\*(Aq را اجرا می‌کند .Ve .PP برای ساخت یک فایل اجرایی خودکفا شامل یک فایل PAR: .PP .Vb 2 \& % parl \-O./foo foo.par \& % ./foo test.pl # مانند بالا .Ve .PP برای گنجاندن ماژول‌های غیرپایه (non\-core) و اشیاء اشتراکی لازم جهت اجرای PAR (مانند \f(CW\*(C`Zlib\*(C'\fR، \f(CW\*(C`IO\*(C'\fR، \f(CW\*(C`Cwd\*(C'\fR و غیره)، از پرچم \fB\-b\fR استفاده کنید: .PP .Vb 2 \& % parl \-b \-O./foo foo.par \& % ./foo test.pl # در هر سیستمی با ماژول‌های پایه نصب‌شده اجرا می‌شود .Ve .PP اگر می‌خواهید ماژول‌های \fIپایه (core)\fR را نیز در آن بگنجانید، به‌جای آن از پرچم \fB\-B\fR استفاده کنید: .PP .Vb 2 \& % parl \-B \-O./foo foo.par \& % ./foo test.pl # در هر جایی به همراه مفسر perl اجرا می‌شود .Ve .PP این قابلیت به‌ویژه هنگام ساخت فایل‌های باینری اجرایی مستقل کاربرد دارد؛ برای جزئیات بیشتر pp را ببینید. .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور مستقل تقریباً قابلیتی مشابه با \f(CW\*(C`perl \-MPAR\*(C'\fR ارائه می‌دهد، با این تفاوت که فایل‌های \fI.par\fR از پیش بارگذاری‌شده را به‌جای \f(CW\*(C`\-MPAR=foo.par\*(C'\fR از طریق \f(CW\*(C`\-Afoo.par\*(C'\fR دریافت می‌کند. .PP علاوه بر این، به شما امکان می‌دهد تا یک توزیع CPAN را به یک توزیع PAR تبدیل کنید و همچنین این توزیع‌ها را دستکاری نمایید. برای اطلاعات بیشتر درباره توزیع‌های PAR، به PAR::Dist مراجعه کنید. .PP می‌توانید از آن برای اجرای فایل‌های \fI.par\fR استفاده کنید: .PP .Vb 3 \& # فایل script/run.pl را در آرشیو اجرا کرده و از lib/* آن به‌عنوان کتابخانه‌ها استفاده می‌کند \& % parl myapp.par run.pl # اجرای run.pl یا script/run.pl در myapp.par \& % parl otherapp.pl # همچنین اسکریپت‌های معمولی perl را اجرا می‌کند .Ve .PP با این حال، اگر آرشیو \fI.par\fR شامل یکی از فایل‌های \fImain.pl\fR یا \fIscript/main.pl\fR باشد، به‌جای آن استفاده می‌شود: .PP .Vb 1 \& % parl myapp.par run.pl # اجرای main.pl، با \*(Aqrun.pl\*(Aq به‌عنوان @ARGV .Ve .PP در نهایت، گزینهٔ \f(CW\*(C`\-O\*(C'\fR یک فایل اجرایی باینری مستقل از یک فایل PAR می‌سازد: .PP .Vb 2 \& % parl \-B \-Omyapp myapp.par \& % ./myapp # اجرای آن در هر جایی بدون نیاز به باینری‌های perl .Ve .PP با پرچم \f(CW\*(C`\-\-par\-options\*(C'\fR، باینری‌های تولیدشده می‌توانند مانند \f(CW\*(C`parl\*(C'\fR برای بسته‌بندی باینری‌های جدید عمل کنند: .PP .Vb 2 \& % ./myapp \-\-par\-options \-Omyap2 myapp.par # کاملاً مشابه ./myapp \& % ./myapp \-\-par\-options \-Omyap3 myap3.par # این بار با PAR متفاوت .Ve .PP برای مطالعهٔ توضیحات درباره ساختار و قالب فایل‌های اجرایی مستقل، لطفاً par.pl را ببینید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" PAR, PAR::Dist, par.pl, pp .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Audrey Tang .PP می‌توانید به فهرست رایانامه در پیام بفرستید، یا یک رایانامهٔ خالی به ارسال کنید تا در گفتگوها شرکت نمایید. بایگانی‌های فهرست رایانامه در یا در دسترس است. .PP لطفاً گزارش‌های باگ را به ارسال کنید. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" کپی‌رایت 2002\-2009 متعلق به Audrey Tang . .PP نه این برنامه و نه برنامه مرتبط pp، هیچ‌گونه محدودیت مجوزی بر روی فایل‌های تولیدشده حاصل از اجرای خود اعمال نمی‌کنند، مطابق با بند هشتم Artistic License: .PP .Vb 5 \& "Aggregation of this Package with a commercial distribution is \& always permitted provided that the use of this Package is embedded; \& that is, when no overt attempt is made to make this Package\*(Aqs \& interfaces visible to the end user of the commercial distribution. \& Such use shall not be construed as a distribution of this Package." .Ve .PP بنابراین، شما کاملاً مجازید هر مجوزی را بر روی فایل اجرایی حاصل قرار دهید، تا زمانی که کتابخانه‌های شخص ثالث بسته‌بندی‌شده نیز تحت مجوز Artistic License در دسترس باشند. .PP این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده و/یا تغییر دهید. .PP \fILICENSE\fR را ببینید.