.\" crosstool-NG man page
.\" Copyright 2007 Yann E. MORIN
.\" Licensed under the Creative Commons BY-SA, v2.5
.\"
.\" Beautifying URLs
.mso www.tmac
.\"
.TH crosstool-NG 1 "Sun Dec  7 13:52:17 2025" "version 1.28.0" "دستورات کاربر (User Commands)"
.\"
.\"
.SH "نام (NAME)"
ct-ng, crosstool-NG \- ساخت زنجیره ابزارهای کامپایل متقاطع (cross-toolchains)
.\"
.\"
.SH "خلاصه دستور (SYNOPSIS)"
.B ct-ng ACTION
.\"
.\"
.SH "توضیحات (DESCRIPTION)"
ساخت یک زنجیره ابزار کامپایل متقاطع (cross-toolchain) می‌تواند فرآیندی بسیار دشوار باشد.
.PP
.B crosstool-NG
ساخت زنجیره ابزارهای کامپایل متقاطع را آسان می‌کند و به شما اجازه می‌دهد تا با پیکربندی اجزای گوناگون زنجیره ابزار متناسب با پردازنده مقصد، بیشترین بهره‌وری را از سیستم مقصد به دست آورید.
.\"
.\"
.SH "عملیات‌ها (ACTIONS)"
در اینجا متداول‌ترین عملیات‌ها آمده است. برای سایر عملیات‌ها، لطفاً مستندات موجود در
.I /usr/share/doc/crosstool-ng
را مشاهده کنید.
.TP
.B help
چاپ یک متن راهنمای کوتاه.
.\"
.TP
.B menuconfig
پیکربندی
.B crosstool-NG
با استفاده از منوی پیکربندی بسیار مشابه با هسته لینوکس.
.\"
.TP
.B oldconfig
اعمال گزینه‌های موجود در فایل
.I .config
فعلی و درخواست برای گزینه‌های جدیدتر در صورت وجود.
.\"
.TP
.B saveconfig
ذخیره پیکربندی جاری
.B crosstool-NG
و فایل‌های پیکربندی اجزای وابسته درون یک نمونه (sample). نمونه‌ها در زیردایرکتوری مخصوص به خود، با نامی برگرفته از چندتایی (tuple) هدف، درون زیردایرکتوری
.I samples
از دایرکتوری جاری ذخیره می‌شوند. نمونه‌ها را می‌توان بعداً با فراخوانی
.B ct-ng
همراه با تاپل هدفی که نمایندگی می‌کنند، فراخوانی کرد.
.\"
.TP
.B savedefconfig
ذخیره پیکربندی فعلی درون یک فایل mini-defconfig که تنها حاوی نمادهای کاملاً ضروری برای بازتولید پیکربندی است. فایل‌های defconfig بسیار کوچک‌تر از یک .config کامل هستند، بنابراین ارسال آن‌ها با ایمیل آسان است. از آنجا که تنها نمادهای غیرپیش‌فرض در یک defconfig حضور دارند، تشخیص مقادیر بامعنی بسیار آسان‌تر خواهد بود. همچنین استفاده از فایل‌های defconfig با نگارش‌های جدیدتر
.BR crosstool-NG
ساده است. به طور پیش‌فرض mini-defconfig درون فایلی به نام
.IR defconfig
ذخیره می‌شود، مگر اینکه متغیر
.B $DEFCONFIG
تنظیم شده باشد که در این صورت mini-defconfig در فایل ارجاع داده شده توسط
.B $DEFCONFIG
ذخیره خواهد شد.

نکته: تنها فایل
.I .config
مربوط به
.B crosstool-NG
ذخیره می‌شود. فایل‌های پیکربندی برای اجزا ذخیره
.B نمی‌شوند
برای این منظور از
.B saveconfig
استفاده کنید.
.\"
.TP
.B defconfig
پیکربندی
.B crosstool-NG
با استفاده از یک فایل mini-defconfig (که قبلاً با
.B savedefconfig
ذخیره شده یا به صورت دستی ویرایش شده است). فایل mini-defconfig پیش‌فرض از فایل
.IR defconfig
خوانده می‌شود، مگر اینکه متغیر
.B $DEFCONFIG
تنظیم شده باشد، که در این حالت از فایل ارجاع‌داده‌شده توسط
.B $DEFCONFIG
خوانده خواهد شد.
.\"
.TP
.B build
ساخت زنجیره ابزار پیکربندی‌شده.
.\"
.TP
.B clean
حذف فایل‌های تولیدشده توسط
.B crosstool-NG
برای خودش (این فایل‌ها عمدتاً باینری‌های بخش‌های پیکربندی هستند).
.\"
.TP
.B distclean
مشابه
.B clean
است، اما علاوه بر آن دایرکتوری ساخت زنجیره ابزار، فایل‌های دانلودشده و فایل پیکربندی
.I .config
را نیز حذف می‌کند. زنجیره ابزار تولیدشده و همچنین نمونه‌ها دست‌نخورده باقی می‌مانند و حذف نمی‌شوند.
.\"
.TP
.B updatetools
اسکریپت‌های
.I config.guess
و
.I config.sub
را به‌روزرسانی می‌کند. این اسکریپت‌ها توسط
.B crosstool-NG
برای استانداردسازی نام ماشین‌ها (ماشین‌های میزبان، ساخت و هدف) استفاده می‌شوند.
.\"
.SH "محیط (ENVIRONMENT)"
.TP
.B STOP, RESTART
به ترتیب متوقف کردن و شروع مجدد فرآیند ساخت، دقیقاً پیش از این مرحله. برای راه‌اندازی مجدد یک مرحله، ساخت قبلی باید حداقل تا آن مرحله یا فراتر از آن پیش رفته باشد.

فهرست مراحل با عملیات
.BR list-steps
قابل مشاهده است.
.\"
.SH "کد خروج (EXIT VALUE)"
رابط کاربری
.B ct-ng
در واقع یک اسکریپت
.BR make (1)
است. برای آگاهی از مفهوم مقادیر خروج، صفحه راهنمای
.BR make (1)
را ببینید.
.\"
.SH "امنیت (SECURITY)"
.B با کاربر ریشه (root) اجرا نکنید!
دقت زیادی برای جلوگیری از اشتباهات صورت گرفته است، اما برنامه‌ای بدون باگ وجود ندارد. در حین کارکرد عادی،
.B crosstool-NG
تمام دایرکتوری‌ها را حذف می‌کند. اگر با ریشه اجرا کنید و باگی وجود داشته باشد یا
.B crosstool-NG
را به اشتباه پیکربندی کرده باشید، دایرکتوری‌های مهمی ممکن است به طور کامل حذف شوند (مانند
.IR /usr )،
اگرچه
.B crosstool-NG
از نصب زنجیره ابزار در برخی از دایرکتوری‌های حیاتی و شناخته‌شده خودداری خواهد کرد.
.\"
.SH "نویسندگان (AUTHORS)"
Yann E. MORIN و مشارکت‌کنندگان متعدد.
.\"
.SH "همچنین ببینید (SEE ALSO)"
شما می‌توانید مستندات جامع‌تر را در
.IR "/usr/share/doc/crosstool-ng"
بیابید.

لطفاً نگاهی بیندازید به
.URL "http://www.kegel.com/crosstool" "crosstool اصلی" " اثر Daniel KEGEL"