| ros(1) | ros(1) |
Roswell - ابزار راه‌اندازی و مدیریت محیط Common Lisp
خلاصه دستور (SYNOPSIS)
- •
- ros [options] [command [args...]
- •
- ros [options] [--]script [args...]
- •
- ros [options] < script.ros
توضیحات (DESCRIPTION)
ابزار Roswell یک ابزار خط فرمانی برای نصب و مدیریت پیاده‌سازی‌های Common Lisp و همچنین یک زیرساخت اسکریپت‌نویسی برای الگوسازی، نوشتن، اجرا، کامپایل، توزیع، بارگیری و نصب ROSWELL-SCRIPTS نوشته‌شده به زبان Common Lisp است.
در حال حاضر roswell از sbcl، ccl، clisp و ecl به عنوان پیاده‌سازی‌های لیسپ پشتیبانی می‌کند. برای جزئیات بیشتر به ros-install(1) مراجعه کنید.
اسکریپت‌های نصب‌شده توسط roswell در صورتی که دایرکتوری مناسب در PATH گنجانده شده باشد، در سراسر سیستم در دسترس خواهند بود.
زیرفرمان‌ها (SUBCOMMANDS)
به ترتیب کاربرد و بسامد استفاده:
- install
- نصب یک پیاده‌سازی مشخص (مانند sbcl، ccl) یا یک سامانه (مانند alexandria) برای محیط roswell. به ros-install(1) مراجعه کنید.
- init [name[.ros]]
- ایجاد یک اسکریپت ros جدید. پسوند .ros اختیاری است و به‌طور خودکار افزوده می‌شود. به ros-init مراجعه کنید.
- dump [executable|output] [script]
- تخلیهٔ یک ایمیج از اسکریپت برای راه‌اندازی سریع‌تر یا ساخت یک فایل اجرایی. به ros-dump مراجعه کنید.
- build
- ساخت یک فایل اجرایی از روی اسکریپت. به ros-build مراجعه کنید.
- run
- شروع محیط تعاملی REPL. به ros-run مراجعه کنید.
- use
- تغییر پیاده‌سازی پیش‌فرض مورد استفاده توسط roswell. به ros-use مراجعه کنید.
- list
- فهرست کردن اطلاعات گوناگون. به ros-list مراجعه کنید.
- config
- دریافت و تنظیم گزینه‌ها. به ros-config مراجعه کنید.
- setup
- اجرای پیکربندی و راه‌اندازی اولیه. به ros-setup مراجعه کنید.
- emacs
- راه‌اندازی emacs به همراه slime. به ros-emacs مراجعه کنید.
- wait
- انتظار نامحدود؛ برای دیمن کردن (daemonize) اسکریپت استفاده می‌شود. به ros-wait مراجعه کنید.
- delete
- حذف یک پیاده‌سازی نصب‌شده. به ros-delete مراجعه کنید.
- version
- نمایش اطلاعات نسخهٔ roswell. به ros-version مراجعه کنید.
- help
- نمایش راهنمای زیرفرمان.
گزینه‌ها (OPTIONS)
گزینه‌ها به ترتیب از چپ به راست پردازش می‌شوند.
- -w CODE –wrap CODE
- اجرای اسکریپت به همراه پوستهٔ پیچنده (wrapper) CODE، مانند rlwrap
- -m IMAGE –image IMAGE
- ادامه از ایمیج لیسپ IMAGE
- -L NAME –lisp NAME
- اجرای اسکریپت با پیاده‌سازی لیسپ NAME[/VERSION] در صورت وجود، مانند sbcl-bin یا sbcl/1.2.16؛ در غیر این صورت با شکست مواجه می‌شود.
- -l FILE –load FILE
- بارگذاری فایل لیسپ FILE هنگام ساخت
- -S X –source-registry X
- بازنویسی رجیستری منبع سامانه‌های asdf.
- -s SYSTEM –system SYSTEM
- بارگذاری SYSTEM مربوط به asdf هنگام ساخت.
- –load-system SYSTEM
- مشابه بالا (برای سازگاری با buildapp)
- -p PACKAGE –package PACKAGE
- تغییر بستهٔ فعلی به PACKAGE
- -sp SP –system-package SP
- ترکیبی از -s SP و -p SP
- -e FORM –eval FORM
- ارزیابی FORM هنگام ساخت
- –require MODULE
- فراخوانی require برای MODULE هنگام ساخت
- -q –quit
- خروج از lisp در این نقطه
- -r FUNC –restart FUNC
- ایمیج ساخته‌شده پس از فراخوانی FUNC بازراه‌اندازی می‌شود
- -E FUNC –entry FUNC
- ایمیج ساخته‌شده پس از فراخوانی (FUNC argv) بازراه‌اندازی می‌شود.
- -i FORM –init FORM
- ارزیابی FORM پس از بازراه‌اندازی.
- -ip FORM –print FORM
- ارزیابی و چاپ با princ روی FORM پس از بازراه‌اندازی
- -iw FORM –write FORM
- ارزیابی و نوشتن (write) عبارت FORM پس از بازراه‌اندازی
- -F FORM –final FORM
- ارزیابی FORM پیش از تخلیهٔ IMAGE
- -R –rc
- تلاش برای خواندن /etc/rosrc و ~/.roswell/init.lisp
- +R –no-rc
- نادیده گرفتن /etc/rosrc و ~/.roswell/init.lisp
- -Q –quicklisp
- بارگذاری quicklisp (پیش‌فرض)
- +Q –no-quicklisp
- عدم بارگذاری quicklisp
- -v –verbose
- نمایش خروجی کامل و پرجزئیات هنگام ساخت
- –quiet
- قطع نمایش خروجی هنگام ساخت (پیش‌فرض)
- –test
- برای اهداف آزمایشی
- dynamic-space-size=[size in MB]
- مخصوص SBCL. این آرگومان از طریق --dynamic-space-size به SBCL ارسال می‌شود
محیط (ENVIRONMENT)
- ROSWELL_HOME
- دایرکتوری خانگی roswell را مشخص می‌کند؛ مقدار پیش‌فرض آن در پلتفرم یونیکس $HOME است.
گزارش باگ‌ها (BUGS)
فهرست مشکلات را بررسی کنید (https://github.com/roswell/roswell/issues)
همچنین ببینید (SEE ALSO)
sbcl(1) ros-dump(1) ros-init(1) ros-install(1) ros-list(1) ros-setup(1)
نویسندگان (AUTHORS)
تیم پروژهٔ Roswell.