Ipv6
تتضمن هذه الوحدة الدوال التي تتحكم في اتصال IPv6.
ملخّص
التعدادات |
|
---|---|
anonymous enum{
|
تعداد أرقام بروتوكول الإنترنت |
anonymous enum{
|
تعداد أصول عنوان IPv6 |
anonymous enum{
|
تعداد حالات ECN، كما هو موضَّح في عنوان IP |
أنواع المحددات |
|
---|---|
otBorderRoutingCounters
|
typedefstruct otBorderRoutingCounters
يقدم عدادات حِزم البيانات المُعاد توجيهها من خلال توجيه الحدود. |
otIp6Address
|
typedefstruct otIp6Address
يمثّل عنوان IPv6. |
otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر عند إضافة عنوان IPv6 داخلي أو إزالته. |
otIp6AddressComponents
|
typedefstruct otIp6AddressComponents
يمثل مكوّنات عنوان IPv6. |
otIp6AddressInfo
|
typedefstruct otIp6AddressInfo
|
otIp6InterfaceIdentifier
|
typedefstruct otIp6InterfaceIdentifier
يمثل معرّف الواجهة لعنوان IPv6. |
otIp6NetworkPrefix
|
typedefstruct otIp6NetworkPrefix
تمثل بادئة الشبكة لعنوان IPv6 (أهم 64 بت من العنوان). |
otIp6Prefix
|
typedefstruct otIp6Prefix
تمثل بادئة IPv6. |
otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر عند استلام مخطط بيانات IPv6. |
otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)
|
typedefvoid(*
يتم طلب المؤشر مع نتائج otIp6RegisterMulticastListeners . |
otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)
|
typedefbool(*
يسمح المؤشر للمستخدم بفلترة البادئات وعدم السماح بإضافة عنوان SLAAC بناءً على بادئة. |
otMessageInfo
|
typedefstruct otMessageInfo
تمثل عناوين المقبس IPv6 المحلي والمقارب. |
otNetifAddress
|
typedefstruct otNetifAddress
يمثّل عنوان أحادي البث لواجهة واجهة IPv6. |
otNetifMulticastAddress
|
typedefstruct otNetifMulticastAddress
يمثّل عنوان بث متعدد لواجهة واجهة IPv6. |
otPacketsAndBytes
|
typedefstruct otPacketsAndBytes
تمثل العدادات لحِزم البيانات والبايت. |
otSockAddr
|
typedefstruct 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)
|
const otBorderRoutingCounters *
للحصول على عدّادات توجيه الحدود.
|
otIp6GetMulticastAddresses(otInstance *aInstance)
|
const otNetifMulticastAddress *
للحصول على قائمة بعناوين البث المتعدد 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معرّف:: |
التعدادات
تعداد مجهول
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
يقدم عدادات حِزم البيانات المُعاد توجيهها من خلال توجيه الحدود.
otIp6AddressCallback
void(* otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)
يتم استدعاء المؤشر عند إضافة عنوان IPv6 داخلي أو إزالته.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6مكوّنات المكوّن الإضافي
struct otIp6AddressComponents otIp6AddressComponents
يمثل مكوّنات عنوان IPv6.
otIp6AddressInfo
struct otIp6AddressInfo otIp6AddressInfo
otIp6Interfaceالمعرّف
struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier
يمثل معرّف الواجهة لعنوان IPv6.
otIp6NetworkPrefix
struct otIp6NetworkPrefix otIp6NetworkPrefix
تمثل بادئة الشبكة لعنوان IPv6 (أهم 64 بت من العنوان).
otIp6تلقي المكالمات
void(* otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)
يتم استدعاء المؤشر عند استلام مخطط بيانات IPv6.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otIp6registerMulticastالاستماعsCallback
void(* otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)
يتم طلب المؤشر مع نتائج otIp6RegisterMulticastListeners
.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6registerMulticastالاستماعs
otIp6SlaacPrefixfilter
bool(* otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)
يسمح المؤشر للمستخدم بفلترة البادئات وعدم السماح بإضافة عنوان SLAAC بناءً على بادئة.
يمكن استخدام otIp6SetSlaacPrefixFilter()
لضبط معالج الفلاتر. استدعاء معالج الفلتر من خلال وحدة SLAAC عندما تكون على وشك إضافة عنوان SLAAC بناءً على بادئة. وتحدد قيمة الإرجاع المنطقية ما إذا كان العنوان تمت فلترته (لم تتم إضافته) أو لا.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
OTNetifMulticastAddress
struct otNetifMulticastAddress otNetifMulticastAddress
يمثّل عنوان بث متعدد لواجهة واجهة 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
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otIp6AddUnsecurePort
otError otIp6AddUnsecurePort( otInstance *aInstance, uint16_t aPort )
إضافة منفذ إلى قائمة المنافذ غير الآمنة المسموح بها
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otIp6AddressFromString
otError otIp6AddressFromString( const char *aString, otIp6Address *aAddress )
تحوِّل سلسلة عنوان IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6AddressToString
void otIp6AddressToString( const otIp6Address *aAddress, char *aBuffer, uint16_t aSize )
تحوِّل عنوان IPv6 معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.
يتم تنسيق سلسلة عنوان IPv6 كقيم سداسية عشرية 16 مفصولة بعلامة ":": (أي "%x:%x:%x:...:%x").
إذا كانت السلسلة الناتجة لا تناسب aBuffer
(خلال aSize
من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6ArePrefixesEqual
bool otIp6ArePrefixesEqual( const otIp6Prefix *aFirst, const otIp6Prefix *aSecond )
اختبِر ما إذا كانت بادئتان IPv6 متطابقتَين.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6GetBorderRoutingCounters
const otBorderRoutingCounters * otIp6GetBorderRoutingCounters( otInstance *aInstance )
للحصول على عدّادات توجيه الحدود.
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_BR_COUNTERS_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عدّادات توجيه الحدود.
|
otIp6GetMulticastAddresses
const otNetifMulticastAddress * otIp6GetMulticastAddresses( otInstance *aInstance )
للحصول على قائمة بعناوين البث المتعدد IPv6 المُشترَكة في واجهة Thread
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
إشارة إلى العنوان الأول للبث المتعدد على الشبكة.
|
otIp6Getبادئة
void otIp6GetPrefix( const otIp6Address *aAddress, uint8_t aLength, otIp6Prefix *aPrefix )
الحصول على بادئة باستخدام aLength
من aAddress
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6GetUnicastAddresses
const otNetifAddress * otIp6GetUnicastAddresses( otInstance *aInstance )
الحصول على قائمة بعناوين IPv6 المخصّصة لواجهة Thread.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
إشارة إلى العنوان الأول لواجهة الشبكة.
|
otIp6GetUnsecurePorts
const uint16_t * otIp6GetUnsecurePorts( otInstance *aInstance, uint8_t *aNumEntries )
عرض مؤشر إلى قائمة المنافذ غير الآمنة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
إشارة إلى قائمة المنافذ غير الآمنة
|
otIp6IsAddressEqual
bool otIp6IsAddressEqual( const otIp6Address *aFirst, const otIp6Address *aSecond )
اختبِر ما إذا كان هناك عنوانا IPv6 متطابقان.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6IsAddressغير محدد
bool otIp6IsAddressUnspecified( const otIp6Address *aAddress )
يشير إلى ما إذا كان عنوان IPv6 معيّنًا هو العنوان غير المحدّد.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6IsEnabled
bool otIp6IsEnabled( otInstance *aInstance )
يشير هذا الحقل إلى ما إذا كانت واجهة IPv6 مفعّلة أم لا.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6IsMulticastPromiscuousEnabled
bool otIp6IsMulticastPromiscuousEnabled( otInstance *aInstance )
يتحقّق مما إذا كان قد تم تفعيل وضع الإرسال المتعدد في واجهة Thread.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otIp6SetMulticastPromiscuousEnabled
otIp6IsReceivedfilterEnabled
bool otIp6IsReceiveFilterEnabled( otInstance *aInstance )
يشير هذا الحقل إلى ما إذا كان تتم فلترة زيارات التحكّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر معاودة الاتصال المحدّدة في otIp6SetSetCallback().
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
صحيح في حال فلترة زيارات التحكّم في سلاسل المحادثات، وخطأ في الحالات الأخرى.
|
otIp6Set الاستلامCallCall
otIp6Set الاستلامfilterEnabled
otIp6IsSlaacEnabled
bool otIp6IsSlaacEnabled( otInstance *aInstance )
يشير إلى ما إذا كانت وحدة "اتفاقية مستوى الخدمة" (SLAAC) مفعَّلة أم لا.
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
قيم الإرجاع |
|
otIp6رسالة جديدة
otMessage * otIp6NewMessage( otInstance *aInstance, const otMessageSettings *aSettings )
خصِّص ذاكرة تخزين مؤقت جديدة للرسائل لإرسال رسالة IPv6.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
إشارة إلى المخزن المؤقت للرسائل أو إلى NULL إذا لم تتوفر أي مخازن رسائل مؤقتة أو كانت المعلمات غير صالحة.
|
otMessageFree
otIp6NewMessageFromBuffer
otMessage * otIp6NewMessageFromBuffer( otInstance *aInstance, const uint8_t *aData, uint16_t aDataLength, const otMessageSettings *aSettings )
خصِّص المخزن المؤقت الجديد للرسائل واكتب مخطط بيانات IPv6 إلى المخزن المؤقت للرسائل لإرسال رسالة IPv6.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
المرتجعات |
مؤشر إلى الرسالة أو القيمة NULL في حال توفّر عنوان IPv6 غير صحيح أو المخزن المؤقت للرسائل غير كافية.
|
otMessageFree
otIp6بادئةFromString
otError otIp6PrefixFromString( const char *aString, otIp6Prefix *aPrefix )
تحوِّل سلسلة بادئة IPv6 يمكن قراءتها للمستخدم إلى تمثيل ثنائي.
يجب أن تكون المَعلمة aString
سلسلة بالتنسيق " ".
هو عنوان IPv6 و
هو طول البادئة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6بادئةتطابق
uint8_t otIp6PrefixMatch( const otIp6Address *aFirst, const otIp6Address *aSecond )
عرض طول مطابقة البادئة (بوحدة البت) لعنوانَي IPv6.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
طول مطابقة البادئة بوحدة البت.
|
otIp6PrefixToString
void otIp6PrefixToString( const otIp6Prefix *aPrefix, char *aBuffer, uint16_t aSize )
تحوِّل بادئة IPv6 معيّنة إلى سلسلة يمكن للمستخدمين قراءتها.
يتم تنسيق سلسلة عنوان IPv6 بالتنسيق "%x:%x:%x:...[::]/plen".
إذا كانت السلسلة الناتجة لا تناسب aBuffer
(خلال aSize
من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6ProtoToString
const char * otIp6ProtoToString( uint8_t aIpProto )
تحوِّل رقم بروتوكول IP معيّنًا إلى سلسلة يمكن للمستخدم قراءتها.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
سلسلة تمثّل
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
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||
قيم الإرجاع |
|
otIp6registerMulticastالاستماعersCallback
otIp6RemoveAllUnsecurePorts
void otIp6RemoveAllUnsecurePorts( otInstance *aInstance )
تتم إزالة جميع المنافذ من قائمة المنافذ غير الآمنة المسموح بها.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otIp6إزالةUnicastAddress
otError otIp6RemoveUnicastAddress( otInstance *aInstance, const otIp6Address *aAddress )
إزالة عنوان واجهة الشبكة من واجهة Thread
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otIp6RemoveUnsecurePort
otError otIp6RemoveUnsecurePort( otInstance *aInstance, uint16_t aPort )
تتم إزالة منفذ من قائمة المنافذ غير الآمنة المسموح بها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otIp6ResetBorderRoutingCounters
void otIp6ResetBorderRoutingCounters( otInstance *aInstance )
يؤدي هذا الخيار إلى إعادة ضبط عدّادات توجيه الحدود.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otIp6SelectSourceAddress
otError otIp6SelectSourceAddress( otInstance *aInstance, otMessageInfo *aMessageInfo )
اختَر اختيار عنوان مصدر OpenThread.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
OtIp6إرسال
otError otIp6Send( otInstance *aInstance, otMessage *aMessage )
تُرسِل مخطّط بيانات IPv6 من خلال واجهة Thread.
المتّصل ينقل ملكية aMessage
عند إجراء هذه المكالمة. سيفتح OpenThread aMessage
عند اكتمال المعالجة، بما في ذلك عند عرض قيمة أخرى غير OT_ERROR_NONE
.
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||
قيم الإرجاع |
|
otIp6SetAddressCallback
void otIp6SetAddressCallback( otInstance *aInstance, otIp6AddressCallback aCallback, void *aCallbackContext )
تسجِّل معاودة الاتصال للإبلاغ عن تغييرات عنوان IPv6 الداخلية.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6SetEnabled
otError otIp6SetEnabled( otInstance *aInstance, bool aEnabled )
لعرض واجهة IPv6 للأعلى أو للأسفل.
اتصل بهذا الأمر لتفعيل اتصال IPv6 أو إيقافه.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6SetMeshLocalIid
otError otIp6SetMeshLocalIid( otInstance *aInstance, const otIp6InterfaceIdentifier *aIid )
تُحدّد معرّف الشبكة المتداخلة المتداخلة (للاختبار).
متاح فقط عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otIp6SetSetcastPromiscuousEnabled
void otIp6SetMulticastPromiscuousEnabled( otInstance *aInstance, bool aEnabled )
تعمل هذه السياسة على تفعيل أو إيقاف وضع البث المتعدد الإرسال على واجهة "سلسلة المحادثات".
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otIp6IsMulticastPromiscuousEnabled
otIp6SetSetCallback
void otIp6SetReceiveCallback( otInstance *aInstance, otIp6ReceiveCallback aCallback, void *aCallbackContext )
تسجّل معاودة الاتصال لتقديم مخططات بيانات IPv6 المستلمة.
بشكل تلقائي، لا تجتاز معاودة الاتصال هذه حركة التحكّم في سلسلة المحادثات. يُرجى الاطّلاع على otIp6SetSetfilterEnabled() لتغيير إعدادات فلتر الزيارات الواردة في سلسلة المحادثات.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6Is الاستلامfilterEnabled
otIp6Set الاستلامfilterEnabled
otIp6SetSetfilterEnabled
void otIp6SetReceiveFilterEnabled( otInstance *aInstance, bool aEnabled )
تُحدِّد هذه السياسة ما إذا كانت تتم فلترة زيارات التحكُّم في سلاسل المحادثات أم لا عند إرسال مخططات بيانات IPv6 عبر استدعاء الاتصال المحدَّد في otIp6SetSetCallback().
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otIp6Set الاستلامCallback
otIs الأغانيIp6filterEnabled
otIp6SetSlaacEnabled
void otIp6SetSlaacEnabled( otInstance *aInstance, bool aEnabled )
تفعيل/إيقاف وحدة SLAAC
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE
.
عند تفعيل وحدة SLAAC، تتم إضافة عناوين SLAAC (استنادًا إلى البادئات المتداخلة) في بيانات الشبكة إلى الواجهة. عند إيقاف وحدة SLAAC، تتم إزالة أي عنوان SLAAC سبق إضافته.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otIp6SetSlaacPrefixfilter
void otIp6SetSlaacPrefixFilter( otInstance *aInstance, otIp6SlaacPrefixFilter aFilter )
ضبط معالج فلتر وحدة اتفاقية مستوى الخدمة
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE
.
يتم طلب معالج الفلتر من خلال وحدة SLAAC عندما تكون على وشك إضافة عنوان SLAAC استنادًا إلى بادئة لتحديد ما إذا كان يجب إضافة العنوان أم لا.
أوقف معالج فلتر NULL الفلترة، ويسمح بإضافة جميع عناوين SLAAC.
إذا لم يتم استدعاء هذه الدالة، سيكون الفلتر التلقائي الذي تستخدمه وحدة 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
من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otIp6SignMulticastAddress
otError otIp6SubscribeMulticastAddress( otInstance *aInstance, const otIp6Address *aAddress )
تعمل هذه السياسة على ربط واجهة Thread بعنوان البث المتعدد لواجهة الشبكة.
سيتم نسخ المثيل aAddress
الذي تم تمريره من خلال واجهة Thread. لا تتوافق واجهة Thread إلا مع عدد ثابت من عناوين البث المتعدد التي تتم إضافتها خارجيًا. يمكنك الاطّلاع على OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS
.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otIp6إلغاء الاشتراك
otError otIp6UnsubscribeMulticastAddress( otInstance *aInstance, const otIp6Address *aAddress )
إلغاء الاشتراك من واجهة Thread في عنوان البث المتعدد على واجهة الشبكة
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
وحدات ماكرو
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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.