.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .if n .ds AD l .\" .\" Required to disable full justification in groff 1.23.0. .\" ======================================================================== .\" .IX Title "TSGET 1ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TSGET 1ssl "7 أبريل 2026" 3.6.2 OpenSSL .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH الاسم tsget \- عميل ختم زمني HTTP/HTTPS .SH موجز .IX Header موجز \&\fBtsget\fP \&\fB\-h\fP \fIserver_url\fP [\fB\-e\fP \fIextension\fP] [\fB\-o\fP \fIoutput\fP] [\fB\-v\fP] [\fB\-d\fP] [\fB\-k\fP \fIprivate_key.pem\fP] [\fB\-p\fP \fIkey_password\fP] [\fB\-c\fP \fIclient_cert.pem\fP] [\fB\-C\fP \fICA_certs.pem\fP] [\fB\-P\fP \fICA_path\fP] [\fB\-r\fP \fIfiles\fP] [\fB\-g\fP \fIEGD_socket\fP] [\fIrequest\fP ...] .SH الوصف .IX Header الوصف يُستخدم هذا الأمر لإرسال طلب ختم زمني، كما هو محدد في RFC 3161، إلى خادم ختم زمني عبر HTTP أو HTTPS وتخزين استجابة الختم الزمني في ملف. لا يُستخدم لإنشاء الطلبات والتحقق من الاستجابات، بل يجب استخدام \fBopenssl\-ts\fP\|(1) لذلك. يمكن لهذا الأمر إرسال عدة طلبات إلى الخادم دون إغلاق اتصال TCP إذا تم تحديد أكثر من طلب واحد في سطر الأوامر. .PP يرسل هذا الأمر طلب HTTP التالي لكل طلب ختم زمني: .PP .Vb 7 \& POST url HTTP/1.1 \& User\-Agent: OpenTSA tsget.pl/ \& Host: : \& Pragma: no\-cache \& Content\-Type: application/timestamp\-query \& Accept: application/timestamp\-reply \& Content\-Length: length of body \& \& ...binary request specified by the user... .Ve .PP يتوقع استجابة من نوع application/timestamp\-reply، تُكتب إلى ملف دون أي تفسير. .SH الخيارات .IX Header الخيارات .IP "\fB\-h\fP \fIserver_url\fP" 4 .IX Item "\-h server_url" عنوان URL لخادم HTTP/HTTPS الذي يستمع لطلبات الختم الزمني. .IP "\fB\-e\fP \fIextension\fP" 4 .IX Item "\-e extension" إذا لم يُعط الخيار \fB\-o\fP، يحدد هذه الوسيطة امتداد ملفات الإخراج. سيكون الاسم الأساسي لملف الإخراج مماثلاً لأسماء ملفات الإدخال. الامتداد المبدئي هو \&\fI.tsr\fP. (اختياري) .IP "\fB\-o\fP \fIالمخرج\fP" 4 .IX Item "\-o مخرج" يمكن تحديد هذا الخيار فقط عند إرسال طلب واحد إلى الخادم. ستُكتب استجابة الختم الزمني إلى ملف الإخراج المُعطى. \*(Aq\-\*(Aq يعني الإخراج القياسي. في حالة طلبات الختم الزمني المتعددة أو غياب هذه الوسيطة، ستُشتق أسماء ملفات الإخراج من أسماء ملفات الإدخال ووسيطة الامتداد المبدئي أو المحدد. (اختياري) .IP \fB\-v\fP 4 .IX Item \-v يُطبع اسم الطلب الجاري معالجته على الخطأ القياسي. (اختياري) .IP \fB\-d\fP 4 .IX Item \-d يشغل الوضع المفصل لوحدة perl الأساسية WWW::Curl::Easy. يمكن رؤية رسائل تصحيح مفصلة للاتصال. (اختياري) .IP "\fB\-k\fP \fIprivate_key.pem\fP" 4 .IX Item "\-k private_key.pem" (HTTPS) في حالة الاستيثاق المستند إلى الشهادة للعميل عبر HTTPS، يجب أن يحتوي \&\fIprivate_key.pem\fP على المفتاح الخاص للمستخدم. يمكن حماية ملف المفتاح الخاص اختيارياً بعبارة مرور. يجب أيضًا تحديد الخيار \fB\-c\fP. (اختياري) .IP "\fB\-p\fP \fIkey_password\fP" 4 .IX Item "\-p key_password" (HTTPS) يحدد عبارة المرور للمفتاح الخاص المحدد بواسطة وسيطة \fB\-k\fP. إذا حُذف هذا الخيار وكان المفتاح محمياً بعبارة مرور، فسيُطلب إدخالها. (اختياري) .IP "\fB\-c\fP \fIclient_cert.pem\fP" 4 .IX Item "\-c client_cert.pem" (HTTPS) في حالة الاستيثاق المستند إلى الشهادة للعميل عبر HTTPS، يجب أن يحتوي \&\fIclient_cert.pem\fP على شهادة X.509 للمستخدم. يجب أيضًا تحديد الخيار \fB\-k\fP. إذا لم يُحدد هذا الخيار، فلن يحدث استيثاق عميل مستند إلى الشهادة. (اختياري) .IP "\fB\-C\fP \fICA_certs.pem\fP" 4 .IX Item "\-C CA_certs.pem" (HTTPS) مخزن شهادات CA الموثوقة. يجب أن تتضمن سلسلة شهادات شهادة النظير إحدى شهادات CA المحددة في هذا الملف. يجب إعطاء إما الخيار \fB\-C\fP أو الخيار \fB\-P\fP في حالة HTTPS. (اختياري) .IP "\fB\-P\fP \fICA_path\fP" 4 .IX Item "\-P CA_path" (HTTPS) المسار الذي يحتوي على شهادات CA الموثوقة للتحقق من شهادة النظير. يجب تجهيز الدليل باستخدام \fBopenssl\-rehash\fP\|(1). يجب تقديم إما الخيار \fB\-C\fP أو الخيار \fB\-P\fP في حالة HTTPS. (اختياري) .IP "\fB\-r\fP \fIfiles\fP" 4 .IX Item "\-r files" انظر "خيارات الحالة العشوائية" في \fBopenssl\fP\|(1) لمزيد من المعلومات. .IP "\fB\-g\fP \fIEGD_socket\fP" 4 .IX Item "\-g EGD_socket" اسم مقبس EGD للحصول على بيانات عشوائية منه. (اختياري) .IP "\fIrequest\fP ..." 4 .IX Item "طلب ..." قائمة الملفات التي تحتوي على طلبات الطوابع الزمنية المشفرة بتنسيق DER وفقًا لـ RFC 3161. إذا لم يتم تحديد أي طلبات، فسيتم إرسال طلب واحد فقط إلى الخادم وسيتم قراءته من الإدخال القياسي. (اختياري) .SH "متغيرات البيئة" .IX Header "متغيرات البيئة" يمكن أن يحتوي متغير البيئة \fBTSGET\fP اختياريًا على وسائط مبدئية. تتم إضافة محتوى هذا المتغير إلى قائمة وسائط سطر الأوامر. .SH أمثلة .IX Header أمثلة تفترض الأمثلة أدناه أن \fIfile1.tsq\fP و \fIfile2.tsq\fP يحتويان على طلبات طوابع زمنية صالحة، وأن tsa.opentsa.org يستمع على المنفذ 8080 لطلبات HTTP وعلى المنفذ 8443 لطلبات HTTPS، وأن خدمة TSA متاحة في المسار المطلق /tsa. .PP احصل على استجابة طابع زمني لـ \fIfile1.tsq\fP عبر HTTP، يُكتب الإخراج إلى \&\fIfile1.tsr\fP: .PP .Vb 1 \& tsget \-h http://tsa.opentsa.org:8080/tsa file1.tsq .Ve .PP احصل على استجابة طابع زمني لـ \fIfile1.tsq\fP و \fIfile2.tsq\fP عبر HTTP مع إظهار التقدم، يُكتب الإخراج إلى \fIfile1.reply\fP و \fIfile2.reply\fP على التوالي: .PP .Vb 2 \& tsget \-h http://tsa.opentsa.org:8080/tsa \-v \-e .reply \e \& file1.tsq file2.tsq .Ve .PP أنشئ طلب طابع زمني، واكتبه إلى \fIfile3.tsq\fP، وأرسله إلى الخادم واكتب الاستجابة إلى \fIfile3.tsr\fP: .PP .Vb 3 \& openssl ts \-query \-data file3.txt \-cert | tee file3.tsq \e \& | tsget \-h http://tsa.opentsa.org:8080/tsa \e \& \-o file3.tsr .Ve .PP احصل على استجابة طابع زمني لـ \fIfile1.tsq\fP عبر HTTPS بدون استيثاق العميل: .PP .Vb 2 \& tsget \-h https://tsa.opentsa.org:8443/tsa \e \& \-C cacerts.pem file1.tsq .Ve .PP احصل على استجابة طابع زمني لـ \fIfile1.tsq\fP عبر HTTPS مع استيثاق العميل القائم على الشهادة (سيطلب عبارة المرور إذا كان \fIclient_key.pem\fP محميًا): .PP .Vb 2 \& tsget \-h https://tsa.opentsa.org:8443/tsa \-C cacerts.pem \e \& \-k client_key.pem \-c client_cert.pem file1.tsq .Ve .PP يمكنك تقصير سطر الأوامر السابق إذا استخدمت متغير البيئة \fBTSGET\fP. الأوامر التالية تفعل نفس ما يفعله المثال السابق: .PP .Vb 4 \& TSGET=\*(Aq\-h https://tsa.opentsa.org:8443/tsa \-C cacerts.pem \e \& \-k client_key.pem \-c client_cert.pem\*(Aq \& export TSGET \& tsget file1.tsq .Ve .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBopenssl\fP\|(1), \&\fBopenssl\-ts\fP\|(1), WWW::Curl::Easy, .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2006\-2020 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة. .PP مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط . .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .