.\" -*- 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 "OPENSSL_VERSION 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH OPENSSL_VERSION 3ssl "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 الاسم OPENSSL_VERSION_MAJOR, OPENSSL_VERSION_MINOR, OPENSSL_VERSION_PATCH, OPENSSL_VERSION_PRE_RELEASE, OPENSSL_VERSION_BUILD_METADATA, OPENSSL_VERSION_TEXT, OPENSSL_VERSION_PREREQ, OPENSSL_version_major, OPENSSL_version_minor, OPENSSL_version_patch, OPENSSL_version_pre_release, OPENSSL_version_build_metadata, OpenSSL_version, OPENSSL_VERSION_NUMBER, OpenSSL_version_num, OPENSSL_info \&\- احصل على رقم إصدار OpenSSL ومعلومات أخرى .SH موجز .IX Header موجز .Vb 1 \& #include \& \& #define OPENSSL_VERSION_MAJOR x \& #define OPENSSL_VERSION_MINOR y \& #define OPENSSL_VERSION_PATCH z \& \& /* The definitions here are typical release values */ \& #define OPENSSL_VERSION_PRE_RELEASE "" \& #define OPENSSL_VERSION_BUILD_METADATA "" \& \& #define OPENSSL_VERSION_TEXT "OpenSSL x.y.z xx XXX xxxx" \& \& #define OPENSSL_VERSION_PREREQ(maj,min) \& \& #include \& \& unsigned int OPENSSL_version_major(void); \& unsigned int OPENSSL_version_minor(void); \& unsigned int OPENSSL_version_patch(void); \& const char *OPENSSL_version_pre_release(void); \& const char *OPENSSL_version_build_metadata(void); \& \& const char *OpenSSL_version(int t); \& \& const char *OPENSSL_info(int t); \& \& /* from openssl/opensslv.h */ \& #define OPENSSL_VERSION_NUMBER 0xnnnnnnnnL \& \& /* from openssl/crypto.h */ \& unsigned long OpenSSL_version_num(); .Ve .SH الوصف .IX Header الوصف .SS ماكرو .IX Subsection ماكرو تمثل وحدات الماكرو الثلاث \fBOPENSSL_VERSION_MAJOR\fP و \fBOPENSSL_VERSION_MINOR\fP و \&\fBOPENSSL_VERSION_PATCH\fP الأجزاء الثلاثة لمعرّف الإصدار، \f(BIMAJOR\fB.\fP\f(BIMINOR\fB.\fP\f(BIPATCH\fR. .PP ماكرو \fBOPENSSL_VERSION_PRE_RELEASE\fP هو جزء نصي مضاف يشير إلى أن هذا إصدار ما قبل الإصدار النهائي، مثل \f(CW"\-dev"\fP للقطة تطويرية جارية أو \f(CW"\-alpha3"\fP لإصدار ألفا. يجب أن تكون القيمة سلسلة محارف. .PP ماكرو \fBOPENSSL_VERSION_BUILD_METADATA\fP هو معلومات إضافية، محجوزة لأطراف أخرى، مثل \f(CW"+fips"\fP أو \f(CW"+vendor.1"\fP). لن يلمس مشروع OpenSSL هذا الماكرو (سيتركه سلسلة محارف فارغة). يجب أن تكون القيمة سلسلة محارف. .PP \&\fBOPENSSL_VERSION_STR\fP هو ماكرو ملائم للحصول على سلسلة محارف معرّف الإصدار القصير، \f(CW"\fP\f(CIMAJOR\f(CW.\fP\f(CIMINOR\f(CW.\fP\f(CIPATCH\f(CW"\fP. .PP \&\fBOPENSSL_FULL_VERSION_STR\fP هو ماكرو ملائم للحصول على سلسلة محارف معرّف الإصدار الأطول، والتي تجمع \fBOPENSSL_VERSION_STR\fP و \&\fBOPENSSL_VERSION_PRE_RELEASE\fP و \fBOPENSSL_VERSION_BUILD_METADATA\fP. .PP \&\fBOPENSSL_VERSION_TEXT\fP هو ماكرو ملائم للحصول على نص إصدار وصفي كامل، والذي يتضمن \fBOPENSSL_FULL_VERSION_STR\fP وتاريخ الإصدار. .PP \&\fBOPENSSL_VERSION_PREREQ\fP هو ماكرو مفيد للتحقق مما إذا كان إصدار OpenSSL للترويسات المستخدمة على الأقل عند رقم رئيسي (\fBmaj\fP) وفرعي (\fBmin\fP) معطى مسبقًا أم لا. سيقيم إلى صحيح إذا كان رقم إصدار الترويسة (\fBOPENSSL_VERSION_MAJOR\fP.\fBOPENSSL_VERSION_MINOR\fP) أكبر من أو يساوي \fBmaj\fP.\fBmin\fP. .PP \&\fBOPENSSL_VERSION_NUMBER\fP هو مزيج من الإصدار الرئيسي والفرعي والتصحيحي في عدد صحيح واحد 0xMNN00PP0L، حيث: .IP M 4 .IX Item M هو الرقم من \fBOPENSSL_VERSION_MAJOR\fP، بالتدوين السداسي عشري .IP NN 4 .IX Item NN هو الرقم من \fBOPENSSL_VERSION_MINOR\fP، بالتدوين السداسي عشري .IP PP 4 .IX Item PP هو الرقم من \fBOPENSSL_VERSION_PATCH\fP، بالترميز الست عشري .SS دوال .IX Subsection دوال \&\fBOPENSSL_version_major()\fP و \fBOPENSSL_version_minor()\fP و \fBOPENSSL_version_patch()\fP و \&\fBOPENSSL_version_pre_release()\fP و \fBOPENSSL_version_build_metadata()\fP تُرجع قيم الكليّات المذكورة أعلاه لبناء المكتبة، على التوالي. .PP \&\fBOpenSSL_version()\fP تُرجع سلاسل محارف مختلفة اعتمادًا على \fIt\fP: .IP OPENSSL_VERSION 4 .IX Item OPENSSL_VERSION قيمة \fBOPENSSL_VERSION_TEXT\fP .IP OPENSSL_VERSION_STRING 4 .IX Item OPENSSL_VERSION_STRING قيمة \fBOPENSSL_VERSION_STR\fP .IP OPENSSL_FULL_VERSION_STRING 4 .IX Item OPENSSL_FULL_VERSION_STRING قيمة \fBOPENSSL_FULL_VERSION_STR\fP .IP OPENSSL_CFLAGS 4 .IX Item OPENSSL_CFLAGS أعلام المترجم المُعيّنة لعملية التجميع بالصيغة \&\f(CW\*(C`compiler: ...\*(C'\fP إن وُجدت، أو \f(CW\*(C`compiler: information not available\*(C'\fP بخلاف ذلك. .IP OPENSSL_BUILT_ON 4 .IX Item OPENSSL_BUILT_ON تاريخ عملية البناء بالصيغة \f(CW\*(C`built on: ...\*(C'\fP إن وُجد أو \f(CW\*(C`built on: date not available\*(C'\fP بخلاف ذلك. التاريخ لن يكون متاحًا في بناء قابل للتكرار، على سبيل المثال. .IP OPENSSL_PLATFORM 4 .IX Item OPENSSL_PLATFORM هدف "Configure" لبناء المكتبة بالصيغة \f(CW\*(C`platform: ...\*(C'\fP إن وُجد، أو \f(CW\*(C`platform: information not available\*(C'\fP بخلاف ذلك. .IP OPENSSL_DIR 4 .IX Item OPENSSL_DIR إعداد \fBOPENSSLDIR\fP لبناء المكتبة بالصيغة \f(CW\*(C`OPENSSLDIR: "..."\*(C'\fP إن وُجد، أو \f(CW\*(C`OPENSSLDIR: N/A\*(C'\fP بخلاف ذلك. .IP OPENSSL_ENGINES_DIR 4 .IX Item OPENSSL_ENGINES_DIR إعداد \fBENGINESDIR\fP لبناء المكتبة بالصيغة \f(CW\*(C`ENGINESDIR: "..."\*(C'\fP إن وُجد، أو \f(CW\*(C`ENGINESDIR: N/A\*(C'\fP بخلاف ذلك. هذا الخيار مُهمَل في OpenSSL 3.0. .IP OPENSSL_MODULES_DIR 4 .IX Item OPENSSL_MODULES_DIR إعداد \fBMODULESDIR\fP لبناء المكتبة بالصيغة \f(CW\*(C`MODULESDIR: "..."\*(C'\fP إن وُجد، أو \f(CW\*(C`MODULESDIR: N/A\*(C'\fP بخلاف ذلك. .IP OPENSSL_CPU_INFO 4 .IX Item OPENSSL_CPU_INFO إعدادات وحدة المعالجة المركزية الحالية لـ OpenSSL. هذا هو الإعداد الحالي لأعلام قدرة وحدة المعالجة المركزية. عادة ما يُهيأ آليًا ولكن قد يُضبط عبر متغير بيئة. للقيمة نفس صياغة متغير البيئة. بالنسبة لـ x86، تبدو السلسلة المحارف كـ \f(CW\*(C`CPUINFO: OPENSSL_ia32cap=0x123:0x456\*(C'\fP أو \f(CW\*(C`CPUINFO: N/A\*(C'\fP إذا لم تكن متاحة. .IP OPENSSL_WINCTX 4 .IX Item OPENSSL_WINCTX سياق تثبيت ويندوز. يُستخدم سياق تثبيت ويندوز لحساب اسم مفتاح السجل لـ OpenSSL على ويندوز. مفتاح السجل الكامل هو \&\f(CW\*(C`SOFTWARE\eWOW6432Node\eOpenSSL\-{major}.{minor}\-{context}\*(C'\fP، حيث \f(CW\*(C`{major}\*(C'\fP و \&\f(CW\*(C`{minor}\*(C'\fP و \f(CW\*(C`{context}\*(C'\fP هي رقم الإصدار الرئيسي ورقم الإصدار الثانوي وسياق تثبيت ويندوز لـ OpenSSL، على التوالي. .PP بالنسبة لـ \fIt\fP غير معروف، يُعاد النص \f(CW\*(C`not available\*(C'\fP. .PP \&\fBOPENSSL_info()\fP تُعيد أيضًا سلاسل محارف مختلفة اعتمادًا على \fIt\fP: .IP OPENSSL_INFO_CONFIG_DIR 4 .IX Item OPENSSL_INFO_CONFIG_DIR \f(CW\*(C`OPENSSLDIR\*(C'\fP المُهيأ، وهو الموقع المبدئي لملفات إعدادات OpenSSL. .IP OPENSSL_INFO_ENGINES_DIR 4 .IX Item OPENSSL_INFO_ENGINES_DIR \f(CW\*(C`ENGINESDIR\*(C'\fP المُهيأ، وهو الموقع المبدئي لمحركات OpenSSL. .IP OPENSSL_INFO_MODULES_DIR 4 .IX Item OPENSSL_INFO_MODULES_DIR \f(CW\*(C`MODULESDIR\*(C'\fP المُهيأ، وهو الموقع المبدئي لوحدات OpenSSL القابلة للتحميل ديناميكيًا بخلاف المحركات. .IP OPENSSL_INFO_DSO_EXTENSION 4 .IX Item OPENSSL_INFO_DSO_EXTENSION امتداد الوحدة القابلة للتحميل ديناميكيًا المُهيأ. .IP OPENSSL_INFO_DIR_FILENAME_SEPARATOR 4 .IX Item OPENSSL_INFO_DIR_FILENAME_SEPARATOR الفاصل بين مواصفات الدليل واسم الملف. لاحظ أنه على بعض أنظمة التشغيل، هذا ليس نفس الفاصل بين عناصر الدليل. .IP OPENSSL_INFO_LIST_SEPARATOR 4 .IX Item OPENSSL_INFO_LIST_SEPARATOR فاصل قائمة OpenSSL. يُستخدم عادة في سلاسل المحارف التي هي قوائم عناصر، مثل قيمة متغير البيئة \f(CW$PATH\fP على Unix (حيث الفاصل هو \f(CW\*(C`:\*(C'\fP) أو \f(CW\*(C`%PATH%\*(C'\fP على ويندوز (حيث الفاصل هو \&\f(CW\*(C`;\*(C'\fP). .IP OPENSSL_INFO_CPU_SETTINGS 4 .IX Item OPENSSL_INFO_CPU_SETTINGS إعدادات وحدة المعالجة المركزية الحالية لـ OpenSSL. هذا هو الإعداد الحالي لأعلام قدرة وحدة المعالجة المركزية. عادة ما يُهيأ آليًا ولكن قد يُضبط عبر متغير بيئة. للقيمة نفس صياغة متغير البيئة. بالنسبة لـ x86، تبدو السلسلة المحارف كـ \f(CW\*(C`OPENSSL_ia32cap=0x123:0x456\*(C'\fP. .IP OPENSSL_INFO_WINDOWS_CONTEXT 4 .IX Item OPENSSL_INFO_WINDOWS_CONTEXT سياق تثبيت ويندوز. يُستخدم سياق تثبيت ويندوز لحساب اسم مفتاح السجل لـ OpenSSL على ويندوز. مفتاح السجل الكامل هو \&\f(CW\*(C`SOFTWARE\eWOW6432Node\eOpenSSL\-{major}.{minor}\-{context}\*(C'\fP، حيث \f(CW\*(C`{major}\*(C'\fP و \&\f(CW\*(C`{minor}\*(C'\fP و \f(CW\*(C`{context}\*(C'\fP هي رقم الإصدار الرئيسي ورقم الإصدار الثانوي وسياق تثبيت ويندوز لـ OpenSSL، على التوالي. .PP بالنسبة لـ \fIt\fP غير معروف، يُعاد NULL. .PP \&\fBOpenSSL_version_num()\fP تُعيد قيمة \fBOPENSSL_VERSION_NUMBER\fP. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" \&\fBOPENSSL_version_major()\fP و \fBOPENSSL_version_minor()\fP و \fBOPENSSL_version_patch()\fP تُعيد أجزاء رقم الإصدار كأعداد صحيحة. .PP \&\fBOPENSSL_version_pre_release()\fP و \fBOPENSSL_version_build_metadata()\fP تُعيد قيم \fBOPENSSL_VERSION_PRE_RELEASE\fP و \&\fBOPENSSL_VERSION_BUILD_METADATA\fP على التوالي كسلاسل محارف ثابتة. بالنسبة لأي منهما غير مُعرَّف، تُعاد السلسلة الفارغة. .PP \&\fBOpenSSL_version()\fP تُعيد سلاسل محارف ثابتة. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBcrypto\fP\|(7) .SH التاريخ .IX Header التاريخ الماكرو والدوال الموصوفة هنا أُضيفت في OpenSSL 3.0، باستثناء OPENSSL_VERSION_NUMBER و \fBOpenSSL_version_num()\fP. .SH العلل .IX Header العلل كان هناك تباين بين هذا الدليل والتعليق + الكود في \fI\fP، حيث اقترح الأخير أن الأربع بتات الأقل أهمية من \fBOPENSSL_VERSION_NUMBER\fP قد تكون \&\f(CW0x0f\fP في إصدارات OpenSSL المُصدَرة. .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2018\-2025 مؤلفو مشروع 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 .