8.2. متغیرهای محیطی رایج
بیشتر دستورهای Nix متغیرهای محیطی زیر را تفسیر میکنند.
متغیرهای محیطی پیکربندی
متغیرهای محیطی زیر بر نحوه بارگذاری پیکربندی Nix تأثیر میگذارند. برای جزئیات کامل، مستندات فایل پیکربندی را ببینید.
- [`NIX_CONF_DIR`](#env-NIX_CONF_DIR)
پوشه پیکربندی سیستم را بازنویسی میکند.
- [`NIX_USER_CONF_FILES`](#env-NIX_USER_CONF_FILES)
مکانهای فایل پیکربندی کاربر را بازنویسی میکند.
- [`NIX_CONFIG`](#env-NIX_CONFIG)
تنظیمات پیکربندی را بهصورت درونخطی فراهم میکند.
متغیرهای محیطی تنظیمات انبار
- [`NIX_IGNORE_SYMLINK_STORE`](#env-NIX_IGNORE_SYMLINK_STORE)
بهطور معمول، پوشه انبار Nix (معمولاً
/nix/store) اجازه ندارد شامل هیچ مؤلفه پیوند نمادینی (symlink) باشد. این کار برای جلوگیری از ساختهای «ناخالص» انجام میشود. سازندهها گاهی اوقات با حل کردن تمام مؤلفههای پیوند نمادین، مسیرها را «استانداردسازی» میکنند. بنابراین، ساختها روی ماشینهای مختلف (با تبدیل شدن/nix/storeبه مکانهای مختلف) میتوانند نتایج متفاوتی تولید کنند. این موضوع بهطور کلی مشکلی ایجاد نمیکند، مگر زمانی که ساختها روی ماشینهایی مستقر شوند که در آنها/nix/storeبه شکل متفاوتی حل میشود. اگر مطمئن هستید که چنین کاری انجام نخواهید داد، میتوانیدNIX_IGNORE_SYMLINK_STOREرا روی1تنظیم کنید.توجه داشته باشید که اگر انبار Nix را پیوند نمادین (symlink) میکنید تا بتوانید آن را روی سیستمفایلی غیر از سیستمفایل ریشه قرار دهید، در لینوکس بهتر است از نقاط اتصال
bindاستفاده کنید، به عنوان مثال:
$ mkdir /nix
$ mount -o bind /mnt/otherdisk/nix /nixبرای جزئیات، به صفحهٔ راهنمای mount 8 مراجعه کنید.
- [`NIX_STORE_DIR`](#env-NIX_STORE_DIR)
محل انبار Nix را بازنویسی میکند. در یونیکس، مقدار پیشفرض
/nix/storeاست که در زمان کامپایل توسط گزینهٔ ساختlibstore:store-dirتعیین میشود. در ویندوز، هیچ تنظیماتی در زمان کامپایل وجود ندارد؛ مقدار پیشفرض%PROGRAMDATA%\nix\storeاست که در زمان اجرا با استفاده از پوشهٔ شناختهشدهی%PROGRAMDATA%تعیین میشود.به فصل انواع انبار مراجعه کنید؛ هر انبار دارای یک تنظیمات
storeاست که برای مقدار پیشفرض خود به این مورد ارجاع میدهد. - [`NIX_LOG_DIR`](#env-NIX_LOG_DIR)
محل پوشهٔ گزارشهای Nix را بازنویسی میکند. در یونیکس، مقدار پیشفرض
/nix/var/log/nixاست که در زمان کامپایل توسط گزینهٔ ساختlog-dirتعیین میشود. در ویندوز، هیچ تنظیماتی در زمان کامپایل وجود ندارد؛ مقدار پیشفرض%PROGRAMDATA%\nix\logاست که در زمان اجرا با استفاده از پوشهٔ شناختهشدهی%PROGRAMDATA%تعیین میشود.انبار محلی، انبار دائم محلی و انبار SSH آزمایشی با سیستمفایل مونتشده دارای تنظیمات مختصبهانبار هستند که این مورد را بازنویسی میکنند.
- [`NIX_STATE_DIR`](#env-NIX_STATE_DIR)
محل پوشهٔ وضعیت Nix را بازنویسی میکند. در یونیکس، مقدار پیشفرض
${'{'}localstatedir{'}'}/nixاست که در آنlocalstatedirیک گزینهٔ ساخت در زمان کامپایل است که به طور پیشفرض/nix/varمیباشد. در ویندوز، هیچ تنظیماتی در زمان کامپایل وجود ندارد؛ مقدار پیشفرض%PROGRAMDATA%\nix\stateاست که در زمان اجرا با استفاده از پوشهٔ شناختهشدهی%PROGRAMDATA%تعیین میشود.انبار محلی، انبار دائم محلی و انبار SSH آزمایشی با سیستمفایل مونتشده دارای تنظیمات مختصبهانبار هستند که این مورد را بازنویسی میکنند.
- [`NIX_DAEMON_SOCKET_PATH`](#env-NIX_DAEMON_SOCKET_PATH)
مسیر سوکت دامنه یونیکس مورد استفاده برای ارتباط با دائم (daemon) Nix را بازنویسی میکند. به طور پیشفرض
daemon-socket/socketدر داخل پوشه وضعیت است (نگاه کنید بهNIX_STATE_DIR).برای جزئیات درباره نحوه حل مسیر سوکت، به مستندات انبار دائم محلی مراجعه کنید.
- [`TMPDIR`](#env-TMPDIR)
از پوشه مشخصشده برای ذخیره فایلهای موقت استفاده کنید. به طور خاص، این شامل پوشههای ساخت موقت میشود؛ این پوشهها میتوانند مقدار قابل توجهی از فضای دیسک را اشغال کنند. مقدار پیشفرض
/tmpاست. - [`NIX_REMOTE`](#env-NIX_REMOTE)
تنظیمات
storeرا بازنویسی میکند.
تنظیمات ارزیاب زبان Nix
- [`NIX_SHOW_STATS`](#env-NIX_SHOW_STATS)
اگر روی
1تنظیم شود، Nix برخی آمارهای ارزیابی، مانند تعداد مقادیر تخصیصیافته را چاپ خواهد کرد. - [`NIX_COUNT_CALLS`](#env-NIX_COUNT_CALLS)
اگر روی
1تنظیم شود، Nix تعداد دفعات فراخوانی توابع را در طول ارزیابی عبارت Nix چاپ خواهد کرد. این کار برای تحلیل کارایی (profiling) عبارتهای Nix شما مفید است. - [`GC_INITIAL_HEAP_SIZE`](#env-GC_INITIAL_HEAP_SIZE)
اگر Nix به گونهای پیکربندی شده باشد که از جمعکنندهی زباله Boehm استفاده کند، این متغیر اندازه اولیهٔ هیپ (heap) را بر حسب بایت تنظیم میکند. مقدار پیشفرض آن ۳۸۴ مگابایت (MiB) است. تنظیم کردن آن روی یک مقدار پایین، مصرف حافظه را کاهش میدهد، اما به دلیل سربار جمعآوری زباله (garbage collection)، زمان اجرا را افزایش خواهد داد.
- [`NIX_PATH`](#env-NIX_PATH)
فهرستی جداشده با دو نقطه (کولون) از ورودیهای مسیر جستجو که برای حل مسیرهای جستجو استفاده میشوند.
این متغیر محیطی، مقدار تنظیم پیکربندی
nix-pathرا بازنویسی میکند.میتوان آن را با استفاده از گزینهٔ
-Iگسترش داد.مثال
$ export NIX_PATH=/home/eelco/Dev:nixos-config=/etc/nixos
اگر NIX_PATH روی یک رشتهی خالی تنظیم شود، حل کردن مسیرهای جستجو همیشه با شکست مواجه خواهد شد.
مثال
$ NIX_PATH= nix-instantiate --eval '<nixpkgs>' error: file 'nixpkgs' was not found in the Nix search path (add it using $NIX_PATH or -I)
پوشههای کاربر
Nix از پیکربندی، وضعیت و کش مختص هر کاربر پشتیبانی میکند. متغیرهای محیطی زیر مکان این پوشهها را بازنشانی میکنند:
- [پوشه پیکربندی کاربر]: [
NIX_CONFIG_HOME] - پوشه وضعیت کاربر: [
NIX_STATE_HOME] - پوشه کش کاربر: [
NIX_CACHE_HOME]
هنگامی که این موارد تنظیم نشده باشند، مقادیر پیشفرض به پلتفرم بستگی دارند:
- در سیستمهای یونیکس، پوشههای پایه XDG:
$XDG_CONFIG_HOME/nix،$XDG_STATE_HOME/nix،$XDG_CACHE_HOME/nix - در ویندوز، پوشههای شناختهشده ویندوز:
%APPDATA%\nix\config،%LOCALAPPDATA%\nix\state،%LOCALAPPDATA%\nix\cache
به دلایل سازگاری با نسخههای پیشین، دستورات قدیمی Nix (مانند nix-env، nix-channel) برخلاف این پوشهها، از فایلهای نقطهای (dotfiles) در $HOME استفاده میکنند، مگر اینکه use-xdg-base-directories فعال شده باشد. دستورات جدید Nix (آزمایشی) بهطور پیشفرض از پوشههای مناسب استفاده میکنند.
هنگامی که use-xdg-base-directories فعال است، پوشه پیکربندی به شکل زیر تحلیل میشود:
- متغیر
$NIX_CONFIG_HOME، در صورتی که تعریف شده باشد - در غیر این صورت، مقدار پیشفرض پلتفرم (بهعنوانمثال
$XDG_CONFIG_HOME/nixدر یونیکس)
همین روند برای پوشههای وضعیت و کش نیز برقرار است.
متغیرهای محیطی متفرقه
- [`IN_NIX_SHELL`](#env-IN_NIX_SHELL)
نشانگری که مشخص میکند آیا محیط فعلی توسط
nix-shellراهاندازی شده است یا خیر. این متغیر میتواند مقادیرpureیاimpureداشته باشد.
پیوست: قراردادهای مخصوص سیستمعامل
این اطلاعات مختص Nix نیستند، اما در بالا به آنها ارجاع داده شده است.
یونیکس: پوشههای پایه XDG
مشخصات پوشه پایه XDG مکانهای استانداردی را برای فایلهای پیکربندی، وضعیت و کش مختص کاربر در سیستمهای یونیکس تعریف میکند.
متغیرهای محیطی زیر مورد استفاده قرار میگیرند:
- [
XDG_CONFIG_HOME] (پیشفرض~/.config) - [
XDG_STATE_HOME] (پیشفرض~/.local/state) - [
XDG_CACHE_HOME] (پیشفرض~/.cache) - [
XDG_CONFIG_DIRS] (پیشفرض/etc/xdg) — فهرستی جداشده با دونقطه از پوشههای پایه پیکربندی اضافی که پس ازXDG_CONFIG_HOMEجستجو میشوند
ویندوز: پوشههای شناختهشده
در ویندوز، پوشههای شناختهشده مکانهای استانداردی را برای دادههای برنامه در ویندوز فراهم میکنند.
پوشههای مرتبط عبارتند از:
