דף זה תורגם על ידי Cloud Translation API.

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 }`	טיפוסים בני מנייה (enum) מספרי פרוטוקול אינטרנט.
`anonymous enum{ OT_ADDRESS_ORIGIN_THREAD = 0, OT_ADDRESS_ORIGIN_SLAAC = 1, OT_ADDRESS_ORIGIN_DHCPV6 = 2, OT_ADDRESS_ORIGIN_MANUAL = 3 }`	טיפוסים בני מנייה (enum) מקורות של כתובות IPv6.
`anonymous enum{ OT_ECN_NOT_CAPABLE = 0x0, OT_ECN_CAPABLE_0 = 0x2, OT_ECN_CAPABLE_1 = 0x1, OT_ECN_MARKED = 0x3 }`	טיפוסים בני מנייה (enum) סטטוסים של ECN, מיוצגים בכותרת ה-IP.

ערכי דף
`otBorderRoutingCounters`	typedef `struct otBorderRoutingCounters` מייצג את המונים של החבילות שהועברו דרך Border Routing.
`otIp6Address`	typedef `struct otIp6Address` מייצג כתובת IPv6.
`otIp6AddressCallback)(const otIp6AddressInfo aAddressInfo, bool aIsAdded, void aContext)`	typedef `void(*` המערכת מפעילה את המצביע כאשר מוסיפים או מסירים כתובת IPv6 פנימית.
`otIp6AddressComponents`	typedef `struct otIp6AddressComponents` מייצג את הרכיבים של כתובת IPv6.
`otIp6AddressInfo`	typedef `struct otIp6AddressInfo` מייצג את פרטי כתובת ה-IPv6.
`otIp6InterfaceIdentifier`	typedef `struct otIp6InterfaceIdentifier` מייצג את מזהה הממשק של כתובת IPv6.
`otIp6NetworkPrefix`	typedef `struct otIp6NetworkPrefix` מייצג את קידומת הרשת של כתובת 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` מייצג את כתובות ה-socket המקומיות והשכנות של IPv6.
`otNetifAddress`	typedef `struct otNetifAddress` מייצג כתובת Unicode של ממשק רשת IPv6.
`otNetifMulticastAddress`	typedef `struct otNetifMulticastAddress` מייצג כתובת Multicast של ממשק רשת IPv6.
`otPacketsAndBytes`	typedef `struct otPacketsAndBytes` מייצג את המונים של חבילות ובייטים.
`otSockAddr`	typedef `struct otSockAddr` מייצג כתובת שקע IPv6.

משתנים
`OT_TOOL_PACKED_END`	`OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier`

פונקציות
`otIp6AddUnicastAddress(otInstance aInstance, const otNetifAddress aAddress)`	`otError` הוספה של כתובת ממשק רשת לממשק Thread.
`otIp6AddUnsecurePort(otInstance *aInstance, uint16_t aPort)`	`otError` הוספה של יציאה לרשימת היציאות הלא מאובטחות.
`otIp6AddressFromString(const char aString, otIp6Address aAddress)`	`otError` ממירה מחרוזת של כתובת 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 *` הפונקציה מקבלת את רשימת כתובות ה-Multicast של 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 *` מחזירה מצביע לרשימת היציאות הלא מאובטחות.
`otIp6HasUnicastAddress(otInstance aInstance, const otIp6Address aAddress)`	`bool` מציינת אם מוקצית כתובת IPv6 אחידה לממשק של פרוטוקול Thread.
`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` ההגדרה מציינת אם התנועה של בקרת Thread מסוננת כשמעבירים גרפים של IPv6 דרך הקריאה החוזרת (callback) שמצוינת ב-otIp6SetReceiveCallback().
`otIp6IsSlaacEnabled(otInstance *aInstance)`	`bool` התנאי מציין אם מודול SLAAC מופעל או לא.
`otIp6NewMessage(otInstance aInstance, const otMessageSettings aSettings)`	`otMessage *` הקצאת מאגר הודעות חדש לשליחת הודעה מסוג IPv6.
`otIp6NewMessageFromBuffer(otInstance aInstance, const uint8_t aData, uint16_t aDataLength, const otMessageSettings *aSettings)`	`otMessage *` הקצאת מאגר הודעות חדש וכתיבת ה-datagram של IPv6 למאגר ההודעות לצורך שליחת הודעת IPv6.
`otIp6PrefixFromString(const char aString, otIp6Prefix aPrefix)`	`otError` ממירה מחרוזת של קידומת 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)`	`otError` רושם מעבדי Multicast לנתב שדרה ראשי.
`otIp6RemoveAllUnsecurePorts(otInstance *aInstance)`	`void` מסירה את כל היציאות מרשימת היציאות הלא מאובטחות המותרות.
`otIp6RemoveUnicastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` הסרה של כתובת ממשק רשת מממשק Thread.
`otIp6RemoveUnsecurePort(otInstance *aInstance, uint16_t aPort)`	`otError` מסירה יציאה מרשימת היציאות הלא מאובטחות.
`otIp6ResetBorderRoutingCounters(otInstance *aInstance)`	`void` איפוס המונים של ניתוב הגבול.
`otIp6SelectSourceAddress(otInstance aInstance, otMessageInfo aMessageInfo)`	`otError` בחירת כתובת של מקור OpenThread.
`otIp6Send(otInstance aInstance, otMessage aMessage)`	`otError` נשלחת גרם נתונים של IPv6 דרך הממשק של פרוטוקול Thread.
`otIp6SetAddressCallback(otInstance aInstance, otIp6AddressCallback aCallback, void aCallbackContext)`	`void` רושם קריאה חוזרת (callback) כדי להודיע על שינויים פנימיים בכתובת IPv6.
`otIp6SetEnabled(otInstance *aInstance, bool aEnabled)`	`otError` מעלה או מטה את ממשק IPv6.
`otIp6SetMeshLocalIid(otInstance aInstance, const otIp6InterfaceIdentifier aIid)`	`otError` מגדיר את Mesh Local IID (למטרות בדיקה).
`otIp6SetMulticastPromiscuousEnabled(otInstance *aInstance, bool aEnabled)`	`void` מפעילה או משביתה מצב פרוץ מרובת-שידורים בממשק של פרוטוקול Thread.
`otIp6SetReceiveCallback(otInstance aInstance, otIp6ReceiveCallback aCallback, void aCallbackContext)`	`void` רושם קריאה חוזרת (callback) כדי לספק משתני נתונים של IPv6 שהתקבלו.
`otIp6SetReceiveFilterEnabled(otInstance *aInstance, bool aEnabled)`	`void` המדיניות הזו קובעת אם התנועה של בקרת שרשור תסונן כשמעבירים דגימות נתונים של IPv6 דרך הקריאה החוזרת (callback) שמצוינת ב-otIp6SetReceiveCallback().
`otIp6SetSlaacEnabled(otInstance *aInstance, bool aEnabled)`	`void` הפעלה או השבתה של מודול SLAAC.
`otIp6SetSlaacPrefixFilter(otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)`	`void` הגדרת הגורם המטפל במסנן SLAAC.
`otIp6SockAddrToString(const otSockAddr aSockAddr, char aBuffer, uint16_t aSize)`	`void` ממירה כתובת שקע IPv6 נתונה למחרוזת שאנשים יכולים לקרוא.
`otIp6SubscribeMulticastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` רושם את ממשק Thread לכתובת Multicast של ממשק הרשת.
`otIp6UnsubscribeMulticastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` ביטול הרישום של ממשק Thread לכתובת מרובת שידורים של ממשק רשת.

מבנים
otBorderRoutingCounters	מייצג את המונים של החבילות שהועברו דרך Border Routing.
otIp6Address	מייצג כתובת IPv6.
otIp6AddressComponents	מייצג את הרכיבים של כתובת IPv6.
otIp6AddressInfo	מייצג את פרטי כתובת ה-IPv6.
otIp6InterfaceIdentifier	מייצג את מזהה הממשק של כתובת IPv6.
otIp6NetworkPrefix	מייצג את קידומת הרשת של כתובת IPv6 (המשמעותיים ביותר היא 64 סיביות של הכתובת).
otIp6Prefix	מייצג קידומת IPv6.
otMessageInfo	מייצג את כתובות ה-socket המקומיות והשכנות של IPv6.
otNetifAddress	מייצג כתובת Unicode של ממשק רשת IPv6.
otNetifMulticastAddress	מייצג כתובת Multicast של ממשק רשת IPv6.
otPacketsAndBytes	מייצג את המונים של חבילות ובייטים.
otSockAddr	מייצג כתובת שקע IPv6.

התאגדויות
otIp6InterfaceIdentifier::OT_TOOL_PACKED_FIELD

ספירות

טיפוסים אנונימיים

 anonymous enum

מספרי פרוטוקול אינטרנט.

תכונות
`OT_IP6_PROTO_DST_OPTS`	אפשרויות יעד עבור IPv6.
`OT_IP6_PROTO_FRAGMENT`	Fragment Header עבור IPv6.
`OT_IP6_PROTO_HOP_OPTS`	אפשרות IPv6 Hop-by-Hop.
`OT_IP6_PROTO_ICMP6`	ICMP ל-IPv6.
`OT_IP6_PROTO_IP6`	אנקפסולציה של IPv6.
`OT_IP6_PROTO_NONE`	אין כותרת הבאה ל-IPv6.
`OT_IP6_PROTO_ROUTING`	כותרת ניתוב ל-IPv6.
`OT_IP6_PROTO_TCP`	Transmission Control Protocol (פרוטוקול בקרת שידור).
`OT_IP6_PROTO_UDP`	User Datagram.

טיפוסים אנונימיים

 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`	לא EECT.

ערכי דף

otBorderRoutingCounters

struct otBorderRoutingCounters otBorderRoutingCounters

מייצג את המונים של החבילות שהועברו דרך Border Routing.

otIp6Address

struct otIp6Address otIp6Address

מייצג כתובת IPv6.

otIp6AddressCallback

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

המערכת מפעילה את המצביע כאשר מוסיפים או מסירים כתובת IPv6 פנימית.

פרטים

פרמטרים

`[in] aAddressInfo`	מצביע לפרטי כתובת IPv6.
`[in] aIsAdded`	TRUE אם `aAddress` התווסף, FALSE אם `aAddress` הוסר.
`[in] aContext`	הפניה להקשר ספציפי לאפליקציה.

otIp6AddressComponents

struct otIp6AddressComponents otIp6AddressComponents

מייצג את הרכיבים של כתובת IPv6.

otIp6AddressInfo

struct otIp6AddressInfo otIp6AddressInfo

מייצג את פרטי כתובת ה-IPv6.

otIp6InterfaceIdentifier

struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

מייצג את מזהה הממשק של כתובת IPv6.

otIp6NetworkPrefix

struct otIp6NetworkPrefix otIp6NetworkPrefix

מייצג את קידומת הרשת של כתובת IPv6 (המשמעותיים ביותר היא 64 סיביות של הכתובת).

otIp6Prefix

struct otIp6Prefix otIp6Prefix

מייצג קידומת IPv6.

otIp6ReceiveCallback

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

מתבצעת הפעלה של המצביע כאשר מתקבלת גרם נתונים של IPv6.

פרטים

פרמטרים

[in] aMessage

מצביע למאגר הנתונים הזמני של ההודעות שמכיל את גרם הנתונים של IPv6 שהתקבלו. הפונקציה הזו מעבירה את הבעלות של aMessage לנמען של הקריאה החוזרת. מי שמקבל את הקריאה החוזרת יוכל לשחרר את ההודעה אחרי שהיא תעובד (אפשר לעיין ב-otMessageFree()).

[in] aContext

הפניה להקשר ספציפי לאפליקציה.

otIp6RegisterMulticastListenersCallback

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, OT_ERROR_BROWSER_OFFSET כאשר נכשל בקבלת MLR.rsp, OT_ERROR_PARSE כשניתוח MLR.rsp נכשל.
`[in] aMlrStatus`	סטטוס הרישום של ה-Multicast Listener כאשר `aError` הוא OT_ERROR_NONE.
`[in] aFailedAddresses`	מצביע על כתובות IPv6 שנכשלו כאשר `aError` הוא OT_ERROR_NONE.
`[in] aFailedAddressNum`	מספר כתובות IPv6 שנכשלו כאשר `aError` הוא OT_ERROR_NONE.

ראו גם:
otIp6RegisterMulticastListeners

otIp6SlaacPrefixFilter

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

המצביע מאפשר למשתמש לסנן תחיליות ולא לאפשר הוספה של כתובת SLAAC על סמך קידומת.

ניתן להשתמש ב-otIp6SetSlaacPrefixFilter() כדי להגדיר את ה-handler של המסנן. הגורם המטפל במסנן מופעל על ידי מודול SLAAC כשהוא עומד להוסיף כתובת SLAAC על סמך קידומת. הערך הבוליאני המוחזר קובע אם הכתובת מסוננת (לא נוספה) או לא.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aPrefix`	מצביע לקידומת שבה כתובת SLAAC עומדת להתווסף.

ערכים מוחזרים

`TRUE`	מציין שיש לסנן את כתובת ה-SLAAC המבוססת על הקידומת ולא להוסיף אותה.
`FALSE`	מציין שיש להוסיף את כתובת ה-SLAAC המבוססת על הקידומת.

otMessageInfo

struct otMessageInfo otMessageInfo

מייצג את כתובות ה-socket המקומיות והשכנות של IPv6.

otNetifAddress

struct otNetifAddress otNetifAddress

מייצג כתובת Unicode של ממשק רשת IPv6.

otNetifMulticastAddress

struct otNetifMulticastAddress otNetifMulticastAddress

מייצג כתובת Multicast של ממשק רשת 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
)

הוספה של כתובת ממשק רשת לממשק Thread.

המכונה שהועברה aAddress מועתקת על ידי הממשק של פרוטוקול Thread. ממשק השרשור תומך רק במספר קבוע של כתובות Unicode שנוספו באופן חיצוני. 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 (אסור להיות NULL).
`[out] aBuffer`	מצביע למערך תווים כדי להפיק את המחרוזת (לא יכול להיות 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
)

קבלת המונים של ניתוב הגבול.

צריך להפעיל את תכונת זמן ה-build של OPENTHREAD_CONFIG_IP6_BR_COUNTERS_ENABLE.

פרטים

פרמטרים

[in] aInstance

מצביע למופע של OpenThread.

החזרות

מצביע על המונים של ניתוב הגבול.

otIp6GetMulticastAddresses

const otNetifMulticastAddress * otIp6GetMulticastAddresses(
  otInstance *aInstance
)

הפונקציה מקבלת את רשימת כתובות ה-Multicast של IPv6 שנרשמו לממשק של פרוטוקול Thread.

פרטים

פרמטרים

[in] aInstance

מצביע למופע של OpenThread.

החזרות

מצביע על הכתובת הראשונה של Multicast בממשק הרשת.

otIp6GetPrefix

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`	מספר הפריטים ברשימה.

החזרות

מצביע לרשימת היציאות הלא מאובטחות.

otIp6HasUnicastAddress

bool otIp6HasUnicastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

מציינת אם מוקצית כתובת IPv6 אחידה לממשק של פרוטוקול Thread.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aAddress`	מצביע לכתובת ב-Uncast.

ערכים מוחזרים

`TRUE`	אם `aAddress` מוקצה לממשק של פרוטוקול Thread.
`FALSE`	אם `aAddress` לא מוקצה לממשק של פרוטוקול Thread.

otIp6IsAddressEqual

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

בדיקה אם שתי כתובות IPv6 זהות.

פרטים

פרמטרים

`[in] aFirst`	מצביע לכתובת ה-IPv6 הראשונה להשוואה.
`[in] aSecond`	מצביע לכתובת ה-IPv6 השנייה להשוואה.

ערכים מוחזרים

`TRUE`	שתי כתובות IPv6 זהות.
`FALSE`	שתי כתובות IPv6 אינן זהות.

otIp6IsAddressUnspecified

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

otIp6IsReceiveFilterEnabled

bool otIp6IsReceiveFilterEnabled(
  otInstance *aInstance
)

ההגדרה מציינת אם התנועה של בקרת Thread מסוננת כשמעבירים גרפים של IPv6 דרך הקריאה החוזרת (callback) שמצוינת ב-otIp6SetReceiveCallback().

פרטים

פרמטרים

[in] aInstance

מצביע למופע של OpenThread.

החזרות

הערך יהיה TRUE אם התנועה של בקרת Thread מסוננת, אחרת FALSE.

מידע נוסף מופיע גם:
otIp6SetReceiveCallback
otIp6SetReceiveFilterEnabled

otIp6IsSlaacEnabled

bool otIp6IsSlaacEnabled(
  otInstance *aInstance
)

התנאי מציין אם מודול SLAAC מופעל או לא.

צריך להפעיל את תכונת זמן ה-build של OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

פרטים

ערכים מוחזרים

`TRUE`	מודול SLAAC מופעל.
`FALSE`	מודול SLAAC מושבת.

otIp6NewMessage

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

הקצאת מאגר הודעות חדש לשליחת הודעה מסוג IPv6.

הערה: אם הערך של aSettings הוא 'NULL', האבטחה של שכבת הקישור מופעלת ועדיפות ההודעה היא OT_MESSAGE_PRIORITY_NORMAL כברירת מחדל.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aSettings`	מעבר עם הסמן להגדרות ההודעה או על NULL כדי לקבוע את הגדרות ברירת המחדל.

החזרות

מעבר למאגר הנתונים הזמני של ההודעות או NULL אם אין מאגרי הודעות זמינים או אם הפרמטרים לא חוקיים.

ראו גם:
otMessageFree

otIp6NewMessageFromBuffer

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

הקצאת מאגר הודעות חדש וכתיבת ה-datagram של IPv6 למאגר ההודעות לצורך שליחת הודעת IPv6.

הערה: אם הערך של aSettings הוא NULL, האבטחה של שכבת הקישור מופעלת והעדיפות של ההודעה מתקבלת מהודעת ה-IPv6 עצמה. אם הערך של aSettings הוא לא NULL, המערכת תתעלם מה-aSetting->mPriority ותתקבל מהודעת IPv6 עצמה.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aData`	מצביע למאגר הנתונים הזמני של IPv6.
`[in] aDataLength`	גודל מאגר הנתונים הזמני של IPv6 שהוצמד על ידי `aData`.
`[in] aSettings`	מעבר עם הסמן להגדרות ההודעה או על NULL כדי לקבוע את הגדרות ברירת המחדל.

החזרות

מצביע אל ההודעה או NULL אם יש כותרת IPv6 שגויה או שיש כמות לא מספיקה של מאגרי הודעות.

ראו גם:
otMessageFree

otIp6PrefixFromString

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 נכשל.

otIp6PrefixMatch

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".

פרטים

פרמטרים

`[in] aPrefix`	מצביע לקידומת IPv6 (אסור להיות NULL).
`[out] aBuffer`	מצביע למערך תווים כדי להפיק את המחרוזת (לא יכול להיות NULL).
`[in] aSize`	הגודל של `aBuffer` (בבייטים). מומלץ להשתמש ב-`OT_IP6_PREFIX_STRING_SIZE`.

otIp6ProtoToString

const char * otIp6ProtoToString(
  uint8_t aIpProto
)

ממירה מספר של פרוטוקול IP נתון למחרוזת שאנשים יכולים לקרוא.

פרטים

פרמטרים

[in] aIpProto

מספר פרוטוקול IP (ספירת OT_IP6_PROTO_*).

החזרות

מחרוזת שמייצגת את aIpProto.

otIp6RegisterMulticastListeners

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

רושם מעבדי Multicast לנתב שדרה ראשי.

חובה להפעיל את OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE ואת OPENTHREAD_CONFIG_COMMISSIONER_ENABLE.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aAddresses`	מערך של כתובות Multicast להרשמה.
`[in] aAddressNum`	מספר הכתובות של שידורים מרובים שיש לרשום (0 אם `aAddresses` הוא NULL).
`[in] aTimeout`	מצביע על ערך הזמן הקצוב (בשניות) שייכלל ב-MLR.req. ערך הזמן הקצוב לתפוגה של 0 מסיר את המאזין התואם Multicast. אם הערך הוא 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 (למשל, Commissioner לא התחיל, לא נמצא נתב שדרה ראשי).
`OT_ERROR_NO_BUFS`	אם אין מספיק מאגרי הודעות זמינים.

ראו גם:
otIp6RegisterMulticastListenersCallback

otIp6RemoveAllUnsecurePorts

void otIp6RemoveAllUnsecurePorts(
  otInstance *aInstance
)

מסירה את כל היציאות מרשימת היציאות הלא מאובטחות המותרות.

פרטים

פרמטרים

[in] aInstance

מצביע למופע של OpenThread.

otIp6RemoveUnicastAddress

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
)

מסירה יציאה מרשימת היציאות הלא מאובטחות.

הערה: הפונקציה הזו מסירה את aPort על ידי החלפה של aPort ברכיב אחרי aPort ברשימת היציאות הפנימית. חשוב להיזהר כשמבצעים קריאה ל-otIp6GetUnsecurePorts() ואחריה otIp6RemoveUnsecurePort() כדי להסיר יציאות לא מאובטחות.

פרטים

פרמטרים

`[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` נשארה ללא שינוי.

otIp6Send

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`	לא ניתן להקצות את מאגרי הנתונים הדרושים של ההודעות במהלך עיבוד ה-Datagram.
`OT_ERROR_NO_ROUTE`	לא נמצא נתיב למארח.
`OT_ERROR_INVALID_SOURCE_ADDRESS`	כתובת המקור אינה חוקית, למשל כתובת anycast או כתובת שידור לקבוצה.
`OT_ERROR_PARSE`	אירעה כותרת לא תקינה במהלך עיבוד ההודעה.
`OT_ERROR_INVALID_ARGS`	המטא-נתונים של ההודעה לא חוקיים. לדוגמה, המקור של ההודעה הוא `OT_MESSAGE_ORIGIN_THREAD_NETIF`.

otIp6SetAddressCallback

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

רושם קריאה חוזרת (callback) כדי להודיע על שינויים פנימיים בכתובת 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, אחרת FALSE.

ערכים מוחזרים

`OT_ERROR_NONE`	העלאה/הורדה של ממשק IPv6 בוצעה בהצלחה.
`OT_ERROR_INVALID_STATE`	ממשק IPv6 לא זמין כי המכשיר פועל במצב RAW-link (רלוונטי רק כשהתכונה `OPENTHREAD_CONFIG_LINK_RAW_ENABLE` מופעלת).

otIp6SetMeshLocalIid

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

מגדיר את Mesh Local IID (למטרות בדיקה).

נדרש OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aIid`	מצביע על רשת ה-IID המקומי כדי להגדיר.

ערכים מוחזרים

`OT_ERROR_NONE`	רשת ה-IID המקומית הוגדרה בהצלחה.
`OT_ERROR_INVALID_STATE`	הפרוטוקולים של השרשור מופעלים.

otIp6SetMulticastPromiscuousEnabled

void otIp6SetMulticastPromiscuousEnabled(
  otInstance *aInstance,
  bool aEnabled
)

מפעילה או משביתה מצב פרוץ מרובת-שידורים בממשק של פרוטוקול Thread.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aEnabled`	יש להזין TRUE כדי להפעיל את מצב Multicast Promiscuous של Multicast. אחרת, צריך להזין FALSE.

ראו גם:
otIp6IsMulticastPromiscuousEnabled

otIp6SetReceiveCallback

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

רושם קריאה חוזרת (callback) כדי לספק משתני נתונים של IPv6 שהתקבלו.

כברירת מחדל, הקריאה החוזרת (callback) הזו לא מעבירה את התנועה של בקרת Thread. כדי לשנות את ההגדרה של מסנן התנועה בבקרת שרשור, אפשר לעיין בקטע otIp6SetReceiveFilterEnabled().

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aCallback`	מצביע לפונקציה שנקראת כאשר מתקבלת גרם נתונים של IPv6, או NULL כדי להשבית את הקריאה החוזרת.
`[in] aCallbackContext`	הפניה להקשר ספציפי לאפליקציה.

כדאי לעיין גם:
otIp6IsReceiveFilterEnabled
otIp6SetReceiveFilterEnabled

otIp6SetReceiveFilterEnabled

void otIp6SetReceiveFilterEnabled(
  otInstance *aInstance,
  bool aEnabled
)

המדיניות הזו קובעת אם התנועה של בקרת שרשור תסונן כשמעבירים דגימות נתונים של IPv6 דרך הקריאה החוזרת (callback) שמצוינת ב-otIp6SetReceiveCallback().

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aEnabled`	הערך יהיה TRUE אם התנועה של בקרת Thread מסוננת, אחרת FALSE.

כדאי לעיין גם במאמרים הבאים:
otIp6SetReceiveCallback
otIsReceiveIp6FilterEnabled

otIp6SetSlaacEnabled

void otIp6SetSlaacEnabled(
  otInstance *aInstance,
  bool aEnabled
)

הפעלה או השבתה של מודול SLAAC.

צריך להפעיל את תכונת זמן ה-build של OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

כשמודול SLAAC מופעל, כתובות SLAAC (מבוססות על קידומות on-mesh בנתוני הרשת) מתווספות לממשק. כאשר מודול SLAAC מושבת, מתבצעת הסרה של כל כתובת SLAAC שנוספו בעבר.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aEnabled`	TRUE להפעלה, FALSE כדי להשבית.

otIp6SetSlaacPrefixFilter

void otIp6SetSlaacPrefixFilter(
  otInstance *aInstance,
  otIp6SlaacPrefixFilter aFilter
)

הגדרת הגורם המטפל במסנן SLAAC.

צריך להפעיל את תכונת זמן ה-build של OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

ה-handler של המסנן נקרא על ידי מודול SLAAC כשהוא עומד להוסיף כתובת SLAAC על סמך קידומת, כדי לקבוע אם יש להוסיף את הכתובת או לא.

גורם handler של מסנן NULL משבית את הסינון ומאפשר להוסיף את כל כתובות SLAAC.

אם לא תתבצע קריאה לפונקציה, מסנן ברירת המחדל המשמש את מודול SLAAC יהיה NULL (הסינון מושבת).

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aFilter`	מפנה ל-handler של מסנן התחילית SLAAC, או ל-NULL כדי להשבית את הסינון.

otIp6SockAddrToString

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

ממירה כתובת שקע IPv6 נתונה למחרוזת שאנשים יכולים לקרוא.

הפורמט של מחרוזת השקע של IPv6 הוא [address]:port. address מוצג כ-16 ערכים הקסדצימליים של : ו-port הוא מספר היציאה בפורמט עשרוני. לדוגמה: "[%x:%x:...:%x]:%u" .

פרטים

פרמטרים

`[in] aSockAddr`	מצביע לכתובת שקע IPv6 (לא צריך להיות NULL).
`[out] aBuffer`	מצביע למערך תווים כדי להפיק את המחרוזת (לא יכול להיות NULL).
`[in] aSize`	הגודל של `aBuffer` (בבייטים). מומלץ להשתמש ב-`OT_IP6_SOCK_ADDR_STRING_SIZE`.

otIp6SubscribeMulticastAddress

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

רושם את ממשק Thread לכתובת Multicast של ממשק הרשת.

המכונה aAddress שהועברה במכונה יועתק על ידי הממשק של פרוטוקול Thread. ממשק ה-thread תומך רק במספר קבוע של כתובות Multicast שנוספו באופן חיצוני. OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aAddress`	מצביע לכתובת IP.

ערכים מוחזרים

`OT_ERROR_NONE`	נרשמת בהצלחה לכתובת Multicast של ממשק הרשת.
`OT_ERROR_ALREADY`	הכתובת של Multicast כבר רשומה.
`OT_ERROR_INVALID_ARGS`	כתובת ה-IP שצוינה ב-`aAddress` היא כתובת לא חוקית של Multicast.
`OT_ERROR_REJECTED`	כתובת ה-IP שמצוינת ב-`aAddress` היא כתובת פנימית מרובת שידורים.
`OT_ERROR_NO_BUFS`	ממשק הרשת כבר מאחסן את המספר המרבי של כתובות שידור חיצוני מותרות.

otIp6UnsubscribeMulticastAddress

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

ביטול הרישום של ממשק Thread לכתובת מרובת שידורים של ממשק רשת.

פרטים

פרמטרים

`[in] aInstance`	מצביע למופע של OpenThread.
`[in] aAddress`	מצביע לכתובת IP.

ערכים מוחזרים

`OT_ERROR_NONE`	ההרשמה ל'כתובת Multicast של ממשק הרשת' בוטלה בהצלחה.
`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_HEADER_PROTO_OFFSET

 OT_IP6_HEADER_PROTO_OFFSET 6

קיזוז שדה האב בכותרת IPv6 (בייטים)

OT_IP6_HEADER_SIZE

 OT_IP6_HEADER_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 שנתמך על ידי רישום של Multicast Listener.

OT_IP6_PREFIX_BITSIZE

 OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

גודל קידומת IPv6 (ביטים)

OT_IP6_PREFIX_SIZE

 OT_IP6_PREFIX_SIZE 8

גודל קידומת IPv6 (בייטים)

OT_IP6_PREFIX_STRING_SIZE

 OT_IP6_PREFIX_STRING_SIZE 45

הגודל המומלץ לייצוג מחרוזת של קידומת IPv6.

OT_IP6_SOCK_ADDR_STRING_SIZE

 OT_IP6_SOCK_ADDR_STRING_SIZE 48

הגודל המומלץ לייצוג מחרוזת של כתובת שקע IPv6.

מקורות מידע

המקור של נושאי העזר של OpenThread API הוא קוד המקור, שזמין ב-GitHub. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.

IPv6

סיכום

ספירות

ערכי דף

משתנים

פונקציות

מבנים

התאגדויות

ספירות

טיפוסים אנונימיים

טיפוסים אנונימיים

טיפוסים אנונימיים

ערכי דף

otBorderRoutingCounters

otIp6Address

otIp6AddressCallback

otIp6AddressComponents

otIp6AddressInfo

otIp6InterfaceIdentifier

otIp6NetworkPrefix

otIp6Prefix

otIp6ReceiveCallback

otIp6RegisterMulticastListenersCallback

otIp6SlaacPrefixFilter

otMessageInfo

otNetifAddress

otNetifMulticastAddress

otPacketsAndBytes

otSockAddr

משתנים

OT_TOOL_PACKED_END

פונקציות

otIp6AddUnicastAddress

otIp6AddUnsecurePort

otIp6AddressFromString

otIp6AddressToString

otIp6ArePrefixesEqual

otIp6GetBorderRoutingCounters

otIp6GetMulticastAddresses

otIp6GetPrefix

otIp6GetUnicastAddresses

otIp6GetUnsecurePorts

otIp6HasUnicastAddress

otIp6IsAddressEqual

otIp6IsAddressUnspecified

otIp6IsEnabled

otIp6IsMulticastPromiscuousEnabled

otIp6IsReceiveFilterEnabled

otIp6IsSlaacEnabled

otIp6NewMessage

otIp6NewMessageFromBuffer

otIp6PrefixFromString

otIp6PrefixMatch

otIp6PrefixToString

otIp6ProtoToString

otIp6RegisterMulticastListeners

otIp6RemoveAllUnsecurePorts

otIp6RemoveUnicastAddress

otIp6RemoveUnsecurePort

otIp6ResetBorderRoutingCounters

otIp6SelectSourceAddress

otIp6Send

otIp6SetAddressCallback

otIp6SetEnabled

otIp6SetMeshLocalIid

otIp6SetMulticastPromiscuousEnabled

otIp6SetReceiveCallback

otIp6SetReceiveFilterEnabled

otIp6SetSlaacEnabled

otIp6SetSlaacPrefixFilter

otIp6SockAddrToString

otIp6SubscribeMulticastAddress

otIp6UnsubscribeMulticastAddress

פקודות מאקרו

OT_IP6_ADDRESS_SIZE

OT_IP6_ADDRESS_STRING_SIZE

OT_IP6_HEADER_PROTO_OFFSET

OT_IP6_HEADER_SIZE

OT_IP6_IID_SIZE

OT_IP6_MAX_MLR_ADDRESSES