الاسم

logrotate [--force] [--debug] [--state ملف] [--skip-state-lock] [--wait-for-state-lock] [--verbose] [--log ملف] [--mail أمر] ملف_إعداد [ملف_إعداد2 ...]

صُمم logrotate لتسهيل إدارة الأنظمة التي تُنتج أعدادًا كبيرة من ملفات السجلات. يسمح بالتدوير الآلي، والضغط، والإزالة، وإرسال ملفات السجلات عبر البريد. يمكن معالجة كل ملف سجل يوميًا، أسبوعيًا، شهريًا، أو عندما يكبر حجمه أكثر من اللازم.

عادةً، يُشغل logrotate كمهمة cron يومية. لن يُعدّل سجلًا أكثر من مرة في اليوم الواحد إلا إذا كان معيار ذلك السجل مبنيًا على حجم السجل وكان logrotate يُشغل أكثر من مرة يوميًا، أو إذا استُخدم الخيار -f أو --force.

يمكن إعطاء أي عدد من ملفات الإعداد في سطر الأوامر. قد تتجاوز ملفات الإعداد اللاحقة الخيارات المُعطاة في الملفات السابقة، لذا فإن الترتيب الذي تُدرج به ملفات إعداد logrotate مهم. عادةً، يجب استخدام ملف إعداد واحد يتضمن أي ملفات إعداد أخرى مطلوبة. انظر أدناه لمزيد من المعلومات حول كيفية استخدام توجيه include لتحقيق ذلك. إذا أُعطي دليل في سطر الأوامر، يُستخدم كل ملف في ذلك الدليل كملف إعداد.

إذا لم تُعطَ أي وسائط لسطر الأوامر، يطبع logrotate معلومات الإصدار وحقوق النشر، مع ملخص استخدام قصير. إذا حدث أي خطأ أثناء تدوير السجلات، يخرج logrotate بحالة غير صفرية، على الرغم من تحديث ملف الحالة.

-f، --force

يُخبر logrotate بإجبار التدوير، حتى لو لم يرَ ذلك ضروريًا. أحيانًا يكون هذا مفيدًا بعد إضافة إدخالات جديدة إلى ملف إعداد logrotate، أو إذا أُزيلت ملفات السجلات القديمة يدويًا، حيث ستنشأ الملفات الجديدة ويستمر التسجيل بشكل صحيح.

-d، --debug

تشغيل وضع التصحيح، مما يعني عدم إجراء أي تغييرات على السجلات وعدم تحديث ملف حالة logrotate. تُطبع رسائل التصحيح فقط.

-s, --state ملف_الحالة

يخبر logrotate باستخدام ملف حالة بديل. هذا مفيد إذا كان logrotate يُشغّل كمستخدم مختلف لمجموعات متنوعة من ملفات السجل. لمنع التنفيذ المتوازي، يكتسب logrotate مبدئياً قفلاً على ملف الحالة، وإذا تعذر اكتسابه، سيخرج logrotate بالقيمة 3. ملف الحالة المبدئي هو /var/lib/logrotate/status. إذا أعطي /dev/null كملف حالة، فلن يحاول logrotate قفل أو كتابة ملف الحالة.

--skip-state-lock

لا تقفل ملف الحالة، على سبيل المثال إذا كان القفل غير مدعوم أو محظورًا.

--wait-for-state-lock

انتظر حتى يُحرر قفل ملف الحالة بواسطة عملية logrotate أخرى. قد يتسبب هذا الخيار في انتظار logrotate إلى أجل غير مسمى. استخدم بحذر.

-v، --verbose

تشغيل وضع الإسهاب، على سبيل المثال لعرض الرسائل أثناء التدوير.

-l, --log ملف

يُخبر logrotate بتسجيل المخرجات المفصلة في ملف_السجل. المخرجات المفصلة المسجلة في ذلك الملف هي نفسها عند تشغيل logrotate مع المفتاح -v. يُستبدل ملف السجل في كل تنفيذ لـ logrotate.

-m، --mail أمر

يُخبر logrotate بالأمر الذي سيُستخدم عند إرسال السجلات بالبريد. يجب أن يقبل هذا الأمر الوسائط التالية:

1) موضوع الرسالة المُعطى مع '-s subject'
2) المستلم.

يجب على الأمر بعد ذلك قراءة رسالة من المدخل القياسي وإرسالها بالبريد إلى المستلم. أمر البريد المبدئي هو /usr/bin/mail.

--usage

يطبع رسالة استخدام قصيرة.

-؟، --help

يطبع رسالة المساعدة.

--version

اعرض معلومات الإصدار.

يقرأ logrotate كل شيء عن ملفات السجلات التي يجب أن يعالجها من سلسلة ملفات الإعدادات المُحددة في سطر الأوامر. يمكن لكل ملف إعدادات تعيين خيارات عامة (التعريفات المحلية تتجاوز العامة، والتعريفات اللاحقة تتجاوز السابقة) وتحديد ملفات سجلات لتدويرها. لا تؤثر الخيارات العامة على توجيهات التضمين السابقة. يبدو ملف إعدادات بسيط هكذا:

# sample logrotate configuration file
compress
/var/log/messages {
    rotate 5
    weekly
    postrotate
        /usr/bin/killall -HUP syslogd
    endscript
}
"/var/log/httpd/access.log" /var/log/httpd/error.log {
    rotate 5
    mail recipient@example.org
    size 100k
    sharedscripts
    postrotate
        /usr/bin/killall -HUP httpd
    endscript
}
/var/log/news/* {
    monthly
    rotate 2
    olddir /var/log/news/old
    missingok
    sharedscripts
    postrotate
        kill -HUP $(cat /var/run/inn.pid)
    endscript
    nocompress
}
~/log/*.log {}

تضبط الأسطر القليلة الأولى الخيارات العامة؛ في المثال، تُضغط السجلات بعد تدويرها. لاحظ أن التعليقات قد تظهر في أي مكان في ملف الإعدادات طالما أن أول حرف غير فراغي في السطر هو #.

تُفصل القيم عن التوجيهات بمسافات و/أو علامة = اختيارية. يجب تحديد الأرقام بتنسيق تفهمه strtoul(3).

يُعرف القسم التالي من ملف الإعدادات كيفية معالجة ملف السجل /var/log/messages. سيمر السجل بخمس دورات أسبوعية قبل إزالته. بعد تدوير ملف السجل (ولكن قبل ضغط النسخة القديمة من السجل)، يُنفذ الأمر /usr/bin/killall -HUP syslogd.

يُعرف القسم التالي المعاملات لكل من /var/log/httpd/access.log و /var/log/httpd/error.log. يُدار كل منهما كلما زاد حجمه عن 100 كيلوبايت، وتُرسل ملفات السجلات القديمة بالبريد (غير مضغوطة) إلى recipient@example.org بعد المرور بـ 5 دورات، بدلاً من إزالتها. يعني sharedscripts أن البرنامج النصي postrotate سيُشغل مرة واحدة فقط لهذا القسم، وليس مرة لكل سجل يُدار. لاحظ أن أسماء ملفات السجلات قد تُحاط بعلامات اقتباس (وأن علامات الاقتباس مطلوبة إذا كان الاسم يحتوي على مسافات). تنطبق قواعد الاقتباس العادية للقشرة، مع دعم الأحرف ' و " و \.

يُعرف القسم التالي المعاملات لجميع الملفات في /var/log/news. يُدار كل ملف على أساس شهري.

يستخدم القسم الأخير توسعة التلدة لتدوير ملفات السجلات في الدليل الرئيسي للمستخدم الحالي. هذا متاح فقط إذا كانت مكتبة glob لديك تدعم توسعة التلدة. تدعم GNU glob هذا.

يرجى استخدام أحرف البدل بحذر. إذا حددت *، فسيدير logrotate جميع الملفات، بما في ذلك تلك التي تم تدويرها سابقًا. طريقة لتجنب ذلك هي استخدام توجيه olddir أو حرف بدل أكثر دقة (مثل *.log).

يرجى الملاحظة، افتراضياً عند استخدام systemd(1)، يتم تعيين الخيار ProtectSystem=full في ملف logrotate.service. يمنع هذا logrotate من تعديل السجلات في /etc و /usr.

فيما يلي مزيد من المعلومات حول التوجيهات التي قد تُدرج في ملف تهيئة logrotate:

قد تُدرج هذه التوجيهات في ملف تهيئة logrotate:

تُنفذ الأسطر بين الكلمة المفتاحية البادئة (مثل prerotate) و endscript (يجب أن يظهر كلاهما في أسطر منفردة) (باستخدام /bin/sh). يرث النص بعض السمات من عملية logrotate، بما في ذلك stderr و stdout والدليل الحالي والبيئة و umask. تُشغّل النصوص كمستخدم ومجموعة المستدعي، بغض النظر عن أي توجيه su. إذا تم تحديد علامة --log، فإن واصف الملف 3 هو ملف السجل. دليل العمل الحالي غير محدد.

يتم حل معرفات المستخدم والمجموعة أولاً بمحاولة التمثيل النصي، وفي حالة فشله، لاحقًا بالقيمة الرقمية.

chmod(2), gunzip(1), gzip(1), mail(1), shred(1), strftime(3), strtoul(3), <https://github.com/logrotate/logrotate>

Erik Troan, Preston Brown, Jan Kaluza.
<https://github.com/logrotate/logrotate>

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.