.\" -*- nroff -*- .TH ETCKEEPER 8 "" "" "" .SH "نام (NAME)" etckeeper \- ذخیره و نگهداری /etc در git، mercurial، bazaar یا darcs .SH "خلاصه دستور (SYNOPSIS)" .B etckeeper command [\-d directory] .SH "توضیحات (DESCRIPTION)" ابزار .B etckeeper ذخیره‌سازی و مدیریت .I /etc را در یک مخزن .BR git ، .BR mercurial ، .B bazaar یا .B darcs بر عهده دارد. به‌طور پیش‌فرض، هر یک از دستورها روی .I /etc عمل می‌کنند، اما می‌توان دایرکتوری متفاوتی را برای کار روی یک رونوشت (clone) از مخزن .I /etc که در مکان دیگری قرار دارد مشخص کرد. .SH "دستورات (COMMANDS)" .TP .B init یک مخزن .BR git ، .BR mercurial ، .B bazaar یا .B darcs را مقداردهی اولیه و راه‌اندازی می‌کند (بسته به تنظیمات سیستم کنترل نسخه در .IR /etc/etckeeper/etckeeper.conf ). به‌طور معمول این دستور یک‌بار در .I /etc هنگام آغاز استفاده از .B etckeeper روی سیستم اجرا می‌شود. همچنین می‌توان از آن برای مقداردهی اولیه یک رونوشت از مخزن .I /etc که در مکان دیگری قرار دارد استفاده کرد. .TP .B commit [message] تمام تغییرات موجود در .I /etc را در مخزن ثبت (commit) می‌کند. می‌توان یک پیام ثبت را مشخص کرد. همچنین می‌توانید برای ثبت دستی تغییرات، مستقیماً از سیستم کنترل نسخهٔ زیرین استفاده کنید. (توجه داشته باشید که .B etckeeper commit تشخیص می‌دهد که آیا کاربری از .B sudo یا .B su برای تبدیل شدن به ریشه استفاده کرده است یا خیر، و نام کاربری اصلی را در ثبت مربوطه ذخیره می‌کند.) .TP .B pre\-commit به‌عنوان یک قلاب پیش‌ثبت (pre-commit hook) فراخوانی می‌شود. این دستور فراداده‌ها را ذخیره کرده و بررسی‌های سلامت را انجام می‌دهد. .TP .B pre\-install توسط قلاب .B DPkg::Pre\-Install\-Pkgs در .BR apt ، یا توسط قلاب‌های معادل در سایر مدیر بسته‌ها فراخوانی می‌شود. این دستور امکان ثبت هرگونه تغییرات ثبت‌نشده را پیش از نصب، ارتقا و موارد مشابه بسته‌ها فراهم می‌سازد. .TP .B post\-install توسط قلاب .B DPkg::Post\-Invoke در .BR apt ، یا توسط قلاب‌های معادل در سایر مدیر بسته‌ها فراخوانی می‌شود. این دستور تغییرات ایجادشده توسط بسته‌ها را در مخزن ثبت می‌کند. (همچنین می‌توانید پس از اجرای دستی .BR dpkg ، خودتان این دستور را به‌صورت دستی فراخوانی کنید.) .TP .B unclean در صورتی که دایرکتوری حاوی تغییرات ثبت‌نشده باشد، مقدار درستی (true) را برمی‌گرداند. .TP .B update\-ignore [\-a] فایل نادیده‌گیری (ignore file) سیستم کنترل نسخه را به‌روزرسانی می‌کند. محتوای خارج از بلوک «managed by etckeeper» دست‌نخورده باقی می‌ماند. این دستور معمولاً هنگام ارتقا به نسخهٔ جدید .B etckeeper اجرا می‌شود. (سوییچ .B \-a در صورت عدم وجود بلوک «managed by etckeeper»، آن را اضافه خواهد کرد.) .TP .B vcs subcommand [options ...] می‌توانید از این دستور برای اجرای هر زیردستوری از سیستم کنترل نسخه‌ای که .B etckeeper برای استفاده از آن پیکربندی شده است استفاده کنید. این زیردستور در .I /etc اجرا خواهد شد. برای نمونه، .B "etckeeper vcs diff" دستور .B "git diff" را اجرا خواهد کرد. .TP .B uninit [\-f] این دستور داده‌ها را نابود می‌کند! این دستور معکوس دستور .B init است که اطلاعات سیستم کنترل نسخه و اطلاعات ردیابی داخلی خود .B etckeeper را از دایرکتوری حذف می‌کند. با احتیاط استفاده کنید. یک سناریوی استفاده رایج این است که ابتدا .B etckeeper uninit را اجرا کنید، سپس فایل .B etckeeper.conf را برای استفاده از یک سیستم کنترل نسخهٔ دیگر تغییر دهید و در پایان .B etckeeper init را اجرا نمایید. (سوییچ .B \-f می‌تواند برای اجبار به حذف بدون درخواست تأیید استفاده شود.) .SH "فایل‌ها (FILES)" فایل .I /etc/etckeeper/etckeeper.conf فایل پیکربندی است. .PP پوشه .I /etc/etckeeper همچنین شامل دایرکتوری‌هایی است که برنامه‌های اجرایی برای هر یک از دستورهای بالا در آن‌ها قرار دارند. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .TP .B ETCKEEPER_CONF_DIR مسیر دایرکتوری پیکربندی به‌جای مسیر پیش‌فرض .IR /etc/etckeeper . .SH "همچنین ببینید (SEE ALSO)" .I /usr/share/doc/etckeeper/README.md.gz .SH "نویسنده (AUTHOR)" Joey Hess