.TH SWI 1 "Feb 8, 2006" "SWI-Prolog" "راهنمای دستورات کاربر"
.SH "نام (NAME)"
swipl-ld \- ایجاد یک فایل اجرایی تعبیه‌شده SWI-Prolog
.SH "شرح مختصر (SYNOPSIS)"
.BR swipl-ld
.B "گزینه‌ها فایل‌های-c فایل‌های-o فایل‌های-pl
.br
.SH "توضیحات (DESCRIPTION)"
ابزار
.BI swipl-ld
یک رابط کاربری فرانت‌اند برای کامپایلر و پیونددهنده C است تا یک فایل اجرایی مستقل از مجموعه‌ای از فایل‌های ورودی C/C++ و پرولاگ بسازد. این ابزار اطلاعات را از فایل اجرایی SWI-Prolog یعنی
.B swipl
استخراج کرده و سپس آرگومان‌ها را بررسی و به دسته‌های مختلف تفکیک می‌کند. سپس کامپایلر C را فراخوانی می‌کند تا یک فایل اجرایی حاوی کد C کاربر و هسته SWI-Prolog بسازد. پس از آن، در صورت وجود هرگونه فایل پرولاگ در خط فرمان، محیط توسعه را فراخوانی می‌کند تا یک وضعیت ذخیره‌شده (saved state) پرولاگ از فایل‌های منبع بسازد، و در نهایت با الحاق وضعیت ذخیره‌شده به شبیه‌ساز، فایل اجرایی هدف را تولید می‌کند؛ در غیر این صورت، یک فایل اجرایی معمولی می‌سازد (همچنین گزینه
.BI \-nostate ""
را ببینید). همچنین به
.BI qsave_program/2
در راهنمای
.BI SWI-Prolog
مراجعه کنید.

.SS "گزینه‌ها (Options)"
.TP
.BI \-pl " پرولاگ"
نسخه پرولاگ مورد استفاده را مشخص می‌کند. مقدار پیش‌فرض
.BI swipl
است. این پرچم ممکن است برای انتخاب بین نسخه‌های مختلف نصب‌شده روی سیستم، یا مشخص کردن یک نسخه سفارشی استفاده شود. نسخه اصلاح‌شده باید پرچم‌های زیر را پشتیبانی کند:
.BI \-dump-runtime-variables
.BI \-f " file"
.BI \-F " file"
.BI \-g " goal"
.BI \-t " toplevel".
.TP
.BI \-help
نمایش خلاصه گزینه‌ها.
.TP
.BI \-nostate
فقط هسته را دوباره پیوند می‌دهد. هسته جدید پیوندیافته فقط در حضور سیستم توسعه می‌تواند کار کند. هرگونه فایل منبع پرولاگ ارائه‌شده نادیده گرفته می‌شود، و همچنین گزینه‌های
.BI \-goal
.BI \-toplevel
.BI \-initfile.
.BI \-class
در صورتی که بارگیری پویا در سیستم شما پشتیبانی نشود، این روش ترجیحی برای پیوست ماژول‌های خارجی به پرولاگ است.
.TP
.B \-c
کامپایل فایل‌های منبع C یا C++ به فایل‌های شیء (object files). این گزینه
.B swipl-ld
را به جایگزینی برای کامپایلر C یا C++ تبدیل می‌کند که در آن گزینه‌های مناسب مانند مسیر دایرکتوری include به طور خودکار به کامپایلر منتقل می‌شوند.
.TP
.B \-E
فراخوانی پیش‌پردازنده C. برای تبدیل
.B swipl-ld
به جایگزین کامپایلر C یا C++ استفاده می‌شود.
.TP
.B \-shared
پیوند فایل‌های C، C++ یا فایل‌های شیء به یک شیء مشترک (DLL یا Shared Object) که می‌تواند توسط گزاره
.I load_foreign_library/1
بارگیری شود. این گزینه مستلزم
.B \-nostate
است. در صورت استفاده با
.B \-c
گزینه‌های مناسب را برای کامپایل یک فایل C یا C++ آماده پیوند به یک شیء مشترک تنظیم می‌کند.
.TP
.B \-embed-shared
تعبیه SWI-Prolog در یک شیء مشترک/DLL به جای یک فایل اجرایی. برای جزئیات به راهنمای مرجع مراجعه کنید.
.TP
.B \-dll
.I "تنها در ویندوز"
مشابه
.B \-embed-shared
برای سازگاری با نسخه‌های پیشین.
.TP
.BI \-F " base"
به طور پیش‌فرض، مقدار
.I none
به دستور swipl ارسال می‌شود تا وضعیت ذخیره‌شده را بسازد. با استفاده از
.I "\-F xpce"
می‌توانید بارگیری
.IR xpce.rc
را مشخص کنید که XPCE را در وضعیت ذخیره‌شده در دسترس قرار می‌دهد.
.TP
.BI \-goal " هدف"
هدفی که در ابتدا هنگام راه‌اندازی سطح بالا با استفاده از
.BR "PL_toplevel()"
اجرا می‌شود. مقدار پیش‌فرض مشابه پرچم
.BI \-g
برای دستور
.BR "swipl"
است، یعنی:
.I "version/0"
(با تنظیم
.BI \-goal " هدف"
می‌توان از چاپ سرآیند جلوگیری کرد). اگر هیچ فایل پرولاگی در فایل اجرایی وجود نداشته باشد، این گزینه تأثیری ندارد.
.TP
.BI \-toplevel " هدف"
هدفی که به عنوان هدف اصلی سطح بالا اجرا می‌شود؛ یعنی پرچم پیش‌فرض
.BI \-t
برای فایل اجرایی جدید.
.TP
.BI \-initfile " فایل"
فایلی که توسط سطح بالا بارگیری می‌شود؛ یعنی پرچم پیش‌فرض
.BI \-f
برای فایل اجرایی جدید.
.TP
.BI \-class " {runtime,kernel,development}"
کلاس ذخیره وضعیت ذخیره‌شده پرولاگ ایجاد شده را تنظیم می‌کند. اگر
.B runtime
(پیش‌فرض) باشد، سیستم حاصل تفسیر تمام آرگومان‌ها را به برنامه واگذار می‌کند. اگر
.B kernel
باشد تمام گزاره‌ها برای ردیاب قفل می‌شوند. در نهایت، اگر
.B development
باشد وضعیت به صورت «همان‌گونه که هست» ذخیره می‌شود و سیستم حاصل گزینه‌ها را دقیقاً مانند فایل اجرایی پایه SWI-Prolog پردازش می‌کند. به
.B "qsave_program/2"
در
.IR "راهنمای مرجع SWI-Prolog"
مراجعه کنید.
.TP
.BI \-v
حالت پرگویی (Verbose). این گزینه دستورات را قبل از اجرا نمایش می‌دهد. توجه داشته باشید که برخی از دستورات به عنوان دستورات شل چاپ می‌شوند، اما در واقع توسط خود swipl-ld برای سازگاری با بسترهای Win32 اجرا می‌شوند.
.TP
.BI \-f
عملیات ساختگی (Fake). همراه با
.BI \-v
دستوراتی را که باید اجرا شوند بدون انجام هیچ عملیاتی چاپ می‌کند.
.TP
.BI \-E "cppargument ..."
اگر اولین گزینه
.BR \-E ","
باشد تمام گزینه‌های بعدی الحاق شده و به برنامه‌ای که توسط پیکربندی SWI-Prolog برای اجرای
.BR cpp
انتخاب شده تحویل داده می‌شوند.
.TP
.BI \-o " فایل"
نام فایل اجرایی نهایی را مشخص می‌کند. پیش‌فرض
.BI a.out
است.
.TP
.BI \-cc " کامپایلر-C"
کامپایلر مورد استفاده برای فایل‌های
.BI *.c
را مشخص می‌کند. پیش‌فرض کامپایلری است که برای کامپایل خود SWI-Prolog استفاده شده و از ویژگی
.BI c_cc
خوانده می‌شود.
.TP
.BI -c++ " کامپایلر-C++"
کامپایلر مورد استفاده برای فایل‌های ورودی C++ را مشخص می‌کند. اگر کامپایلر C برابر
.BI gcc
باشد، این مقدار
.BI g++
خواهد بود، در غیر این صورت
.BI c++
فرض می‌شود.
.TP
.BI \-ld " پیونددهنده"
پیونددهنده مورد استفاده را مشخص می‌کند. پیش‌فرض کامپایلر C است. در بسترهای Win32 پیش‌فرض
.BI link.exe
است.
.TP
.BI \-l "کتابخانه"
یک کتابخانه C را برای پیوند برنامه مشخص می‌کند. به طور پیش‌فرض،
.BR \-lswipl
و همچنین کتابخانه‌های مورد نیاز هسته SWI-Prolog به کامپایلر C ارسال می‌شوند.
.TP
.BI \-L "دایرکتوری-کتابخانه"
یک مسیر دایرکتوری کتابخانه اضافی برای کامپایلر C مشخص می‌کند. به طور پیش‌فرض، دایرکتوری زمان اجرا برای معماری فعلی ارسال می‌شود.
.TP
.BI \-g|-I*|-D*|-U*|-O*|-W*
به عنوان پرچم‌های C به کامپایلر ارسال می‌شوند. به طور پیش‌فرض دایرکتوری include مربوط به SWI-Prolog به عنوان دایرکتوری الحاقی ارسال می‌شود. پرچم‌های \-D زیر توسط swipl-ld اضافه می‌شوند: \-D__SWI_PROLOG__ و \-D__SWI_EMBEDDED__.
.TP
.BI \-pl-options*
گزینه‌های اضافی را برای
.BI swipl
مشخص می‌کند. اولین نویسه پس از
.BI \-pl-options
جداکننده گزینه‌ها را تعیین می‌کند. بقیه آرگومان با استفاده از این جداکننده تقسیم شده و بخش‌ها به فهرست گزینه‌ها برای پرولاگ اضافه می‌شوند. همچنین
.BI \-cc-options " و " \-ld-options
را ببینید.
.TP
.BI \-ld-options*
گزینه‌های اضافی ارسال‌شده به پیونددهنده. برای مثال:
.BI \-ld-options,-Bstatic
.TP
.BI \-cc-options*
گزینه‌های اضافی ارسال‌شده به هر دو کامپایلر C و C++.
.TP
.BI *.o
به عنوان فایل‌های ورودی به پیونددهنده ارسال می‌شوند.
.TP
.BI *.c
با استفاده از کامپایلر C کامپایل می‌شوند و پس از آن فایل شیء به پیونددهنده ارسال می‌شود. فایل شیء هنگام پاکسازی حذف می‌شود.
.TP
.BI *.cc|*.C|*.cxx|*.cpp
با استفاده از کامپایلر C++ کامپایل می‌شوند و پس از آن فایل شیء به پیونددهنده ارسال می‌شود. فایل شیء هنگام پاکسازی حذف می‌شود.
.TP
.BI *.pl|*.qlf
به عنوان فایل‌های ورودی پرولاگ ارسال می‌شوند.
.SH "اشکالات (BUGS)"
تجزیه گزینه‌ها و توزیع آن‌ها بین برنامه‌های مختلف احتمالاً ناقص است. با خیال راحت آن را تغییر دهید و لطفاً اصلاحات مفید را به
.BI bugs@swi-prolog.org
ارسال کنید.

باید دقت شود که وضعیت ایجاد شده با
.BI qsave_program/2
خودکفا باشد (یعنی حاوی هیچ ارجاعی به کتابخانه‌های پرولاگ نباشد). همچنین، از آنجا که وضعیت با استفاده از محیط توسعه به جای شبیه‌ساز کاربر ایجاد می‌شود، کد پرولاگ نمی‌تواند از دستوراتی استفاده کند که به کد C اضافه شده توسط کاربر وابسته هستند.
.SH "همچنین ببینید (SEE ALSO)"
.I swipl(1)
.I راهنمای مرجع SWI-Prolog،
.I http://www.swi-prolog.org
.SH "حق نشر (COPYRIGHT)"
حق نشر (C) 1991-2010 دانشگاه آمستردام، دانشگاه VU آمستردام
این برنامه می‌تواند تحت شرایط مجوز BSD-2 استفاده شود.
.SH "نویسنده (AUTHOR)"
Jan Wielemaker