time(1)

الاسم
time - يحسب وقت أمر بسيط أو يعطي تقريراً عن استخدام الموارد

موجز
time [الخيار ...] الأمر [المعطى ...]

الوصف
يُشغّل الأمر time البرنامج المحدد في الأمر مع المعطيات الممررة. وعندما ينتهي الأمر، يكتب time رسالة إلى الخطأ القياسي تعطي إحصائيات التوقيت حول تشغيل هذا البرنامج. تتكون هذه الإحصائيات من (1) الوقت الحقيقي المنقضي بين الاستدعاء والإنهاء، و(2) وقت وحدة المعالجة المركزية الخاص بالمستخدم (مجموع قيم tms_utime و tms_cutime في البنية struct tms كما يعيدها times(2))، و(3) وقت وحدة المعالجة المركزية الخاص بالنظام (مجموع قيم tms_stime و tms_cstime في البنية struct tms كما يعيدها times(2)).

ملاحظة: تملك بعض الـ صدفات (مثل bash(1)) أمر time داخلياً يوفّر معلومات مشابهة حول استخدام الوقت وربما موارد أخرى. للوصول إلى الأمر الحقيقي، قد تحتاج إلى تحديد مساره الكامل (مثل /usr/bin/time).

الخيارات

-p  عند استخدام محلية POSIX، يُستخدم التنسيق التقليدي الدقيق

        "real %f\nuser %f\nsys %f\n"

    (مع أرقام بالثواني) حيث عدد المنازل العشرية في المخرجات لـ %f غير محدد ولكنه كافٍ للتعبير عن دقة نبضة الساعة، ومنزلة واحدة على الأقل.

حالة الخروج
إذا اسْتُدعي الأمر، تكون حالة الخروج هي حالة الأمر نفسه. خلاف ذلك، تكون القيمة 127 إذا تعذر العثور على الأمر، و 126 إذا عُثر عليه ولكن تعذر استدعاؤه، وقيمة أخرى غير صفرية (1-125) إذا حدث خطأ آخر.

البيئة
تُستخدم المتغيرات LANG و LC_ALL و LC_CTYPE و LC_MESSAGES و LC_NUMERIC و NLSPATH للنصوص وتنسيق المخرجات. ويُستخدم PATH للبحث عن الأمر.

إصدارة جنو (GNU)
فيما يلي وصف للإصدارة 1.7 من جنو للأمر time. بغض النظر عن اسم الأداة، تجعلها جنو تُخرج الكثير من المعلومات المفيدة، ليس فقط عن الوقت المستخدم، بل أيضًا عن موارد أخرى مثل الذاكرة، والإدخال/الإخراج (I/O) واستدعاءات IPC (حيثما توفرت). تُنسق المخرجات باستخدام سلسلة تنسيق يمكن تحديدها باستخدام الخيار -f أو متغير البيئة TIME.

سلسلة التنسيق المبدئية هي:

    %Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
    %Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

عند إعطاء الخيار -p، يُستخدم تنسيق المخرجات (المنقول):

    real %e
    user %U
    sys %S

  سلسلة التنسيق
يُفسر التنسيق بالطريقة المعتادة الشبيهة بـ printf(3). تُنسخ المحارف العادية مباشرة، وتُهرب محارف الجدولة، والسطر الجديد، والشرطة المائلة العكسية باستخدام و و \، وتُمثل علامة النسبة المئوية بـ %%، وبخلاف ذلك تشير % إلى تحويل. سيضيف البرنامج time دائماً سطراً جديداً في النهاية بنفسه. التحويلات موضحة أدناه. جميع تلك المستخدمة في tcsh(1) مدعومة.

الوقت

%E  الوقت الحقيقي المنقضي (بصيغة [ساعات:]دقائق:ثوانٍ).

%e  (غير موجود في tcsh(1).) الوقت الحقيقي المنقضي (بالثواني).

%S  إجمالي عدد ثواني وحدة المعالجة المركزية التي قضتها العملية في وضع الـ نواة.

%U  إجمالي عدد ثواني وحدة المعالجة المركزية التي قضتها العملية في وضع المستخدم.

%P  نسبة وحدة المعالجة المركزية التي حصلت عليها هذه المهمة، وتُحسب كـ (%U + %S) / %E.

الذاكرة

%M  أقصى حجم لمجموعة الإقامة للعملية خلال فترة حياتها، بالكيلوبايت.

%t  (غير موجود في tcsh(1).) متوسط حجم مجموعة الإقامة للعملية، بالكيلوبايت.

%K  متوسط إجمالي استخدام الذاكرة (بيانات+مكدس+نص) للعملية، بالكيلوبايت.

%D  متوسط حجم منطقة البيانات غير المشتركة للعملية، بالكيلوبايت.

%p  (غير موجود في tcsh(1).) متوسط حجم مساحة المكدس غير المشتركة للعملية، بالكيلوبايت.

%X  متوسط حجم مساحة النص المشتركة للعملية، بالكيلوبايت.

%Z  (غير موجود في tcsh(1).) حجم صفحة النظام، بالبايت. هذا ثابت لكل نظام، ولكنه يختلف بين الأنظمة.

%F  عدد أخطاء الصفحة الرئيسة التي حدثت أثناء تشغيل العملية. هذه هي الأخطاء التي يجب فيها قراءة الصفحة من القرص.

%R  عدد أخطاء الصفحة الثانوية، أو القابلة للاسترداد. هذه أخطاء للصفحات غير الصالحة ولكن لم تُطالب بها صفحات افتراضية أخرى بعد. وبالتالي، لا تزال البيانات في الصفحة صالحة ولكن يجب تحديث جداول النظام.

%W  عدد المرات التي أُخرجت فيها العملية من الذاكرة الرئيسة.

%c  عدد المرات التي تم فيها تبديل سياق العملية قسرياً (بسبب انتهاء الشريحة الزمنية).

%w  عدد مرات الانتظار: المرات التي تم فيها تبديل سياق البرنامج طوعاً، على سبيل المثال أثناء انتظار اكتمال عملية إدخال/إخراج.

الإدخال/الإخراج (I/O)

%I  عدد مدخلات نظام الملفات بواسطة العملية.

%O  عدد مخرجات نظام الملفات بواسطة العملية.

%r  عدد رسائل المقبس (socket) التي استلمتها العملية.

%s  عدد رسائل المقبس (socket) التي أرسلتها العملية.

%k  عدد الإشارات التي سُلّمت إلى العملية.

%C  (غير موجود في tcsh(1).) اسم الأمر ووسائط سطر الأوامر التي يتم توقيتها.

%x  (غير موجود في tcsh(1).) حالة خروج الأمر.

  خيارات جنو (GNU)

-f التنسيق، --format=التنسيق
    حدد تنسيق المخرجات، مما قد يتجاوز التنسيق المحدد في متغير البيئة TIME.

-p, --portability
    استخدم تنسيق المخرجات المنقول.

-o الملف، --output=الملف
    لا ترسل النتائج إلى stderr، ولكن استبدل محتوى الملف المحدد.

-a, --append
    (يُستخدم مع -o.) لا تستبدل المحتوى بل ألحق به.

-v, --verbose
    أعطِ مخرجات مفصلة للغاية حول كل ما يعرفه البرنامج.

-q، --quiet
    لا تبلغ عن إنهاء البرنامج غير الطبيعي (حيث يُنهى الأمر بواسطة إشارة) أو حالة الخروج غير الصفرية.

  خيارات جنو (GNU) القياسية

--help
    اطبع رسالة استخدام فى الخرج القياسى ثم اغلق بنجاح.

-V، --version
    اطبع معلومات اﻹصدارة فى الخرج القياسى, ثم اغلق بنجاح.

--  أنهِ قائمة الخيارات.

العلل
لا تُقاس جميع الموارد في جميع إصدارات UNIX، لذا قد يبلغ عن بعض القيم كصفر. الاختيار الحالي مستوحى في الغالب من البيانات التي وفرتها 4.2 أو 4.3BSD.

لم تُعرب إصدارة جنو time 1.7 بعد. وبالتالي، فهي لا تنفذ متطلبات POSIX.

اختير متغير البيئة TIME بشكل سيئ. ليس من غير المعتاد أن تستخدم أنظمة مثل autoconf(1) أو make(1) متغيرات بيئة باسم أداة لتجاوز الأداة المستخدمة. الاستخدامات مثل MORE أو TIME لخيارات البرامج (بدلاً من مسارات البرامج) تميل إلى التسبب في صعوبات.

من المؤسف أن -o يستبدل المحتوى بدلاً من الإلحاق به. (أي، كان يجب أن يكون الخيار -a هو المبدئي).

أرسل الاقتراحات وتقارير العلل لإصدارة جنو time إلى bug-time@gnu.org. يرجى تضمين إصدارة time، والتي يمكنك الحصول عليها بتشغيل

    time --version

ونظام التشغيل ومترجم C الذي استخدمته.

انظر أيضًا
bash(1)، tcsh(1)، times(2)، wait3(2)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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