.\" -*- 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 "SSL_COMP_ADD_COMPRESSION_METHOD 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_COMP_ADD_COMPRESSION_METHOD 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 الاسم
SSL_COMP_add_compression_method, SSL_COMP_get_compression_methods,
SSL_COMP_get0_name, SSL_COMP_get_id, SSL_COMP_free_compression_methods \&\-
معالجة طرق الضغط المدمجة في SSL/TLS
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/ssl.h>
\&
\& int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm);
\& STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void);
\& const char *SSL_COMP_get0_name(const SSL_COMP *comp);
\& int SSL_COMP_get_id(const SSL_COMP *comp);
.Ve
.PP
الدالة التالية أصبحت مهجورة منذ OpenSSL 1.1.0، ويمكن إخفاؤها تمامًا عبر
تعريف \fBOPENSSL_API_COMPAT\fP بقيمة إصدار مناسبة، انظر
\fBopenssl_user_macros\fP\|(7):
.PP
.Vb 1
\& void SSL_COMP_free_compression_methods(void);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_COMP_add_compression_method()\fP تُضيف طريقة الضغط \fBcm\fP مع المُعرّف
\fBid\fP إلى قائمة طرق الضغط المتاحة. تُحفظ هذه القائمة عالميًا لجميع عمليات
SSL داخل هذا التطبيق. لا يمكن تعيينها لكائنات SSL_CTX أو SSL محددة.
.PP
\&\fBSSL_COMP_get_compression_methods()\fP تُعيد رصة بجميع طرق الضغط المتاحة أو
NULL عند الخطأ.
.PP
\&\fBSSL_COMP_get0_name()\fP تُعيد اسم طريقة الضغط \fBcomp\fP.
.PP
\&\fBSSL_COMP_get_id()\fP تُعيد مُعرّف طريقة الضغط \fBcomp\fP.
.PP
\&\fBSSL_COMP_free_compression_methods()\fP تُحرّر أي موارد تم اكتسابها لصيانة
الجدول الداخلي لطرق الضغط.
.SH ملاحظات
.IX Header ملاحظات
يسمح معيار TLS (أو SSLv3) بدمج طرق الضغط في الاتصال. لكن RFC لـ TLS لا يُحدد
طرق الضغط أو مُعرّفاتها المقابلة، لذا لا توجد حاليًا طريقة متوافقة لدمج
الضغط مع الأقران غير المعروفين. لذلك لا يُنصح حاليًا بدمج الضغط في
التطبيقات. قد تتفق التطبيقات للاستخدام غير العام على طرق ضغط معينة. استخدام
طرق ضغط مختلفة بنفس المُعرّف سيؤدي إلى فشل الاتصال.
.PP
عميل OpenSSL الذي يتحدث بروتوكولًا يسمح بالضغط (SSLv3, TLSv1) سيرسل آليًا
قائمة جميع طرق الضغط المُفعّلة باستخدام
\&\fBSSL_COMP_add_compression_method()\fP إلى الخادم أثناء المصافحة. على عكس
آليات تعيين قائمة المُعمّيات، لا توجد طريقة متاحة لتقييد قائمة طرق الضغط لكل
اتصال على حدة.
.PP
خادم OpenSSL سيطابق المُعرّفات المدرجة من قبل العميل مع طرق الضغط الخاصة به
وسيُفعّل الضغط آليًا عند العثور على مُعرّف مطابق. لا توجد طريقة لتقييد قائمة
طرق الضغط المدعومة لكل اتصال على حدة.
.PP
إذا تم تفعيله أثناء التجميع، ستتوفر في مكتبة OpenSSL طرق الضغط التالية:
.IP \fBCOMP_zlib()\fP 4
.IX Item COMP_zlib()
.PD 0
.IP \fBCOMP_brotli()\fP 4
.IX Item COMP_brotli()
.IP \fBCOMP_brotli_oneshot()\fP 4
.IX Item COMP_brotli_oneshot()
.IP \fBCOMP_zstd()\fP 4
.IX Item COMP_zstd()
.IP \fBCOMP_zstd_oneshot()\fP 4
.IX Item COMP_zstd_oneshot()
.PD
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
\&\fBSSL_COMP_add_compression_method()\fP قد تُرجع القيم التالية:
.IP 0 4
نجحت العملية.
.IP 1 4
.IX Item 1
فشلت العملية. افحص طابور الأخطاء لمعرفة السبب.
.PP
\&\fBSSL_COMP_get_compression_methods()\fP تُرجع رصة طرق الضغط أو NULL عند
الخطأ.
.PP
\&\fBSSL_COMP_get0_name()\fP تُرجع اسم طريقة الضغط أو NULL عند الخطأ.
.PP
\&\fBSSL_COMP_get_id()\fP تُرجع اسم طريقة الضغط أو \-1 عند الخطأ.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBssl\fP\|(7)
.SH التاريخ
.IX Header التاريخ
الدالة \fBSSL_COMP_free_compression_methods()\fP أُهملت في OpenSSL 1.1.0.
الدالتان \fBSSL_COMP_get0_name()\fP و \fBSSL_comp_get_id()\fP أُضيفتا في OpenSSL
1.1.0d.
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2001\-2020 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.
.PP
مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“).  لا يجوز لك
استخدام هذا الملف إلا وفقًا لشروط الرخصة.  يمكنك الحصول على نسخة منها في
الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط
<https://www.openssl.org/source/license.html>.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .