.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LOGROTATE 8 3.22.0 لينكس "دليل مدير النظام" .de tq . br . ns . TP \\$1\" no doublequotes around argument! .. .\" Per groff_man(7), the TQ macro should be copied from an-ext.tmac when .\" not running under groff. That's not quite right; not all groff .\" installations include this macro. So bring it in with another name .\" unconditionally. .\" Continuation line for .TP header. .SH الاسم logrotate \(hy يدير، يضغط، ويرسل سجلات النظام عبر البريد .SH موجز \fBlogrotate\fP [\fB\-\-force\fP] [\fB\-\-debug\fP] [\fB\-\-state\fP \fIملف\fP] [\fB\-\-skip\-state\-lock\fP] [\fB\-\-wait\-for\-state\-lock\fP] [\fB\-\-verbose\fP] [\fB\-\-log\fP \fIملف\fP] [\fB\-\-mail\fP \fIأمر\fP] \fIملف_إعداد\fP [\fIملف_إعداد2 ...\fP] .SH الوصف صُمم \fBlogrotate\fP لتسهيل إدارة الأنظمة التي تُنتج أعدادًا كبيرة من ملفات السجلات. يسمح بالتدوير الآلي، والضغط، والإزالة، وإرسال ملفات السجلات عبر البريد. يمكن معالجة كل ملف سجل يوميًا، أسبوعيًا، شهريًا، أو عندما يكبر حجمه أكثر من اللازم. .P عادةً، يُشغل \fBlogrotate\fP كمهمة cron يومية. لن يُعدّل سجلًا أكثر من مرة في اليوم الواحد إلا إذا كان معيار ذلك السجل مبنيًا على حجم السجل وكان \fBlogrotate\fP يُشغل أكثر من مرة يوميًا، أو إذا استُخدم الخيار \fB\-f\fP أو \fB\-\-force\fP. .P يمكن إعطاء أي عدد من ملفات الإعداد في سطر الأوامر. قد تتجاوز ملفات الإعداد اللاحقة الخيارات المُعطاة في الملفات السابقة، لذا فإن الترتيب الذي تُدرج به ملفات إعداد \fBlogrotate\fP مهم. عادةً، يجب استخدام ملف إعداد واحد يتضمن أي ملفات إعداد أخرى مطلوبة. انظر أدناه لمزيد من المعلومات حول كيفية استخدام توجيه \fBinclude\fP لتحقيق ذلك. إذا أُعطي دليل في سطر الأوامر، يُستخدم كل ملف في ذلك الدليل كملف إعداد. .P إذا لم تُعطَ أي وسائط لسطر الأوامر، يطبع \fBlogrotate\fP معلومات الإصدار وحقوق النشر، مع ملخص استخدام قصير. إذا حدث أي خطأ أثناء تدوير السجلات، يخرج \fBlogrotate\fP بحالة غير صفرية، على الرغم من تحديث ملف الحالة. .SH الخيارات .TP \fB\-f\fP، \fB\-\-force\fP يُخبر \fBlogrotate\fP بإجبار التدوير، حتى لو لم يرَ ذلك ضروريًا. أحيانًا يكون هذا مفيدًا بعد إضافة إدخالات جديدة إلى ملف إعداد \fBlogrotate\fP، أو إذا أُزيلت ملفات السجلات القديمة يدويًا، حيث ستنشأ الملفات الجديدة ويستمر التسجيل بشكل صحيح. .TP \fB\-d\fP، \fB\-\-debug\fP تشغيل وضع التصحيح، مما يعني عدم إجراء أي تغييرات على السجلات وعدم تحديث ملف حالة \fBlogrotate\fP. تُطبع رسائل التصحيح فقط. .TP \fB\-s\fP, \fB\-\-state\fP \fIملف_الحالة\fP يُخبر \fBlogrotate\fP باستخدام ملف حالة بديل. هذا مفيد إذا كان \fBlogrotate\fP يُشغل كمستخدم مختلف لمجموعات متنوعة من ملفات السجلات. لمنع التنفيذ المتوازي، يحصل \fBlogrotate\fP افتراضيًا على قفل على ملف الحالة، وإذا تعذر الحصول عليه، يخرج \fBlogrotate\fP بقيمة 3. ملف الحالة المبدئي هو \fI/var/lib/logrotate.status\fP. إذا أُعطي \fI/dev/null\fP كملف حالة، فلن يحاول \fBlogrotate\fP قفل أو كتابة ملف الحالة. .TP \fB\-\-skip\-state\-lock\fP لا تقفل ملف الحالة، على سبيل المثال إذا كان القفل غير مدعوم أو محظورًا. .TP \fB\-\-wait\-for\-state\-lock\fP انتظر حتى يُحرر قفل ملف الحالة بواسطة عملية logrotate أخرى. قد يتسبب هذا الخيار في انتظار logrotate إلى أجل غير مسمى. استخدم بحذر. .TP \fB\-v\fP، \fB\-\-verbose\fP تشغيل وضع الإسهاب، على سبيل المثال لعرض الرسائل أثناء التدوير. .TP \fB\-l\fP, \fB\-\-log\fP \fIملف\fP يُخبر \fBlogrotate\fP بتسجيل المخرجات المفصلة في ملف_السجل. المخرجات المفصلة المسجلة في ذلك الملف هي نفسها عند تشغيل \fBlogrotate\fP مع المفتاح \fB\-v\fP. يُستبدل ملف السجل في كل تنفيذ لـ \fBlogrotate\fP. .TP \fB\-m\fP، \fB\-\-mail\fP \fIأمر\fP يُخبر \fBlogrotate\fP بالأمر الذي سيُستخدم عند إرسال السجلات بالبريد. يجب أن يقبل هذا الأمر الوسائط التالية: .IP 1) موضوع الرسالة المُعطى مع '\-s subject' .br 2) المستلم. .IP يجب على الأمر بعد ذلك قراءة رسالة من المدخل القياسي وإرسالها بالبريد إلى المستلم. أمر البريد المبدئي هو \fI/usr/bin/mail\fP. .TP \fB\-\-usage\fP يطبع رسالة استخدام قصيرة. .TP \fB\-؟\fP، \fB\-\-help\fP يطبع رسالة المساعدة. .TP \fB\-\-version\fP اعرض معلومات الإصدار. .SH "ملف الضبط" يقرأ \fBlogrotate\fP كل شيء عن ملفات السجلات التي يجب أن يعالجها من سلسلة ملفات الإعدادات المُحددة في سطر الأوامر. يمكن لكل ملف إعدادات تعيين خيارات عامة (التعريفات المحلية تتجاوز العامة، والتعريفات اللاحقة تتجاوز السابقة) وتحديد ملفات سجلات لتدويرها. لا تؤثر الخيارات العامة على توجيهات التضمين السابقة. يبدو ملف إعدادات بسيط هكذا: .nf .ta +8n # 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 {} .fi .PP تضبط الأسطر القليلة الأولى الخيارات العامة؛ في المثال، تُضغط السجلات بعد تدويرها. لاحظ أن التعليقات قد تظهر في أي مكان في ملف الإعدادات طالما أن أول حرف غير فراغي في السطر هو \fB#\fP. تُفصل القيم عن التوجيهات بمسافات و/أو علامة = اختيارية. يجب تحديد الأرقام بتنسيق تفهمه \fBstrtoul\fP(3). يُعرف القسم التالي من ملف الإعدادات كيفية معالجة ملف السجل \fI/var/log/messages\fP. سيمر السجل بخمس دورات أسبوعية قبل إزالته. بعد تدوير ملف السجل (ولكن قبل ضغط النسخة القديمة من السجل)، يُنفذ الأمر \fI/usr/bin/killall \-HUP syslogd\fP. يُعرف القسم التالي المعاملات لكل من \fI/var/log/httpd/access.log\fP و \fI/var/log/httpd/error.log\fP. يُدار كل منهما كلما زاد حجمه عن 100 كيلوبايت، وتُرسل ملفات السجلات القديمة بالبريد (غير مضغوطة) إلى recipient@\:example.org بعد المرور بـ 5 دورات، بدلاً من إزالتها. يعني \fBsharedscripts\fP أن البرنامج النصي \fBpostrotate\fP سيُشغل مرة واحدة فقط لهذا القسم، وليس مرة لكل سجل يُدار. لاحظ أن أسماء ملفات السجلات قد تُحاط بعلامات اقتباس (وأن علامات الاقتباس مطلوبة إذا كان الاسم يحتوي على مسافات). تنطبق قواعد الاقتباس العادية للقشرة، مع دعم الأحرف \fB'\fP و \fB"\fP و \fB\e\fP. يُعرف القسم التالي المعاملات لجميع الملفات في \fI/var/log/news\fP. يُدار كل ملف على أساس شهري. يستخدم القسم الأخير توسعة التلدة لتدوير ملفات السجلات في الدليل الرئيسي للمستخدم الحالي. هذا متاح فقط إذا كانت مكتبة glob لديك تدعم توسعة التلدة. تدعم GNU glob هذا. يرجى استخدام أحرف البدل بحذر. إذا حددت *، فسيدير \fBlogrotate\fP جميع الملفات، بما في ذلك تلك التي تم تدويرها سابقًا. طريقة لتجنب ذلك هي استخدام توجيه \fBolddir\fP أو حرف بدل أكثر دقة (مثل *.log). يرجى الملاحظة، افتراضياً عند استخدام \fBsystemd\fP(1)، يتم تعيين الخيار \fIProtectSystem=full\fP في ملف \fIlogrotate.service\fP. يمنع هذا \fBlogrotate\fP من تعديل السجلات في \fI/etc\fP و \fI/usr\fP. فيما يلي مزيد من المعلومات حول التوجيهات التي قد تُدرج في ملف تهيئة \fBlogrotate\fP: .SH "توجيهات ملف التهيئة" قد تُدرج هذه التوجيهات في ملف تهيئة \fBlogrotate\fP: .SS التدوير .TP \fBrotate \fP\fIcount\fP تُدور ملفات السجل \fIcount\fP مرة قبل إزالتها أو إرسالها بالبريد إلى العنوان المحدد في توجيه \fBmail\fP. إذا كان \fIcount\fP هو 0، تُزال الإصدارات القديمة بدلاً من تدويرها. إذا كان \fIcount\fP هو \-1، لا تُزال السجلات القديمة مطلقاً، إلا إذا تأثرت بـ \fBmaxage\fP (استخدم بحذر، قد يهدر الأداء ومساحة القرص). المبدئي هو 0. .TP \fBolddir \fP\fIdirectory\fP تُنقل السجلات إلى \fIdirectory\fP للتدوير. يجب أن يكون \fIdirectory\fP على نفس الجهاز المادي لملف السجل الذي يُدور، ما لم يُستخدم الخيار \fBcopy\fP أو \fBcopytruncate\fP أو \fBrenamecopy\fP. يُفترض أن \fIdirectory\fP نسبي للدليل الذي يحتوي ملف السجل ما لم يُحدد اسم مسار مطلق. عند استخدام هذا الخيار، تنتهي جميع الإصدارات القديمة من السجل في \fIdirectory\fP. قد يُلغى هذا الخيار بواسطة الخيار \fBnoolddir\fP. .TP \fBnoolddir\fP تُدور السجلات في الدليل الذي توجد فيه عادةً (يلغي هذا الخيار \fBolddir\fP). .TP \fBsu \fP\fIuser\fP \fIgroup\fP دور ملفات السجل المعينة تحت هذا المستخدم والمجموعة بدلاً من استخدام المستخدم/المجموعة المبدئي (عادةً root). يحدد \fIuser\fP المستخدم المستخدم للتدوير ويحدد \fIgroup\fP المجموعة المستخدمة للتدوير (انظر القسم \fBUSER AND GROUP\fP للتفاصيل). إذا لم يكن لدى المستخدم/المجموعة التي تحددها هنا صلاحية كافية لإنشاء ملفات بالملكية التي حددتها في توجيه \fBcreate\fP، فسيسبب خطأ. إذا كان \fBlogrotate\fP يعمل بصلاحيات root، يُوصى باستخدام توجيه \fBsu\fP لتدوير الملفات في الدلائل التي تخضع بشكل مباشر أو غير مباشر لسيطرة مستخدمين غير مميزين. .SS التكرار .TP \fBhourly\fP تُدور ملفات السجل كل ساعة. لاحظ أن \fBlogrotate\fP يُهيأ عادةً ليعمل بواسطة cron يومياً (أو بواسطة \fIlogrotate.timer\fP عند استخدام \fBsystemd\fP(1)). يجب عليك تغيير هذه التهيئة وتشغيل \fBlogrotate\fP كل ساعة لتتمكن من تدوير السجلات فعلياً كل ساعة. .TP \fBdaily\fP تُدور ملفات السجل كل يوم. .TP \fBweekly\fP [\fIweekday\fP] تُدور ملفات السجل مرة واحدة كل \fIweekday\fP، أو إذا تقدم التاريخ بمقدار 7 أيام على الأقل منذ آخر تدوير (مع تجاهل الوقت المحدد). تفسير \fIweekday\fP هو التالي: 0 يعني الأحد، 1 يعني الاثنين، \&.\|.\|.\|\&، 6 يعني السبت؛ القيمة الخاصة 7 تعني كل 7 أيام، بغض النظر عن يوم الأسبوع. المبدئي هو 0 إذا حُذفت وسيطة \fIweekday\fP. .TP \fBشهريًا\fP تُدور ملفات السجل في أول مرة يُشغل فيها \fBlogrotate\fP خلال الشهر (عادةً في اليوم الأول من الشهر). .TP \fBسنويًا\fP تُدور ملفات السجل إذا كانت السنة الحالية مختلفة عن آخر تدوير. .TP \fBsize \fP\fIsize\fP تُدور ملفات السجل فقط إذا زاد حجمها عن \fIsize\fP بايت. إذا تبع \fIsize\fP حرف \fIk\fP، يُفترض أن الحجم بالكيلوبايت. إذا استُخدم \fIM\fP، فالحجم بالميغابايت، وإذا استُخدم \fIG\fP، فالحسم بالغيغابايت. لذا \fIsize 100\fP و\fIsize 100k\fP و\fIsize 100M\fP و\fIsize 100G\fP كلها صالحة. هذا الخيار حصري مع خيارات الفترات الزمنية، ويتسبب في تدوير ملفات السجل دون اعتبار لآخر وقت تدوير، إذا حُدد بعد معايير الوقت (الخيار الأخير المُحدد له الأولوية). .SS "اختيار الملف" .TP \fBmissingok\fP إذا كان ملف السجل مفقودًا، انتقل إلى التالي دون إصدار رسالة خطأ. انظر أيضًا \fBnomissingok\fP. .TP \fBnomissingok\fP إذا لم يوجد ملف سجل، أصدر خطأ. هذا هو المبدئي. .TP \fBignoreduplicates\fP تجاهل أي تطابقات لاحقة لملف سجل. .TP \fBifempty\fP دور ملف السجل حتى لو كان فارغًا، متجاوزًا خيار \fBnotifempty\fP (\fBifempty\fP هو المبدئي). .TP \fBnotifempty\fP لا تُدِر السجل إذا كان فارغًا (هذا يتجاوز خيار \fBifempty\fP). .TP \fBminage\fP \fIcount\fP لا تُدِر السجلات التي عمرها أقل من يومًا. .TP \fBmaxage\fP \fIcount\fP إزالة سجلات التدوير الأقدم من يومًا. يتم التحقق من العمر فقط إذا كان ملف السجل سيُدور. لا يعيق \fBrotate \-1\fP الإزالة. تُرسل الملفات بالبريد إلى العنوان المُهيأ إذا تم تهيئة \fBmaillast\fP و \fBmail\fP. .TP \fBminsize\fP \fIsize\fP تُدور ملفات السجل عندما تنمو أكبر من \fIsize\fP بايت، ولكن ليس قبل الفاصل الزمني المحدد إضافيًا (\fBdaily\fP، \fBweekly\fP، \fBmonthly\fP، أو \fByearly\fP). خيار \fBsize\fP المرتبط مشابه باستثناء أنه متبادل مع خيارات الفاصل الزمني، ويتسبب في تدوير ملفات السجل دون اعتبار لآخر وقت تدوير، إذا تم تحديده بعد معايير الوقت (الخيار المحدد آخرًا يأخذ الأولوية). عند استخدام \fBminsize\fP، يُؤخذ في الاعتبار كل من حجم وطابع زمني لملف السجل. .TP \fBmaxsize\fP \fIsize\fP تُدور ملفات السجل عندما تنمو أكبر من \fIsize\fP بايت حتى قبل الفاصل الزمني المحدد إضافيًا (\fBdaily\fP، \fBweekly\fP، \fBmonthly\fP، أو \fByearly\fP). خيار \fBsize\fP المرتبط مشابه باستثناء أنه متبادل مع خيارات الفاصل الزمني، ويتسبب في تدوير ملفات السجل دون اعتبار لآخر وقت تدوير، إذا تم تحديده بعد معايير الوقت (الخيار المحدد آخرًا يأخذ الأولوية). عند استخدام \fBmaxsize\fP، يُؤخذ في الاعتبار كل من حجم وطابع زمني لملف السجل. .TP \fBtabooext\fP [+] \fIlist\fP تُغير قائمة الامتدادات المحظورة الحالية (انظر توجيه \fBinclude\fP للحصول على معلومات حول الامتدادات المحظورة). إذا سبق + قائمة الامتدادات، تُوسع قائمة الامتدادات المحظورة الحالية، وإلا تُستبدل. عند بدء التشغيل، قائمة الامتدادات المحظورة هي \fI,v\fP، \fI.bak\fP، \fI.cfsaved\fP، \fI.disabled\fP، \fI.dpkg\-bak\fP، \&\fI.dpkg\-del\fP، \fI.dpkg\-dist\fP، \fI.dpkg\-new\fP، \fI.dpkg\-old\fP، \fI.dpkg\-tmp\fP، \&\fI.new\fP، \fI.old\fP، \fI.orig\fP، \fI.rhn\-cfg\-tmp\-*\fP، \fI.rpmnew\fP، \fI.rpmorig\fP، \&\fI.rpmsave\fP، \fI.swp\fP، \fI.ucf\-dist\fP، \fI.ucf\-new\fP، \fI.ucf\-old\fP، \fI~\fP .TP \fBtaboopat\fP [+] \fIlist\fP تُغير قائمة أنماط glob المحظورة الحالية (انظر توجيه \fBinclude\fP للحصول على معلومات حول الامتدادات والأنماط المحظورة). إذا سبق + قائمة الأنماط، تُوسع قائمة الأنماط المحظورة الحالية، وإلا تُستبدل. عند بدء التشغيل، قائمة الأنماط المحظورة فارغة. .SS "الملفات والمجلدات" .TP \fBcreate \fP\fImode\fP \fIowner\fP \fIgroup\fP، \fBcreate \fP\fIowner\fP \fIgroup\fP مباشرة بعد التدوير (قبل تشغيل برنامج \fBpostrotate\fP) يُنشأ ملف السجل (بنفس اسم ملف السجل الذي دُور للتو). يحدد \fImode\fP وضع ملف السجل بالنظام الثماني (نفس \fBchmod\fP(2))، ويحدد \fIowner\fP المستخدم الذي سيمتلك ملف السجل، ويحدد \fIgroup\fP المجموعة التي سينتمي إليها ملف السجل (انظر القسم \fBUSER AND GROUP\fP للتفاصيل). يمكن حذف أي من سمات ملف السجل، وفي هذه الحالة ستستخدم تلك السمات للملف الجديد نفس قيم ملف السجل الأصلي للسمات المحذوفة. يمكن تعطيل هذا الخيار باستخدام خيار \fBnocreate\fP. .TP \fBnocreate\fP لا تُنشأ ملفات سجل جديدة (هذا يتجاوز خيار \fBcreate\fP). .TP \fBcreateolddir \fP\fImode\fP [\fIowner\fP [\fIgroup\fP]]، \fBcreateolddir \fP[\fIowner\fP [\fIgroup\fP]] إذا لم يكن الدليل المحدد بواسطة توجيه \fBolddir\fP موجودًا، يُنشأ. يحدد \fImode\fP وضع دليل \fBolddir\fP بالنظام الثماني (نفس \fBchmod\fP(2))، ويحدد \fIowner\fP المستخدم الذي سيمتلك دليل \fBolddir\fP، ويحدد \fIgroup\fP المجموعة التي سينتمي إليها دليل \fBolddir\fP (انظر القسم \fBUSER AND GROUP\fP للتفاصيل). إذا لم يُحدد \fImode\fP، يُفترض \fB0755\fP. يمكن تعطيل هذا الخيار باستخدام خيار \fBnocreateolddir\fP. .TP \fBnocreateolddir\fP لا يُنشأ دليل \fBolddir\fP بواسطة \fBlogrotate\fP عندما لا يكون موجودًا. .TP \fBcopy\fP إنشاء نسخة من ملف السجل، ولكن دون تغيير الأصل على الإطلاق. يمكن استخدام هذا الخيار، على سبيل المثال، لأخذ لقطة من ملف السجل الحالي، أو عندما تحتاج أداة أخرى إلى اقتطاع الملف أو تحليله. عند استخدام هذا الخيار، لن يكون لخيار \fBcreate\fP أي تأثير، حيث يبقى ملف السجل القديم في مكانه. يسمح خيار \fBcopy\fP بتخزين ملفات السجل المدورة على أجهزة مختلفة باستخدام توجيه \fBolddir\fP. .TP \fBnocopy\fP لا تنسخ ملف السجل الأصلي واتركه في مكانه. (هذا يتجاوز خيار \fBcopy\fP). .TP \fBcopytruncate\fP اقتطع ملف السجل الأصلي إلى حجم صفري في مكانه بعد إنشاء نسخة، بدلاً من نقل ملف السجل القديم وإنشاء ملف جديد اختيارياً. يمكن استخدامه عندما لا يمكن إخبار برنامج ما بإغلاق ملف سجله وبالتالي قد يستمر في الكتابة (الإلحاق) إلى ملف السجل السابق إلى الأبد. لاحظ أن هناك فاصل زمني صغير جداً بين نسخ الملف واقتطاعه، لذا قد تُفقد بعض بيانات التسجيل. عند استخدام هذا الخيار، لن يكون لخيار \fBcreate\fP أي تأثير، حيث يبقى ملف السجل القديم في مكانه. يسمح خيار \fBcopytruncate\fP بتخزين ملفات السجل المدورة على أجهزة مختلفة باستخدام توجيه \fBolddir\fP. يستلزم خيار \fBcopytruncate\fP الخيار \fBnorenamecopy\fP. .TP \fBnocopytruncate\fP لا تقتطع ملف السجل الأصلي في مكانه بعد إنشاء نسخة (هذا يتجاوز خيار \fBcopytruncate\fP). .TP \fBrenamecopy\fP يُعاد تسمية ملف السجل إلى اسم ملف مؤقت في نفس الدليل بإضافة الامتداد ".tmp" إليه. بعد ذلك، يُشغل نص \fBpostrotate\fP ويُنسخ ملف السجل من الاسم المؤقت إلى الاسم النهائي. في النهاية، يُحذف الاسم المؤقت. يسمح خيار \fBrenamecopy\fP بتخزين ملفات السجل المدورة على أجهزة مختلفة باستخدام توجيه \fBolddir\fP. يستلزم خيار \fBrenamecopy\fP الخيار \fBnocopytruncate\fP. .TP \fBnorenamecopy\fP لا تُعد تسمية ملف السجل الأصلي ولا تنسخه (هذا يتجاوز خيار \fBrenamecopy\fP). .TP \fBshred\fP احذف ملفات السجل باستخدام \fBshred\fP \-u بدلاً من unlink(). يجب أن يضمن هذا عدم إمكانية قراءة السجلات بعد حذفها المجدول؛ هذا معطل مبدئياً. انظر أيضاً \fBnoshred\fP. .TP \fBnoshred\fP لا تستخدم \fBshred\fP عند حذف ملفات السجل القديمة. انظر أيضاً \fBshred\fP. .TP \fBshredcycles\fP \fIcount\fP يطلب من GNU \fBshred\fP(1) الكتابة فوق ملفات السجل \fBcount\fP مرة قبل الحذف. بدون هذا الخيار، سيُستخدم المبدئي لـ \fBshred\fP. .TP \fBallowhardlink\fP دور الملفات ذات الروابط الصلبة المتعددة؛ هذا معطل مبدئياً. قد يُفرغ الملف الهدف، مثلاً باستخدام \fBshred\fP أو \fBcopytruncate\fP. استخدم بحذر، خاصة عند تدوير ملفات السجل كجذر. .TP \fBnoallowhardlink\fP لا تدور الملفات ذات الروابط الصلبة المتعددة. انظر أيضاً \fBallowhardlink\fP. .SS الضغط .TP \fBcompress\fP يتم ضغط الإصدارات القديمة من ملفات السجل باستخدام \fBgzip\fP(1) افتراضيًا. انظر أيضًا \fBnocompress\fP. .TP \fBnocompress\fP لا تُضغط الإصدارات القديمة من ملفات السجل. انظر أيضًا \fBcompress\fP. .TP \fBcompresscmd\fP يحدد الأمر المستخدم لضغط ملفات السجل. المبدئي هو \fBgzip\fP(1). انظر أيضًا \fBcompress\fP. .TP \fBuncompresscmd\fP يحدد الأمر المستخدم لفك ضغط ملفات السجل. المبدئي هو \fBgunzip\fP(1). .TP \fBcompressext\fP يحدد الامتداد المستخدم لملفات السجل المضغوطة، إذا كان الضغط مفعّلاً. يتبع المبدئي امتداد أمر الضغط المُهيأ. .TP \fBcompressoptions\fP يمكن تمرير خيارات سطر الأوامر إلى برنامج الضغط، إذا كان قيد الاستخدام. المبدئي لـ \fBgzip\fP(1) هو "\-6" (يميل نحو الضغط العالي على حساب السرعة). إذا استخدمت أمر ضغط مختلفًا، قد تحتاج إلى تغيير \fBcompressoptions\fP ليتوافق. .TP \fBdelaycompress\fP يؤجل ضغط ملف السجل السابق إلى دورة التدوير التالية. يكون لهذا تأثير فقط عند استخدامه مع \fBcompress\fP. يمكن استخدامه عندما لا يمكن إخبار برنامج ما بإغلاق ملف سجله، وبالتالي قد يستمر في الكتابة إلى ملف السجل السابق لبعض الوقت. .TP \fBnodelaycompress\fP لا يؤجل ضغط ملف السجل السابق إلى دورة التدوير التالية (يتجاوز هذا خيار \fBdelaycompress\fP). .SS "أسماء الملفات" .TP \fBextension \fP\fIext\fP يمكن لملفات السجل ذات الامتداد \fIext\fP الاحتفاظ به بعد التدوير. إذا استُخدم الضغط، يظهر امتداد الضغط (عادةً \fI.gz\fP) بعد \fIext\fP. على سبيل المثال، لديك ملف سجل باسم mylog.foo وتريد تدويره إلى mylog.1.foo.gz بدلاً من mylog.foo.1.gz. .TP \fBaddextension \fP\fIext\fP تُعطى ملفات السجل الامتداد النهائي \fIext\fP بعد التدوير. إذا كان الملف الأصلي ينتهي بالفعل بـ \fIext\fP، لا يُكرر الامتداد، بل يُنقل فقط إلى النهاية، أي أن كلاً من \fBfilename\fP و \fBfilename\fP\fIext\fP سيُدوران إلى filename.1\fIext\fP. إذا استُخدم الضغط، يظهر امتداد الضغط (عادةً \fB.gz\fP) بعد \fIext\fP. .TP \fBstart \fP\fIcount\fP هذا هو الرقم المستخدم كأساس للتدوير. على سبيل المثال، إذا حددت 0، فسيتم إنشاء السجلات بامتداد .0 عند تدويرها من ملفات السجل الأصلية. إذا حددت 9، فسيتم إنشاء ملفات السجل بامتداد .9، متجاوزة 0\(en8. ستستمر ملفات التدوير بعدد المرات المحددة بتوجيه \fBrotate\fP. .TP \fBdateext\fP أرشفة الإصدارات القديمة من ملفات السجل بإضافة امتداد تاريخ مثل YYYYMMDD بدلاً من إضافة رقم فقط. يمكن تكوين الامتداد باستخدام خياري \fBdateformat\fP و \fBdateyesterday\fP. .TP \fBnodateext\fP لا تقم بأرشفة الإصدارات القديمة من ملفات السجل بامتداد تاريخ (يتجاوز هذا خيار \fBdateext\fP). .TP \fBdateformat\fP \fIformat_string\fP حدد الامتداد لـ \fBdateext\fP باستخدام تدوين مشابه لدالة \fBstrftime\fP(3). يُسمح فقط بمحددات %Y %m %d %H %M %S %V %s و %z. القيمة المبدئية هي \-%Y%m%d باستثناء الساعة، والتي تستخدم \-%Y%m%d%H كقيمة مبدئية. لاحظ أن الحرف الفاصل بين اسم السجل والامتداد هو جزء من سلسلة تنسيق التاريخ. يجب ضبط ساعة النظام بعد 9 سبتمبر 2001 لكي يعمل %s بشكل صحيح. لاحظ أن الطوابع الزمنية الناتجة عن هذا التنسيق يجب أن تكون قابلة للترتيب معجميًا (أي أولاً السنة، ثم الشهر، ثم اليوم. على سبيل المثال 2001/12/01 مقبول، لكن 01/12/2001 غير مقبول، لأن 01/11/2002 سيتم ترتيبه أقل رغم أنه أحدث). هذا لأنه عند استخدام خيار \fBrotate\fP، يقوم \fBlogrotate\fP بترتيب جميع أسماء الملفات المدورة لمعرفة أي ملفات السجل أقدم ويجب إزالتها. .TP \fBdateyesterday\fP استخدم تاريخ الأمس بدلاً من تاريخ اليوم لإنشاء امتداد \fBdateext\fP، بحيث يحتوي ملف السجل المدور على تاريخ في اسمه مطابق للطوابع الزمنية داخله. .TP \fBdatehourago\fP استخدم الساعة الماضية بدلاً من التاريخ الحالي لإنشاء امتداد \fBdateext\fP، بحيث يحتوي ملف السجل المدور على ساعة في اسمه مطابقة للطوابع الزمنية داخله. مفيد مع التدوير \fBhourly\fP. .SS البريد .TP \fBmail \fP\fIaddress\fP عند تدوير سجل خارج الوجود، يتم إرساله بالبريد إلى \fIaddress\fP. إذا لم يتم إنشاء بريد لسجل معين، يمكن استخدام توجيه \fBnomail\fP. .TP \fBnomail\fP لا ترسل ملفات السجل القديمة بالبريد إلى أي عنوان. .TP \fBmailfirst\fP عند استخدام أمر \fBmail\fP، أرسل بالبريد الملف الذي تم تدويره للتو، بدلاً من الملف الذي على وشك الانتهاء. .TP \fBmaillast\fP عند استخدام أمر \fBmail\fP، أرسل بالبريد الملف الذي على وشك الانتهاء، بدلاً من الملف الذي تم تدويره للتو (هذا هو المبدئي). .SS "ملفات إعدادات إضافية" .TP \fBinclude \fP\fIملف_أو_دليل\fP يقرأ الملف المعطى كوسيطة كما لو كان مضمنًا سطريًا حيث يظهر توجيه \fBinclude\fP. إذا تم إعطاء دليل، تُقرأ معظم الملفات في ذلك الدليل بترتيب أبجدي قبل متابعة معالجة الملف المُضمن. الملفات الوحيدة التي يتم تجاهلها هي الملفات غير العادية (مثل الأدلة والأنابيب المسماة) والملفات التي تنتهي أسماؤها بأحد الامتدادات أو الأنماط المحظورة، كما هو محدد بواسطة توجيهات \fBtabooext\fP أو \fBtaboopat\fP، على التوالي. قد يبدأ المسار المعطى بـ \fB~/\fP لجعله نسبيًا إلى الدليل الرئيسي للمستخدم المنفذ. لأسباب أمنية، يجب ألا تكون ملفات الإعدادات قابلة للكتابة من قبل المجموعة أو العالم. .SS السكربتات .TP \fBsharedscripts\fP عادةً، تُشغّل نصوص \fBprerotate\fP و \fBpostrotate\fP لكل سجل يتم تدويره ويُمرر المسار المطلق لملف السجل كوسيطة أولى للنص. هذا يعني أن نصًا واحدًا قد يُشغّل عدة مرات لإدخالات ملف السجل التي تطابق ملفات متعددة (مثل مثال \fI/var/log/news/*\fP). إذا تم تحديد \fBsharedscripts\fP، تُشغّل النصوص مرة واحدة فقط، بغض النظر عن عدد السجلات التي تطابق النمط البدلي، ويُمرر النمط الكامل إليها. ومع ذلك، إذا لم يتطلب أي من السجلات في النمط التدوير، فلن تُشغّل النصوص على الإطلاق. إذا خرجت النصوص بخطأ (أو فشل أي سجل في التدوير)، لن تُنفذ الإجراءات المتبقية لأي سجلات. هذا الخيار يتجاوز خيار \fBnosharedscripts\fP. .TP \fBnosharedscripts\fP شغّل نصوص \fBprerotate\fP و \fBpostrotate\fP لكل ملف سجل يتم تدويره (هذا هو المبدئي، ويتجاوز خيار \fBsharedscripts\fP). يُمرر المسار المطلق لملف السجل كوسيطة أولى للنص. يُمرر المسار المطلق لملف السجل المدور النهائي كوسيطة ثانية لنص \fBpostrotate\fP. إذا خرجت النصوص بخطأ، لن تُنفذ الإجراءات المتبقية للسجل المتأثر فقط. .tq \fBfirstaction\fP .tq \ \ \ \ \fIنص\fP .tq \fBendscript\fP يُنفذ \fIالنص\fP مرة واحدة قبل تدوير جميع ملفات السجلات التي تطابق النمط البدلي، قبل تشغيل نص prerotate وفقط إذا كان سيتم تدوير سجل واحد على الأقل. قد تظهر هذه التوجيهات فقط داخل تعريف ملف سجل. يُمرر النمط الكامل للنص كوسيطة أولى. إذا خرج النص بخطأ، لا يتم إجراء أي معالجة إضافية. انظر أيضًا \fBlastaction\fP وقسم \fBSCRIPTS\fP. .tq \fBlastaction\fP .tq \ \ \ \ \fIنص\fP .tq \fBendscript\fP يُنفذ \fIالنص\fP مرة واحدة بعد تدوير جميع ملفات السجلات التي تطابق النمط البدلي، بعد تشغيل نص postrotate وفقط إذا تم تدوير سجل واحد على الأقل. قد تظهر هذه التوجيهات فقط داخل تعريف ملف سجل. يُمرر النمط الكامل للنص كوسيطة أولى. إذا خرج النص بخطأ، يتم عرض رسالة خطأ فقط (لأن هذا هو الإجراء الأخير). انظر أيضًا \fBfirstaction\fP وقسم \fBSCRIPTS\fP. .tq \fBprerotate\fP .tq \ \ \ \ \fIنص\fP .tq \fBendscript\fP يُنفذ \fIالنص\fP قبل تدوير ملف السجل وسجلاته القديمة وفقط إذا كان السجل سيتم تدويره بالفعل. قد تظهر هذه التوجيهات فقط داخل تعريف ملف سجل. عادةً، يُمرر المسار المطلق لملف السجل كوسيطة أولى للنص. إذا تم تحديد \fBsharedscripts\fP، يُمرر النمط الكامل للنص. انظر أيضًا \fBpostrotate\fP وقسم \fBSCRIPTS\fP. انظر \fBsharedscripts\fP و \fBnosharedscripts\fP لمعالجة الأخطاء. .tq \fBpostrotate\fP .tq \ \ \ \ \fIنص\fP .tq \fBendscript\fP يُنفذ \fIالنص\fP بعد تدوير ملف السجل وقبل ضغط ملف السجل. قد تظهر هذه التوجيهات فقط داخل تعريف ملف سجل. عادةً، يُمرر المسار المطلق لملف السجل كوسيطة أولى للنص ويُمرر المسار المطلق لملف السجل المدور النهائي كوسيطة ثانية للنص. إذا تم تحديد \fBsharedscripts\fP، يُمرر النمط الكامل كوسيطة أولى للنص، ويتم حذف الوسيطة الثانية. انظر أيضًا \fBprerotate\fP وقسم \fBSCRIPTS\fP. انظر \fBsharedscripts\fP و \fBnosharedscripts\fP لمعالجة الأخطاء. .tq \fBpreremove\fP .tq \ \ \ \ \fIنص\fP .tq \fBendscript\fP يُنفذ \fIالنص\fP مرة واحدة قبل إزالة ملف سجل مباشرةً. يمرر \fBlogrotate\fP اسم الملف الذي سيتم إزالته قريبًا كوسيطة أولى للنص. انظر أيضًا \fBfirstaction\fP وقسم \fBSCRIPTS\fP. .SH سكربتات تُنفذ الأسطر بين الكلمة المفتاحية البادئة (مثل \fBprerotate\fP) و \fBendscript\fP (يجب أن يظهر كلاهما في أسطر منفردة) (باستخدام \fB/bin/sh\fP). يرث النص بعض السمات من عملية \fBlogrotate\fP، بما في ذلك stderr و stdout والدليل الحالي والبيئة و umask. تُشغّل النصوص كمستخدم ومجموعة المستدعي، بغض النظر عن أي توجيه \fBsu\fP. إذا تم تحديد علامة \fB\-\-log\fP، فإن واصف الملف 3 هو ملف السجل. دليل العمل الحالي غير محدد. .SH "المستخدم والمجموعة" يتم حل معرفات المستخدم والمجموعة أولاً بمحاولة التمثيل النصي، وفي حالة فشله، لاحقاً بالقيمة الرقمية. .SH الملفات .TS tab(:); l l l. \fI/var/lib/logrotate.status\fP:ملف الحالة المبدئي. \fI/etc/logrotate.conf\fP:خيارات التهيئة. .TE .SH "انظر أيضًا" \fBchmod\fP(2), \fBgunzip\fP(1), \fBgzip\fP(1), \fBmail\fP(1), \fBshred\fP(1), \fBstrftime\fP(3), \fBstrtoul\fP(3), .SH المؤلفون .nf Erik Troan, Preston Brown, Jan Kaluza. .fi .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .