Ipv6

تتضمن هذه الوحدة الدوال التي تتحكم في اتصال IPv6.

ملخّص

التعدادات

anonymous enum{
  OT_IP6_PROTO_HOP_OPTS = 0,
  OT_IP6_PROTO_TCP = 6,
  OT_IP6_PROTO_UDP = 17,
  OT_IP6_PROTO_IP6 = 41,
  OT_IP6_PROTO_ROUTING = 43,
  OT_IP6_PROTO_FRAGMENT = 44,
  OT_IP6_PROTO_ICMP6 = 58,
  OT_IP6_PROTO_NONE = 59,
  OT_IP6_PROTO_DST_OPTS = 60
}
تعداد
أرقام بروتوكول الإنترنت
anonymous enum{
  OT_ADDRESS_ORIGIN_THREAD = 0,
  OT_ADDRESS_ORIGIN_SLAAC = 1,
  OT_ADDRESS_ORIGIN_DHCPV6 = 2,
  OT_ADDRESS_ORIGIN_MANUAL = 3
}
تعداد
أصول عنوان IPv6
anonymous enum{
  OT_ECN_NOT_CAPABLE = 0x0,
  OT_ECN_CAPABLE_0 = 0x2,
  OT_ECN_CAPABLE_1 = 0x1,
  OT_ECN_MARKED = 0x3
}
تعداد
حالات ECN، كما هو موضَّح في عنوان IP

أنواع المحددات

otBorderRoutingCounters typedef
يقدم عدادات حِزم البيانات المُعاد توجيهها من خلال توجيه الحدود.
otIp6Address typedef
struct otIp6Address
يمثّل عنوان IPv6.
otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند إضافة عنوان IPv6 داخلي أو إزالته.
otIp6AddressComponents typedef
يمثل مكوّنات عنوان IPv6.
otIp6AddressInfo typedef
otIp6InterfaceIdentifier typedef
يمثل معرّف الواجهة لعنوان IPv6.
otIp6NetworkPrefix typedef
تمثل بادئة الشبكة لعنوان IPv6 (أهم 64 بت من العنوان).
otIp6Prefix typedef
struct otIp6Prefix
تمثل بادئة IPv6.
otIp6ReceiveCallback)(otMessage *aMessage, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند استلام مخطط بيانات IPv6.
otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum) typedef
void(*
يتم طلب المؤشر مع نتائج otIp6RegisterMulticastListeners.
otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix) typedef
bool(*
يسمح المؤشر للمستخدم بفلترة البادئات وعدم السماح بإضافة عنوان SLAAC بناءً على بادئة.
otMessageInfo typedef
struct otMessageInfo
تمثل عناوين المقبس IPv6 المحلي والمقارب.
otNetifAddress typedef
يمثّل عنوان أحادي البث لواجهة واجهة IPv6.
otNetifMulticastAddress typedef
يمثّل عنوان بث متعدد لواجهة واجهة IPv6.
otPacketsAndBytes typedef
تمثل العدادات لحِزم البيانات والبايت.
otSockAddr typedef
struct otSockAddr
يمثّل عنوان مقبس IPv6.

المتغيّرات

OT_TOOL_PACKED_END

الدوال

otIp6AddUnicastAddress(otInstance *aInstance, const otNetifAddress *aAddress)
لإضافة عنوان واجهة شبكة إلى واجهة سلسلة المحادثات.
otIp6AddUnsecurePort(otInstance *aInstance, uint16_t aPort)
إضافة منفذ إلى قائمة المنافذ غير الآمنة المسموح بها
otIp6AddressFromString(const char *aString, otIp6Address *aAddress)
تحوِّل سلسلة عنوان IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.
otIp6AddressToString(const otIp6Address *aAddress, char *aBuffer, uint16_t aSize)
void
تحوِّل عنوان IPv6 معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.
otIp6ArePrefixesEqual(const otIp6Prefix *aFirst, const otIp6Prefix *aSecond)
bool
اختبِر ما إذا كانت بادئتان IPv6 متطابقتَين.
otIp6GetBorderRoutingCounters(otInstance *aInstance)
للحصول على عدّادات توجيه الحدود.
otIp6GetMulticastAddresses(otInstance *aInstance)
للحصول على قائمة بعناوين البث المتعدد IPv6 المُشترَكة في واجهة Thread
otIp6GetPrefix(const otIp6Address *aAddress, uint8_t aLength, otIp6Prefix *aPrefix)
void
الحصول على بادئة باستخدام aLength من aAddress
otIp6GetUnicastAddresses(otInstance *aInstance)
const otNetifAddress *
الحصول على قائمة بعناوين IPv6 المخصّصة لواجهة Thread.
otIp6GetUnsecurePorts(otInstance *aInstance, uint8_t *aNumEntries)
const uint16_t *
عرض مؤشر إلى قائمة المنافذ غير الآمنة
otIp6IsAddressEqual(const otIp6Address *aFirst, const otIp6Address *aSecond)
bool
اختبِر ما إذا كان هناك عنوانا IPv6 متطابقان.
otIp6IsAddressUnspecified(const otIp6Address *aAddress)
bool
يشير إلى ما إذا كان عنوان IPv6 معيّنًا هو العنوان غير المحدّد.
otIp6IsEnabled(otInstance *aInstance)
bool
يشير هذا الحقل إلى ما إذا كانت واجهة IPv6 مفعّلة أم لا.
otIp6IsMulticastPromiscuousEnabled(otInstance *aInstance)
bool
يتحقّق مما إذا كان قد تم تفعيل وضع الإرسال المتعدد في واجهة Thread.
otIp6IsReceiveFilterEnabled(otInstance *aInstance)
bool
يشير هذا الحقل إلى ما إذا كان تتم فلترة زيارات التحكّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر معاودة الاتصال المحدّدة في otIp6SetSetCallback().
otIp6IsSlaacEnabled(otInstance *aInstance)
bool
يشير إلى ما إذا كانت وحدة "اتفاقية مستوى الخدمة" (SLAAC) مفعَّلة أم لا.
otIp6NewMessage(otInstance *aInstance, const otMessageSettings *aSettings)
خصِّص ذاكرة تخزين مؤقت جديدة للرسائل لإرسال رسالة IPv6.
otIp6NewMessageFromBuffer(otInstance *aInstance, const uint8_t *aData, uint16_t aDataLength, const otMessageSettings *aSettings)
خصِّص المخزن المؤقت الجديد للرسائل واكتب مخطط بيانات IPv6 إلى المخزن المؤقت للرسائل لإرسال رسالة IPv6.
otIp6PrefixFromString(const char *aString, otIp6Prefix *aPrefix)
تحوِّل سلسلة بادئة IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.
otIp6PrefixMatch(const otIp6Address *aFirst, const otIp6Address *aSecond)
uint8_t
عرض طول مطابقة البادئة (بوحدة البت) لعنوانَي IPv6.
otIp6PrefixToString(const otIp6Prefix *aPrefix, char *aBuffer, uint16_t aSize)
void
تحوِّل بادئة IPv6 معيّنة إلى سلسلة يمكن للمستخدمين قراءتها.
otIp6ProtoToString(uint8_t aIpProto)
const char *
تحوِّل رقم بروتوكول IP معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.
otIp6RegisterMulticastListeners(otInstance *aInstance, const otIp6Address *aAddresses, uint8_t aAddressNum, const uint32_t *aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void *aContext)
تسجِّل مستمعي البث المتعدد في جهاز التوجيه الأساسي الأساسي.
otIp6RemoveAllUnsecurePorts(otInstance *aInstance)
void
تتم إزالة جميع المنافذ من قائمة المنافذ غير الآمنة المسموح بها.
otIp6RemoveUnicastAddress(otInstance *aInstance, const otIp6Address *aAddress)
إزالة عنوان واجهة الشبكة من واجهة Thread
otIp6RemoveUnsecurePort(otInstance *aInstance, uint16_t aPort)
تتم إزالة منفذ من قائمة المنافذ غير الآمنة المسموح بها.
otIp6ResetBorderRoutingCounters(otInstance *aInstance)
void
يؤدي هذا الخيار إلى إعادة ضبط عدّادات توجيه الحدود.
otIp6SelectSourceAddress(otInstance *aInstance, otMessageInfo *aMessageInfo)
اختَر اختيار عنوان مصدر OpenThread.
otIp6Send(otInstance *aInstance, otMessage *aMessage)
تُرسِل مخطّط بيانات IPv6 من خلال واجهة Thread.
otIp6SetAddressCallback(otInstance *aInstance, otIp6AddressCallback aCallback, void *aCallbackContext)
void
تسجِّل معاودة الاتصال للإبلاغ عن تغييرات عنوان IPv6 الداخلية.
otIp6SetEnabled(otInstance *aInstance, bool aEnabled)
لعرض واجهة IPv6 للأعلى أو للأسفل.
otIp6SetMeshLocalIid(otInstance *aInstance, const otIp6InterfaceIdentifier *aIid)
تُحدّد معرّف الشبكة المتداخلة المتداخلة (للاختبار).
otIp6SetMulticastPromiscuousEnabled(otInstance *aInstance, bool aEnabled)
void
تعمل هذه السياسة على تفعيل أو إيقاف وضع البث المتعدد الإرسال على واجهة "سلسلة المحادثات".
otIp6SetReceiveCallback(otInstance *aInstance, otIp6ReceiveCallback aCallback, void *aCallbackContext)
void
تسجّل معاودة الاتصال لتقديم مخططات بيانات IPv6 المستلمة.
otIp6SetReceiveFilterEnabled(otInstance *aInstance, bool aEnabled)
void
تُحدِّد هذه السياسة ما إذا كانت تتم فلترة زيارات التحكُّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر استدعاء الاتصال المحدَّد في otIp6SetSetCallback().
otIp6SetSlaacEnabled(otInstance *aInstance, bool aEnabled)
void
تفعيل/إيقاف وحدة SLAAC
otIp6SetSlaacPrefixFilter(otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)
void
ضبط معالج فلتر وحدة اتفاقية مستوى الخدمة
otIp6SockAddrToString(const otSockAddr *aSockAddr, char *aBuffer, uint16_t aSize)
void
تحوِّل عنوان مقبس IPv6 معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.
otIp6SubscribeMulticastAddress(otInstance *aInstance, const otIp6Address *aAddress)
تعمل هذه السياسة على ربط واجهة Thread بعنوان البث المتعدد لواجهة الشبكة.
otIp6UnsubscribeMulticastAddress(otInstance *aInstance, const otIp6Address *aAddress)
إلغاء الاشتراك من واجهة Thread في عنوان البث المتعدد على واجهة الشبكة

هياكل

otBorderRoutingCounters

يقدم عدادات حِزم البيانات المُعاد توجيهها من خلال توجيه الحدود.

otIp6Address

يمثّل عنوان IPv6.

otIp6AddressComponents

يمثل مكوّنات عنوان IPv6.

otIp6AddressInfo

يعرض معلومات عنوان IPv6.

otIp6Interfaceمعرّف

يمثل معرّف الواجهة لعنوان IPv6.

otIp6NetworkPrefix

تمثل بادئة الشبكة لعنوان IPv6 (أهم 64 بت من العنوان).

otIp6بادئة

تمثل بادئة IPv6.

otMessageInfo

تمثل عناوين المقبس IPv6 المحلي والمقارب.

otNetifAddress

يمثّل عنوان أحادي البث لواجهة واجهة IPv6.

otNetifMulticastAddress

يمثّل عنوان بث متعدد لواجهة واجهة IPv6.

otPacketsAndBytes

تمثل العدادات لحِزم البيانات والبايت.

otSockAddr

يمثّل عنوان مقبس IPv6.

الاتحادات

otIp6Interfaceمعرّف::OT_TOOL_PACKED_FIELD

التعدادات

تعداد مجهول

 anonymous enum

أرقام بروتوكول الإنترنت

أماكن إقامة
OT_IP6_PROTO_DST_OPTS

خيارات الوجهة لبروتوكول IPv6.

OT_IP6_PROTO_FRAGMENT

عنوان جزء للبروتوكول IPv6.

OT_IP6_PROTO_HOP_OPTS

خيار IPv6 Hop-Hop

OT_IP6_PROTO_ICMP6

منصّة إدارة الموافقة (CMP) لبروتوكول IPv6.

OT_IP6_PROTO_IP6

تغليف IPv6.

OT_IP6_PROTO_NONE

لا يوجد عنوان التالي لـ IPv6.

OT_IP6_PROTO_ROUTING

عنوان التوجيه لبروتوكول IPv6.

OT_IP6_PROTO_TCP

بروتوكول التحكم في الإرسال.

OT_IP6_PROTO_UDP

مخطط بيانات المستخدمين

تعداد مجهول

 anonymous enum

أصول عنوان IPv6

أماكن إقامة
OT_ADDRESS_ORIGIN_DHCPV6

عنوان DHCPv6 المعيّن.

OT_ADDRESS_ORIGIN_MANUAL

العنوان الذي تم تعيينه يدويًا.

OT_ADDRESS_ORIGIN_SLAAC

عنوان تعيين SLAAC

OT_ADDRESS_ORIGIN_THREAD

العنوان المخصّص لسلسلة المحادثات (ALOC وRLOC وMLEID وما إلى ذلك)

تعداد مجهول

 anonymous enum

حالات ECN، كما هو موضَّح في عنوان IP

أماكن إقامة
OT_ECN_CAPABLE_0

ECT(0)

OT_ECN_CAPABLE_1

(ECT)(1)

OT_ECN_MARKED

ازدحام تم تجاوزه (CE)

OT_ECN_NOT_CAPABLE

ليس توقيت ECT.

أنواع المحددات

otBorderRoutingCounters

struct otBorderRoutingCounters otBorderRoutingCounters

يقدم عدادات حِزم البيانات المُعاد توجيهها من خلال توجيه الحدود.

otIp6العنوان

struct otIp6Address otIp6Address

يمثّل عنوان IPv6.

otIp6AddressCallback

void(* otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)

يتم استدعاء المؤشر عند إضافة عنوان IPv6 داخلي أو إزالته.

التفاصيل
المَعلمات
[in] aAddressInfo
مؤشر إلى معلومات عنوان IPv6.
[in] aIsAdded
صحيح إذا تمت إضافة aAddress، على "خطأ" في حالة إزالة aAddress.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otIp6مكوّنات المكوّن الإضافي

struct otIp6AddressComponents otIp6AddressComponents

يمثل مكوّنات عنوان IPv6.

otIp6AddressInfo

struct otIp6AddressInfo otIp6AddressInfo

otIp6Interfaceالمعرّف

struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

يمثل معرّف الواجهة لعنوان IPv6.

otIp6NetworkPrefix

struct otIp6NetworkPrefix otIp6NetworkPrefix

تمثل بادئة الشبكة لعنوان IPv6 (أهم 64 بت من العنوان).

otIp6بادئة

struct otIp6Prefix otIp6Prefix

تمثل بادئة IPv6.

otIp6تلقي المكالمات

void(* otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)

يتم استدعاء المؤشر عند استلام مخطط بيانات IPv6.

التفاصيل
المَعلمات
[in] aMessage
مؤشر إلى المخزن المؤقت للرسائل الذي يحتوي على مخطط بيانات IPv6 المستلَم. تنقل هذه الدالة ملكية aMessage إلى مستقبِل معاودة الاتصال. يجب أن يُخلي المُستلِم من رد الاتصال الرسالة بعد معالجتها (يُرجى الاطِّلاع على otMessageFree()).
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otIp6registerMulticastالاستماعsCallback

void(* otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)

يتم طلب المؤشر مع نتائج otIp6RegisterMulticastListeners.

التفاصيل
المَعلمات
[in] aContext
مؤشر إلى سياق المستخدم.
[in] aError
OT_ERROR_NONE عند تعذّر إرسال MLR.req واستلام MLR.rsp، بنجاح
[in] aMlrStatus
تكون حالة تسجيل المستمع المتعدد عند aError هي OT_ERROR_NONE.
[in] aFailedAddresses
مؤشر إلى عناوين IPv6 غير الناجحة عندما يكون aError هو OT_ERROR_NONE.
[in] aFailedAddressNum
عدد عناوين IPv6 التي تعذّر تنفيذها عندما تكون aError هي OT_ERROR_NONE.
يمكنك أيضًا الاطّلاع على ما يلي:
otIp6registerMulticastالاستماعs

otIp6SlaacPrefixfilter

bool(* otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)

يسمح المؤشر للمستخدم بفلترة البادئات وعدم السماح بإضافة عنوان SLAAC بناءً على بادئة.

يمكن استخدام otIp6SetSlaacPrefixFilter() لضبط معالج الفلاتر. استدعاء معالج الفلتر من خلال وحدة SLAAC عندما تكون على وشك إضافة عنوان SLAAC بناءً على بادئة. وتحدد قيمة الإرجاع المنطقية ما إذا كان العنوان تمت فلترته (لم تتم إضافته) أو لا.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
مؤشر للبادئة التي أوشك إضافة عنوان SLAAC لها.
قيم الإرجاع
TRUE
يشير إلى أن عنوان SLAAC المستند إلى البادئة يجب أن تتم فلترته وعدم إضافته.
FALSE
يشير إلى أنه يجب إضافة عنوان SLAAC بناءً على البادئة.

otMessageInfo

struct otMessageInfo otMessageInfo

تمثل عناوين المقبس IPv6 المحلي والمقارب.

otNetifAddress

struct otNetifAddress otNetifAddress

يمثّل عنوان أحادي البث لواجهة واجهة IPv6.

OTNetifMulticastAddress

struct otNetifMulticastAddress otNetifMulticastAddress

يمثّل عنوان بث متعدد لواجهة واجهة IPv6.

OtPacketsAndBytes

struct otPacketsAndBytes otPacketsAndBytes

تمثل العدادات لحِزم البيانات والبايت.

otSockAddr

struct otSockAddr otSockAddr

يمثّل عنوان مقبس IPv6.

المتغيّرات

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier OT_TOOL_PACKED_END

الدوال

otIp6AddUnicastAddress

otError otIp6AddUnicastAddress(
  otInstance *aInstance,
  const otNetifAddress *aAddress
)

لإضافة عنوان واجهة شبكة إلى واجهة سلسلة المحادثات.

يتم نسخ المثيل aAddress الذي تم تمريره من خلال واجهة Thread. لا تتوافق واجهة Thread إلا مع عدد ثابت من عناوين يونيكود المُضافة خارجيًا. يمكنك الاطّلاع على OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddress
إشارة إلى عنوان واجهة الشبكة
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة (أو تحديث) عنوان واجهة الشبكة بنجاح.
OT_ERROR_INVALID_ARGS
إنّ عنوان IP المُشار إليه من خلال aAddress هو عنوان داخلي.
OT_ERROR_NO_BUFS
تخزّن واجهة الشبكة الحد الأقصى المسموح به من العناوين الخارجية المسموح بها.

otIp6AddUnsecurePort

otError otIp6AddUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

إضافة منفذ إلى قائمة المنافذ غير الآمنة المسموح بها

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPort
قيمة النقل.
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة المنفذ بنجاح إلى قائمة المنافذ غير الآمنة المسموح بها.
OT_ERROR_INVALID_ARGS
المنفذ غير صالح (القيمة 0 محجوزة للاستخدام الداخلي).
OT_ERROR_NO_BUFS
قائمة المنافذ غير الآمنة ممتلئة.

otIp6AddressFromString

otError otIp6AddressFromString(
  const char *aString,
  otIp6Address *aAddress
)

تحوِّل سلسلة عنوان IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.

التفاصيل
المَعلمات
[in] aString
مؤشر إلى سلسلة يتم إنهاؤها NULL.
[out] aAddress
مؤشر إلى عنوان IPv6.
قيم الإرجاع
OT_ERROR_NONE
تم تحليل aString وتحديث aAddress بنجاح.
OT_ERROR_PARSE
تعذَّر تحليل aString كعنوان IPv6.

otIp6AddressToString

void otIp6AddressToString(
  const otIp6Address *aAddress,
  char *aBuffer,
  uint16_t aSize
)

تحوِّل عنوان IPv6 معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.

يتم تنسيق سلسلة عنوان IPv6 كقيم سداسية عشرية 16 مفصولة بعلامة ":": (أي "%x:%x:%x:...:%x").

إذا كانت السلسلة الناتجة لا تناسب aBuffer (خلال aSize من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.

التفاصيل
المَعلمات
[in] aAddress
مؤشر إلى عنوان IPv6 (يجب ألا يكون فارغًا).
[out] aBuffer
مؤشر إلى صفيف char لإخراج السلسلة (يجب ألا تكون القيمة NULL).
[in] aSize
حجم aBuffer (بالبايت) ننصح باستخدام OT_IP6_ADDRESS_STRING_SIZE.

otIp6ArePrefixesEqual

bool otIp6ArePrefixesEqual(
  const otIp6Prefix *aFirst,
  const otIp6Prefix *aSecond
)

اختبِر ما إذا كانت بادئتان IPv6 متطابقتَين.

التفاصيل
المَعلمات
[in] aFirst
مؤشر على بادئة IPv6 الأولى المطلوب مقارنتها.
[in] aSecond
مؤشر إلى بادئة IPv6 الثانية المطلوب مقارنتها.
قيم الإرجاع
TRUE
تكون بادئتان IPv6 متطابقتَين.
FALSE
بادئتا IPv6 غير متطابقتَين.

otIp6GetBorderRoutingCounters

const otBorderRoutingCounters * otIp6GetBorderRoutingCounters(
  otInstance *aInstance
)

للحصول على عدّادات توجيه الحدود.

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_BR_COUNTERS_ENABLE.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عدّادات توجيه الحدود.

otIp6GetMulticastAddresses

const otNetifMulticastAddress * otIp6GetMulticastAddresses(
  otInstance *aInstance
)

للحصول على قائمة بعناوين البث المتعدد IPv6 المُشترَكة في واجهة Thread

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
إشارة إلى العنوان الأول للبث المتعدد على الشبكة.

otIp6Getبادئة

void otIp6GetPrefix(
  const otIp6Address *aAddress,
  uint8_t aLength,
  otIp6Prefix *aPrefix
)

الحصول على بادئة باستخدام aLength من aAddress

التفاصيل
المَعلمات
[in] aAddress
مؤشر إلى عنوان IPv6.
[in] aLength
طول البادئة بوحدة البت.
[out] aPrefix
مؤشر لإخراج بادئة IPv6.

otIp6GetUnicastAddresses

const otNetifAddress * otIp6GetUnicastAddresses(
  otInstance *aInstance
)

الحصول على قائمة بعناوين IPv6 المخصّصة لواجهة Thread.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
إشارة إلى العنوان الأول لواجهة الشبكة.

otIp6GetUnsecurePorts

const uint16_t * otIp6GetUnsecurePorts(
  otInstance *aInstance,
  uint8_t *aNumEntries
)

عرض مؤشر إلى قائمة المنافذ غير الآمنة

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aNumEntries
عدد الإدخالات في القائمة.
المرتجعات
إشارة إلى قائمة المنافذ غير الآمنة

otIp6IsAddressEqual

bool otIp6IsAddressEqual(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

اختبِر ما إذا كان هناك عنوانا IPv6 متطابقان.

التفاصيل
المَعلمات
[in] aFirst
مؤشر إلى أول عنوان IPv6 لإجراء المقارنة
[in] aSecond
مؤشر إلى عنوان IPv6 الثاني للمقارنة.
قيم الإرجاع
TRUE
عنوانا IPv6 متطابقان.
FALSE
عنوانا IPv6 غير متطابقين.

otIp6IsAddressغير محدد

bool otIp6IsAddressUnspecified(
  const otIp6Address *aAddress
)

يشير إلى ما إذا كان عنوان IPv6 معيّنًا هو العنوان غير المحدّد.

التفاصيل
المَعلمات
[in] aAddress
مؤشر إلى عنوان IPv6.
قيم الإرجاع
TRUE
إذا كان عنوان IPv6 هو العنوان غير المحدَّد.
FALSE
إذا لم يكن عنوان IPv6 هو العنوان غير المحدّد.

otIp6IsEnabled

bool otIp6IsEnabled(
  otInstance *aInstance
)

يشير هذا الحقل إلى ما إذا كانت واجهة IPv6 مفعّلة أم لا.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
TRUE
واجهة IPv6 مفعّلة.
FALSE
تم إيقاف واجهة IPv6.

otIp6IsMulticastPromiscuousEnabled

bool otIp6IsMulticastPromiscuousEnabled(
  otInstance *aInstance
)

يتحقّق مما إذا كان قد تم تفعيل وضع الإرسال المتعدد في واجهة Thread.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
يُرجى الاطّلاع أيضًا على:
otIp6SetMulticastPromiscuousEnabled

otIp6IsReceivedfilterEnabled

bool otIp6IsReceiveFilterEnabled(
  otInstance *aInstance
)

يشير هذا الحقل إلى ما إذا كان تتم فلترة زيارات التحكّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر معاودة الاتصال المحدّدة في otIp6SetSetCallback().

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
صحيح في حال فلترة زيارات التحكّم في سلاسل المحادثات، وخطأ في الحالات الأخرى.
يمكنك أيضًا الاطّلاع على ما يلي:
otIp6Set الاستلامCallCall
otIp6Set الاستلامfilterEnabled

otIp6IsSlaacEnabled

bool otIp6IsSlaacEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كانت وحدة "اتفاقية مستوى الخدمة" (SLAAC) مفعَّلة أم لا.

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

التفاصيل
قيم الإرجاع
TRUE
تم تفعيل وحدة SLAAC.
FALSE
تم إيقاف وحدة SLAAC.

otIp6رسالة جديدة

otMessage * otIp6NewMessage(
  otInstance *aInstance,
  const otMessageSettings *aSettings
)

خصِّص ذاكرة تخزين مؤقت جديدة للرسائل لإرسال رسالة IPv6.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSettings
مؤشر للإعدادات أو الرسالة NULL لضبط الإعدادات التلقائية.
المرتجعات
إشارة إلى المخزن المؤقت للرسائل أو إلى NULL إذا لم تتوفر أي مخازن رسائل مؤقتة أو كانت المعلمات غير صالحة.
يُرجى الاطّلاع أيضًا على:
otMessageFree

otIp6NewMessageFromBuffer

otMessage * otIp6NewMessageFromBuffer(
  otInstance *aInstance,
  const uint8_t *aData,
  uint16_t aDataLength,
  const otMessageSettings *aSettings
)

خصِّص المخزن المؤقت الجديد للرسائل واكتب مخطط بيانات IPv6 إلى المخزن المؤقت للرسائل لإرسال رسالة IPv6.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aData
مؤشر إلى المخزن المؤقت لمخطّط IPv6.
[in] aDataLength
حجم المخزن المؤقت لبيانات IPv6 المُشار إليه بواسطة aData.
[in] aSettings
مؤشر للإعدادات أو الرسالة NULL لضبط الإعدادات التلقائية.
المرتجعات
مؤشر إلى الرسالة أو القيمة NULL في حال توفّر عنوان IPv6 غير صحيح أو المخزن المؤقت للرسائل غير كافية.
يُرجى الاطّلاع أيضًا على:
otMessageFree

otIp6بادئةFromString

otError otIp6PrefixFromString(
  const char *aString,
  otIp6Prefix *aPrefix
)

تحوِّل سلسلة بادئة IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.

يجب أن تكون المَعلمة aString سلسلة بالتنسيق " ".

/"، حيث
هو عنوان IPv6 و هو طول البادئة.

التفاصيل
المَعلمات
[in] aString
مؤشر إلى سلسلة يتم إنهاؤها NULL.
[out] aPrefix
مؤشر لبادئة IPv6.
قيم الإرجاع
OT_ERROR_NONE
تم تحليل السلسلة بنجاح كبادئة IPv6 وتعديل السمة aPrefix.
OT_ERROR_PARSE
تعذَّر تحليل aString كبادئة IPv6.

otIp6بادئةتطابق

uint8_t otIp6PrefixMatch(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

عرض طول مطابقة البادئة (بوحدة البت) لعنوانَي IPv6.

التفاصيل
المَعلمات
[in] aFirst
مؤشر على أول عنوان IPv6.
[in] aSecond
مؤشر إلى عنوان IPv6 الثاني.
المرتجعات
طول مطابقة البادئة بوحدة البت.

otIp6PrefixToString

void otIp6PrefixToString(
  const otIp6Prefix *aPrefix,
  char *aBuffer,
  uint16_t aSize
)

تحوِّل بادئة IPv6 معيّنة إلى سلسلة يمكن للمستخدمين قراءتها.

يتم تنسيق سلسلة عنوان IPv6 بالتنسيق "%x:%x:%x:...[::]/plen".

إذا كانت السلسلة الناتجة لا تناسب aBuffer (خلال aSize من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.

التفاصيل
المَعلمات
[in] aPrefix
مؤشر لبادئة IPv6 (يجب ألا يكون فارغًا).
[out] aBuffer
مؤشر إلى صفيف char لإخراج السلسلة (يجب ألا تكون القيمة NULL).
[in] aSize
حجم aBuffer (بالبايت) ننصح باستخدام OT_IP6_PREFIX_STRING_SIZE.

otIp6ProtoToString

const char * otIp6ProtoToString(
  uint8_t aIpProto
)

تحوِّل رقم بروتوكول IP معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.

التفاصيل
المَعلمات
[in] aIpProto
رقم بروتوكول IP (تعداد OT_IP6_PROTO_*)
المرتجعات
سلسلة تمثّل aIpProto.

otIp6RecordMulticastالاستماعات

otError otIp6RegisterMulticastListeners(
  otInstance *aInstance,
  const otIp6Address *aAddresses,
  uint8_t aAddressNum,
  const uint32_t *aTimeout,
  otIp6RegisterMulticastListenersCallback aCallback,
  void *aContext
)

تسجِّل مستمعي البث المتعدد في جهاز التوجيه الأساسي الأساسي.

ملاحظة: متاح فقط عند تفعيل كل من OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE وOPENTHREAD_CONFIG_COMMISSIONER_ENABLE

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddresses
صفيف عنوان البث المتعدد للتسجيل.
[in] aAddressNum
عدد عناوين البث المتعدد للتسجيل (0 إذا كان aAddresses فارغًا).
[in] aTimeout
مؤشر إلى قيمة المهلة (بالثواني) التي سيتم تضمينها في MLR.req تؤدي قيمة المهلة 0 إلى إزالة أداة الاستماع المتعددة الوسائط المقابلة. في حال وجود NULL، لن تحتوي MLR.req على أي مهلة Tlv تلقائيًا.
[in] aCallback
مؤشر لدالة معاودة الاتصال
[in] aContext
مؤشر إلى سياق المستخدم.
قيم الإرجاع
OT_ERROR_NONE
تم إرسال MLR.req بنجاح. سيتم طلب aCallback إذا كانت هذه الطريقة تعرض OT_ERROR_NONE.
OT_ERROR_BUSY
إذا كان التسجيل السابق جاريًا
OT_ERROR_INVALID_ARGS
إذا كانت وسيطة واحدة أو أكثر غير صالحة.
OT_ERROR_INVALID_STATE
إذا لم يكن الجهاز في حالة صالحة لإرسال MLR.req (على سبيل المثال، لم يتم بدء المُفوَّض، ولم يتم العثور على جهاز التوجيه الأساسي).
OT_ERROR_NO_BUFS
في حال عدم توفّر المخزن المؤقت الكافي للرسائل
يمكنك أيضًا الاطّلاع على ما يلي:
otIp6registerMulticastالاستماعersCallback

otIp6RemoveAllUnsecurePorts

void otIp6RemoveAllUnsecurePorts(
  otInstance *aInstance
)

تتم إزالة جميع المنافذ من قائمة المنافذ غير الآمنة المسموح بها.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.

otIp6إزالةUnicastAddress

otError otIp6RemoveUnicastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

إزالة عنوان واجهة الشبكة من واجهة Thread

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddress
يشير إلى عنوان IP.
قيم الإرجاع
OT_ERROR_NONE
تمت إزالة عنوان واجهة الشبكة بنجاح.
OT_ERROR_INVALID_ARGS
إنّ عنوان IP المُشار إليه من خلال aAddress هو عنوان داخلي.
OT_ERROR_NOT_FOUND
لم يتم العثور على عنوان IP المُشار إليه من خلال aAddress.

otIp6RemoveUnsecurePort

otError otIp6RemoveUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

تتم إزالة منفذ من قائمة المنافذ غير الآمنة المسموح بها.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPort
قيمة النقل.
قيم الإرجاع
OT_ERROR_NONE
تمت إزالة المنفذ بنجاح من قائمة المنافذ غير الآمنة المسموح بها.
OT_ERROR_INVALID_ARGS
المنفذ غير صالح (القيمة 0 محجوزة للاستخدام الداخلي).
OT_ERROR_NOT_FOUND
لم يتم العثور على عملية النقل في قائمة المنافذ غير الآمنة.

otIp6ResetBorderRoutingCounters

void otIp6ResetBorderRoutingCounters(
  otInstance *aInstance
)

يؤدي هذا الخيار إلى إعادة ضبط عدّادات توجيه الحدود.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.

otIp6SelectSourceAddress

otError otIp6SelectSourceAddress(
  otInstance *aInstance,
  otMessageInfo *aMessageInfo
)

اختَر اختيار عنوان مصدر OpenThread.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aMessageInfo
مؤشر لمعلومات الرسالة
قيم الإرجاع
OT_ERROR_NONE
تم العثور على عنوان مصدر وتم ملؤه في mSockAddr ضمن aMessageInfo.
OT_ERROR_NOT_FOUND
لم يتم العثور على عنوان المصدر، ولم يتم تغيير aMessageInfo.

OtIp6إرسال

otError otIp6Send(
  otInstance *aInstance,
  otMessage *aMessage
)

تُرسِل مخطّط بيانات IPv6 من خلال واجهة Thread.

المتّصل ينقل ملكية aMessage عند إجراء هذه المكالمة. سيفتح OpenThread aMessage عند اكتمال المعالجة، بما في ذلك عند عرض قيمة أخرى غير OT_ERROR_NONE.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aMessage
مؤشر إلى المخزن المؤقت للرسائل الذي يحتوي على مخطط بيانات IPv6.
قيم الإرجاع
OT_ERROR_NONE
تمت معالجة الرسالة بنجاح.
OT_ERROR_DROP
تم إعداد الرسالة بشكلٍ جيد ولكن لم تتم معالجتها بالكامل بسبب قواعد معالجة الحزمة.
OT_ERROR_NO_BUFS
تعذّر تخصيص مخازن الرسائل الضرورية عند معالجة مخطّط البيانات.
OT_ERROR_NO_ROUTE
لا يتوفّر مسار للاستضافة.
OT_ERROR_INVALID_SOURCE_ADDRESS
عنوان المصدر غير صالح، على سبيل المثال عنوان أي بث أو عنوان بث متعدد.
OT_ERROR_PARSE
حدث خطأ في عنوان أثناء معالجة الرسالة.

otIp6SetAddressCallback

void otIp6SetAddressCallback(
  otInstance *aInstance,
  otIp6AddressCallback aCallback,
  void *aCallbackContext
)

تسجِّل معاودة الاتصال للإبلاغ عن تغييرات عنوان IPv6 الداخلية.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر لدالة يتم استدعاؤها عند إضافة عنوان IPv6 داخلي أو إزالته. NULL لإيقاف معاودة الاتصال.
[in] aCallbackContext
مؤشر للسياق الخاص بالتطبيق.

otIp6SetEnabled

otError otIp6SetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

لعرض واجهة IPv6 للأعلى أو للأسفل.

اتصل بهذا الأمر لتفعيل اتصال IPv6 أو إيقافه.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnabled
TRUE لتفعيل IPv6 أو "خطأ" بخلاف ذلك.
قيم الإرجاع
OT_ERROR_NONE
تم بنجاح عرض واجهة IPv6.
OT_ERROR_INVALID_STATE
واجهة IPv6 غير متاحة لأنّ الجهاز يعمل في وضع الرابط الأولي (لا ينطبق ذلك إلا عند تفعيل ميزة OPENTHREAD_CONFIG_LINK_RAW_ENABLE).

otIp6SetMeshLocalIid

otError otIp6SetMeshLocalIid(
  otInstance *aInstance,
  const otIp6InterfaceIdentifier *aIid
)

تُحدّد معرّف الشبكة المتداخلة المتداخلة (للاختبار).

متاح فقط عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aIid
مؤشر إلى الرقم التعريفي المحلي للشبكة المتداخلة لضبطه
قيم الإرجاع
OT_ERROR_NONE
تم ضبط الرقم التعريفي المحلي للشبكة المتداخلة بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعَّلة.

otIp6SetSetcastPromiscuousEnabled

void otIp6SetMulticastPromiscuousEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تعمل هذه السياسة على تفعيل أو إيقاف وضع البث المتعدد الإرسال على واجهة "سلسلة المحادثات".

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnabled
TRUE لتفعيل وضع "البث المتعدد" و"خطأ" بخلاف ذلك.
يمكنك أيضًا الاطّلاع على ما يلي:
otIp6IsMulticastPromiscuousEnabled

otIp6SetSetCallback

void otIp6SetReceiveCallback(
  otInstance *aInstance,
  otIp6ReceiveCallback aCallback,
  void *aCallbackContext
)

تسجّل معاودة الاتصال لتقديم مخططات بيانات IPv6 المستلمة.

بشكل تلقائي، لا تجتاز معاودة الاتصال هذه حركة التحكّم في سلسلة المحادثات. يُرجى الاطّلاع على otIp6SetSetfilterEnabled() لتغيير إعدادات فلتر الزيارات الواردة في سلسلة المحادثات.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر إلى دالة تُسمى عند تلقّي مخطط بيانات IPv6 أو القيمة NULL لإيقاف معاودة الاتصال.
[in] aCallbackContext
مؤشر للسياق الخاص بالتطبيق.
يمكنك أيضًا الاطّلاع على ما يلي:
otIp6Is الاستلامfilterEnabled
otIp6Set الاستلامfilterEnabled

otIp6SetSetfilterEnabled

void otIp6SetReceiveFilterEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تُحدِّد هذه السياسة ما إذا كانت تتم فلترة زيارات التحكُّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر استدعاء الاتصال المحدَّد في otIp6SetSetCallback().

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnabled
صحيح في حال فلترة زيارات التحكّم في سلاسل المحادثات، وخطأ في الحالات الأخرى.
يمكنك أيضًا الاطّلاع على الرابط:
otIp6Set الاستلامCallback
otIs الأغانيIp6filterEnabled

otIp6SetSlaacEnabled

void otIp6SetSlaacEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تفعيل/إيقاف وحدة SLAAC

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

عند تفعيل وحدة SLAAC، تتم إضافة عناوين SLAAC (استنادًا إلى البادئات المتداخلة) في بيانات الشبكة إلى الواجهة. عند إيقاف وحدة SLAAC، تتم إزالة أي عنوان SLAAC سبق إضافته.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnabled
TRUE للتفعيل، وFalse لإيقافها.

otIp6SetSlaacPrefixfilter

void otIp6SetSlaacPrefixFilter(
  otInstance *aInstance,
  otIp6SlaacPrefixFilter aFilter
)

ضبط معالج فلتر وحدة اتفاقية مستوى الخدمة

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

يتم طلب معالج الفلتر من خلال وحدة SLAAC عندما تكون على وشك إضافة عنوان SLAAC استنادًا إلى بادئة لتحديد ما إذا كان يجب إضافة العنوان أم لا.

أوقف معالج فلتر NULL الفلترة، ويسمح بإضافة جميع عناوين SLAAC.

إذا لم يتم استدعاء هذه الدالة، سيكون الفلتر التلقائي الذي تستخدمه وحدة SLAAC هو NULL (تم إيقاف الفلترة).

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aFilter
مؤشر إلى معالج فلتر بادئة SLAAC أو NULL لإيقاف الفلترة.

otIp6SockAddrToString

void otIp6SockAddrToString(
  const otSockAddr *aSockAddr,
  char *aBuffer,
  uint16_t aSize
)

تحوِّل عنوان مقبس IPv6 معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.

يتم تنسيق سلسلة عنوان المقابس IPv6 على النحو التالي: [address]:port حيث يتم عرض address في شكل 16 قيمة سداسية عشرية، وتكون منفصلة عن : وport هو رقم المنفذ بالتنسيق العشري، على سبيل المثال "[%x:%x:...:%x]:%u".

إذا كانت السلسلة الناتجة لا تناسب aBuffer (خلال aSize من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.

التفاصيل
المَعلمات
[in] aSockAddr
مؤشر إلى عنوان بروتوكول IPv6 (يجب ألا يكون فارغًا).
[out] aBuffer
مؤشر إلى صفيف char لإخراج السلسلة (يجب ألا تكون القيمة NULL).
[in] aSize
حجم aBuffer (بالبايت) ننصح باستخدام OT_IP6_SOCK_ADDR_STRING_SIZE.

otIp6SignMulticastAddress

otError otIp6SubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

تعمل هذه السياسة على ربط واجهة Thread بعنوان البث المتعدد لواجهة الشبكة.

سيتم نسخ المثيل aAddress الذي تم تمريره من خلال واجهة Thread. لا تتوافق واجهة Thread إلا مع عدد ثابت من عناوين البث المتعدد التي تتم إضافتها خارجيًا. يمكنك الاطّلاع على OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddress
يشير إلى عنوان IP.
قيم الإرجاع
OT_ERROR_NONE
تم الاشتراك بنجاح في عنوان واجهة الشبكة المتعددة البث.
OT_ERROR_ALREADY
سبق أن تم الاشتراك في عنوان البث المتعدد.
OT_ERROR_INVALID_ARGS
عنوان IP المُشار إليه من خلال aAddress هو عنوان غير صالح للبث المتعدد.
OT_ERROR_REJECTED
عنوان IP المُشار إليه في aAddress هو عنوان داخلي للبث المتعدد.
OT_ERROR_NO_BUFS
تخزّن واجهة الشبكة الحد الأقصى المسموح به من عناوين البث المتعدد الخارجية المسموح بها.

otIp6إلغاء الاشتراك

otError otIp6UnsubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

إلغاء الاشتراك من واجهة Thread في عنوان البث المتعدد على واجهة الشبكة

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddress
يشير إلى عنوان IP.
قيم الإرجاع
OT_ERROR_NONE
تم إلغاء الاشتراك بنجاح في عنوان واجهة الشبكة المتعددة.
OT_ERROR_REJECTED
إنّ عنوان IP المُشار إليه من خلال aAddress هو عنوان داخلي.
OT_ERROR_NOT_FOUND
لم يتم العثور على عنوان IP المُشار إليه من خلال aAddress.

وحدات ماكرو

OT_IP6_ADDRESS_SIZE

 OT_IP6_ADDRESS_SIZE 16

حجم عنوان IPv6 (بالبايت)

OT_IP6_ADDRESS_STRING_SIZE

 OT_IP6_ADDRESS_STRING_SIZE 40

الحجم المقترح لتمثيل السلسلة لعنوان IPv6

OT_IP6_IID_SIZE

 OT_IP6_IID_SIZE 8

حجم معرّف واجهة IPv6 (بالبايت)

OT_IP6_MAX_MLR_ADDRESSES

 OT_IP6_MAX_MLR_ADDRESSES 15

الحد الأقصى لعدد عناوين IPv6 المتوافقة مع تسجيل المستمعين المتعددين.

OT_IP6_RDFa_bitSIZE

 OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

حجم بادئة IPv6 (بوحدة البت)

OT_IP6_RDFa_SIZE

 OT_IP6_PREFIX_SIZE 8

حجم بادئة IPv6 (بالبايت)

OT_IP6_RDFa_STRING_SIZE

 OT_IP6_PREFIX_STRING_SIZE 45

الحجم المقترَح لتمثيل السلسلة لبادئة IPv6.

OT_IP6_SOCK_REWARD_STRING_SIZE

 OT_IP6_SOCK_ADDR_STRING_SIZE 48

الحجم المقترح لتمثيل السلسلة في عنوان المقبس IPv6

الموارد

تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.