نام (NAME)

parl - بارگذار باینری PAR

خلاصه دستور (SYNOPSIS)

(برای راه‌های ساده‌تر جهت ساخت فایل‌های اجرایی خودکفا، اسکریپت‌ها یا آرشیوهای PAR از برنامه‌های perl، لطفاً pp را ببینید.)

برای ساخت یک توزیع PAR از یک توزیع ماژول CPAN:

% parl -p                 # ساخت توزیع PAR در مسیر جاری
% parl -p Foo-0.01        # فرض وجود توزیع بازشده CPAN در Foo-0.01/

برای دستکاری و مدیریت یک توزیع PAR:

% 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   # اعتبارسنجی

برای استفاده از Hello.pm از ./foo.par:

% parl -A./foo.par -MHello 
% parl -A./foo -MHello      # بخش .par اختیاری است

همان کار، اما با جستجوی foo.par در @INC؛

% parl -Ifoo.par -MHello 
% parl -Ifoo -MHello        # مانند بالا

اجرای test.pl یا script/test.pl از foo.par:

% parl foo.par test.pl      # به‌طور پیش‌فرض به دنبال 'main.pl' می‌گردد،
                            # در غیر این صورت 'test.pl' را اجرا می‌کند

برای ساخت یک فایل اجرایی خودکفا شامل یک فایل PAR:

% parl -O./foo foo.par
% ./foo test.pl             # مانند بالا

برای گنجاندن ماژول‌های غیرپایه (non-core) و اشیاء اشتراکی لازم جهت اجرای PAR (مانند "Zlib"، "IO"، "Cwd" و غیره)، از پرچم -b استفاده کنید:

% parl -b -O./foo foo.par
% ./foo test.pl             # در هر سیستمی با ماژول‌های پایه نصب‌شده اجرا می‌شود

اگر می‌خواهید ماژول‌های پایه (core) را نیز در آن بگنجانید، به‌جای آن از پرچم -B استفاده کنید:

% parl -B -O./foo foo.par
% ./foo test.pl             # در هر جایی به همراه مفسر perl اجرا می‌شود

این قابلیت به‌ویژه هنگام ساخت فایل‌های باینری اجرایی مستقل کاربرد دارد؛ برای جزئیات بیشتر pp را ببینید.

توضیحات (DESCRIPTION)

این دستور مستقل تقریباً قابلیتی مشابه با "perl -MPAR" ارائه می‌دهد، با این تفاوت که فایل‌های .par از پیش بارگذاری‌شده را به‌جای "-MPAR=foo.par" از طریق "-Afoo.par" دریافت می‌کند.

علاوه بر این، به شما امکان می‌دهد تا یک توزیع CPAN را به یک توزیع PAR تبدیل کنید و همچنین این توزیع‌ها را دستکاری نمایید. برای اطلاعات بیشتر درباره توزیع‌های PAR، به PAR::Dist مراجعه کنید.

می‌توانید از آن برای اجرای فایل‌های .par استفاده کنید:

# فایل script/run.pl را در آرشیو اجرا کرده و از lib/* آن به‌عنوان کتابخانه‌ها استفاده می‌کند
% parl myapp.par run.pl     # اجرای run.pl یا script/run.pl در myapp.par
% parl otherapp.pl          # همچنین اسکریپت‌های معمولی perl را اجرا می‌کند

با این حال، اگر آرشیو .par شامل یکی از فایل‌های main.pl یا script/main.pl باشد، به‌جای آن استفاده می‌شود:

% parl myapp.par run.pl     # اجرای main.pl، با 'run.pl' به‌عنوان @ARGV

در نهایت، گزینهٔ "-O" یک فایل اجرایی باینری مستقل از یک فایل PAR می‌سازد:

% parl -B -Omyapp myapp.par
% ./myapp                   # اجرای آن در هر جایی بدون نیاز به باینری‌های perl

با پرچم "--par-options"، باینری‌های تولیدشده می‌توانند مانند "parl" برای بسته‌بندی باینری‌های جدید عمل کنند:

% ./myapp --par-options -Omyap2 myapp.par   # کاملاً مشابه ./myapp
% ./myapp --par-options -Omyap3 myap3.par   # این بار با PAR متفاوت

برای مطالعهٔ توضیحات درباره ساختار و قالب فایل‌های اجرایی مستقل، لطفاً par.pl را ببینید.

همچنین ببینید (SEE ALSO)

PAR, PAR::Dist, par.pl, pp

نویسندگان (AUTHORS)

Audrey Tang <cpan@audreyt.org>

می‌توانید به فهرست رایانامه در <par@perl.org> پیام بفرستید، یا یک رایانامهٔ خالی به <par-subscribe@perl.org> ارسال کنید تا در گفتگوها شرکت نمایید. بایگانی‌های فهرست رایانامه در https://www.mail-archive.com/par@perl.org یا https://groups.google.com/g/perl.par در دسترس است.

لطفاً گزارش‌های باگ را به https://github.com/rschupp/PAR-Packer/issues ارسال کنید.

کپی‌رایت و تکثیر (COPYRIGHT)

کپی‌رایت 2002-2009 متعلق به Audrey Tang <cpan@audreyt.org>.

نه این برنامه و نه برنامه مرتبط pp، هیچ‌گونه محدودیت مجوزی بر روی فایل‌های تولیدشده حاصل از اجرای خود اعمال نمی‌کنند، مطابق با بند هشتم Artistic License:

"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's
interfaces visible to the end user of the commercial distribution.
Such use shall not be construed as a distribution of this Package."

بنابراین، شما کاملاً مجازید هر مجوزی را بر روی فایل اجرایی حاصل قرار دهید، تا زمانی که کتابخانه‌های شخص ثالث بسته‌بندی‌شده نیز تحت مجوز Artistic License در دسترس باشند.

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده و/یا تغییر دهید.

LICENSE را ببینید.