نام (NAME)

clisp-link - پیوند دادن یک ماژول خارجی جدید به CLISP[1].

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

clisp-link [create] [module] [file...]

clisp-link [add] [source] [destination] [module...]

clisp-link [run] [source] [module...]

clisp-link [install] [module...]

توضیحات (DESCRIPTION)

این اسکریپت شل بر روی مجموعه‌های ماژول و مجموعه‌های پیوند (linking sets) در CLISP[1] عمل می‌کند:

•دستور create مجموعه‌های ماژول جدید را از فایل‌های منبع ایجاد می‌کند.

•دستور add مجموعه‌های ماژول را به یک مجموعه پیوند اضافه می‌کند تا یک مجموعه پیوند جدید ایجاد کند.

•دستور run CLISP[1] را همراه با مجموعه‌های ماژولِ اضافه‌شده اجرا می‌کند.

•فقط در CLISP[1] ساخته‌شده بدون فلگ پیکربندی --without-dynamic-modules.

دستور install مجموعه‌های ماژول جدید را برای استفاده عمومی نصب می‌کند.

گزینه‌ها (OPTIONS)

create

دستور

$ clisp-link create module file ...

یک مجموعه ماژول در دایرکتوری module ایجاد می‌کند که (از طریق پیوندهای نمادین) به فایل‌های file... اشاره دارد. انتظار می‌رود این فایل‌ها خودشان ماژول باشند.

add

دستور

$ clisp-link add source destination module ...

مجموعه پیوند موجود در پوشه source را با ماژول‌های موجود در پوشه‌های module... ترکیب کرده و یک مجموعه پیوند جدید در پوشه تازه ایجادشدهٔ destination تولید می‌کند.

run

دستور

$ clisp-link run source module ...

مجموعه پیوند موجود در پوشه source را همراه با ماژول‌های موجود در پوشه‌های module... اجرا می‌کند. مگر آن‌که CLISP[1] با گزینه پیکربندی --without-dynamic-modules ساخته شده باشد، بارگذاری با استفاده از SYS::DYNLOAD-MODULES انجام خواهد شد. در غیر این صورت - که بسیار کندتر است - یک مجموعه پیوند موقت ایجاد شده و پس از آن حذف می‌شود.

install

فقط در CLISP[1] ساخته‌شده بدون فلگ پیکربندی --without-dynamic-modules.

دستور

$ clisp-link install module ...

ماژول‌های موجود در پوشه‌های module... را در CUSTOM:*LIB-DIRECTORY* یا اگر برای کاربر قابل نوشتن نباشد (مثلاً اگر از نصب سراسری CLISP[1] در سیستم استفاده شود و کاربر دسترسی مدیریتی نداشته باشد)، در CUSTOM:*USER-LIB-DIRECTORY* نصب می‌کند.

متغیر CUSTOM:*USER-LIB-DIRECTORY* در ابتدا روی مقدار (MERGE-PATHNAMES[2] ".clisp/" (USER-HOMEDIR-PATHNAME[3])) تنظیم می‌شود (در صورتی که آن پوشه وجود داشته باشد)، و می‌توان آن را در فایل RC بازتنظیم کرد.

نکته
هرگز CUSTOM:*USER-LIB-DIRECTORY* را به CUSTOM:*LOAD-PATHS* یا زیرمجموعه هیچ عنصری از آن اضافه نکنید. برای بارگذاری ماژول‌های پویا به‌جای LOAD از REQUIRE استفاده کنید.

برای کارکرد صحیح این دستور، هر پوشه module باید شامل یک Makefile با یک هدف clisp-module-distrib باشد که با استفاده از LN فایل‌های لازم برای اجرای ماژول را به destdir توزیع کند. این علاوه بر شرط کلی وجود فایل link.sh است.

مثال‌ها (EXAMPLES)

به بخش 32.2.6، «نمونه» مراجعه کنید.

فایل‌ها (FILES)

دستور clisp-link به یک پوشه «کیت پیوند» (link kit) حاوی موارد زیر نیاز دارد:

•"modules.c"

•"clisp.h"

دستور clisp-link انتظار دارد این فایل‌ها را در زیرپوشه linkkit/ از پوشه نصب (یعنی CUSTOM:*LIB-DIRECTORY*) پیدا کند، که آن را با اجرای دستور زیر به دست می‌آورد: