Halaman ini diterjemahkan oleh Cloud Translation API.

nl::Inet::InetLayer

#include <src/inet/InetLayer.h>

Layanan ini menyediakan akses ke layanan Internet, termasuk timer, resolusi Domain Name System (DNS), transport jaringan TCP, transport jaringan UDP, dan transport jaringan mentah, untuk satu thread.

Ringkasan

Untuk Soket BSD/POSIX, notifikasi kesiapan peristiwa ditangani melalui deskriptor file dan implementasi polling / pilihan tradisional pada adaptasi platform.

Untuk LwIP, notifikasi kesiapan peristiwa ditangani melalui peristiwa / pesan dan hook khusus platform dan sistem untuk peristiwa / sistem pesan.

Konstruktor dan Destruktor
`InetLayer(void)` Ini adalah konstruktor default InetLayer.

Jenis publik
`@5{ kState_NotInitialized = 0, kState_Initialized = 1, kState_ShutdownInProgress = 2 }`	enum Status objek InetLayer saat ini.
`DNSResolveCompleteFunct`	typedef `DNSResolver::OnResolveCompleteFunct`

Atribut publik
`State`	`enum nl::Inet::InetLayer::@5` Status objek InetLayer saat ini.

Atribut statis publik
`sInetEventHandlerDelegate`	`Weave::System::LwIPEventHandlerDelegate`

Fungsi publik
`CanEnqueueDroppableEvent(void)`	`bool`
`CancelResolveHostAddress(DNSResolveCompleteFunct onComplete, void *appState)`	`void` Batalkan kueri DNS yang belum selesai (untuk callback penyelesaian dan status aplikasi yang cocok) yang mungkin masih aktif.
`DroppableEventDequeued(void)`	`void`
`GetInterfaceFromAddr(const IPAddress & addr, InterfaceId & intfId)`	`INET_ERROR` Mendapatkan ID antarmuka untuk alamat IP yang ditentukan.
`GetLinkLocalAddr(InterfaceId link, IPAddress *llAddr)`	`INET_ERROR` Mendapatkan alamat IPv6 lokal link untuk link atau antarmuka yang ditentukan.
`GetPlatformData(void)`	`void *` Tindakan ini akan menampilkan data platform khusus klien yang ditetapkan ke instance, jika sebelumnya telah ditetapkan.
`HandleSelectResult(int selectRes, fd_set readfds, fd_set writefds, fd_set *exceptfds)`	`void` Tangani I/O dari panggilan telepon tertentu.
`Init(Weave::System::Layer & aSystemLayer, void *aContext)`	`INET_ERROR` Ini adalah penginisialisasi eksplisit InetLayer.
`InitQueueLimiter(void)`	`INET_ERROR`
`MatchLocalIPv6Subnet(const IPAddress & addr)`	`bool` Periksa apakah ada pencocokan awalan antara alamat IPv6 yang ditentukan dan alamat IPv6 yang dikonfigurasi secara lokal.
`NewRawEndPoint(IPVersion ipVer, IPProtocol ipProto, RawEndPoint **retEndPoint)`	`INET_ERROR` Membuat objek RawEndPoint baru untuk versi IP dan protokol tertentu.
`NewTCPEndPoint(TCPEndPoint **retEndPoint)`	`INET_ERROR` Membuat objek TCPEndPoint baru.
`NewTunEndPoint(TunEndPoint **retEndPoint)`	`INET_ERROR` Membuat objek TunEndPoint baru.
`NewUDPEndPoint(UDPEndPoint **retEndPoint)`	`INET_ERROR` Membuat objek UDPEndPoint baru.
`PrepareSelect(int & nfds, fd_set readfds, fd_set writefds, fd_set *exceptfds, struct timeval & sleepTime)`	`void` Siapkan kumpulan deskripsi file untuk `select()` yang akan digunakan.
`ResolveHostAddress(const char hostName, uint16_t hostNameLen, uint8_t options, uint8_t maxAddrs, IPAddress addrArray, DNSResolveCompleteFunct onComplete, void *appState)`	`INET_ERROR` Melakukan resolusi alamat IP nama host yang ditentukan.
`ResolveHostAddress(const char hostName, uint16_t hostNameLen, uint8_t maxAddrs, IPAddress addrArray, DNSResolveCompleteFunct onComplete, void *appState)`	`INET_ERROR` Melakukan resolusi alamat IP nama host yang ditentukan.
`ResolveHostAddress(const char hostName, uint8_t maxAddrs, IPAddress addrArray, DNSResolveCompleteFunct onComplete, void *appState)`	`INET_ERROR` Melakukan resolusi alamat IP nama host yang ditentukan.
`SetPlatformData(void *aPlatformData)`	`void` Tindakan ini menetapkan data platform khusus klien yang ditentukan ke instance untuk diambil nanti oleh platform klien.
`Shutdown(void)`	`INET_ERROR` Ini adalah deinisialisasir eksplisit InetLayer dan harus dipanggil sebelum membuang instance InetLayer yang dibuat instance.
`SystemLayer(void) const`	`Weave::System::Layer *`

Fungsi statis publik
`HandleInetLayerEvent(Weave::System::Object & aTarget, Weave::System::EventType aEventType, uintptr_t aArgument)`	`Weave::System::Error`
`IsDroppableEvent(Weave::System::EventType aType)`	`bool`
`UpdateSnapshot(nl::Weave::System::Stats::Snapshot & aSnapshot)`	`void`

Jenis publik

@5

@5

Status objek InetLayer saat ini.

Properti
`kState_Initialized`	Menginisialisasi status.
`kState_NotInitialized`	Bukan status yang diinisialisasi.
`kState_ShutdownInProgress`	Status tempat Shutdown dipicu.

DNSResolveCompleteFunct

DNSResolver::OnResolveCompleteFunct DNSResolveCompleteFunct

Atribut publik

Negara bagian

enum nl::Inet::InetLayer::@5 State

Status objek InetLayer saat ini.

[HANYA BACA] Status saat ini.

Atribut statis publik

sInetEventHandlerDelegate

Weave::System::LwIPEventHandlerDelegate sInetEventHandlerDelegate

Fungsi publik

PeristiwaCanEnqueueDroppable

bool CanEnqueueDroppableEvent(
  void
)

BatalkanResolveHostAddress

void CancelResolveHostAddress(
  DNSResolveCompleteFunct onComplete,
  void *appState
)

Batalkan kueri DNS yang belum selesai (untuk callback penyelesaian dan status aplikasi yang cocok) yang mungkin masih aktif.

Detail

Parameter

`[in] onComplete`	Pointer ke fungsi callback saat permintaan DNS selesai.
`[in] appState`	Pointer ke objek status aplikasi yang akan diteruskan ke fungsi callback sebagai argumen.

DroppableEventDequeue

void DroppableEventDequeued(
  void
)

GetInterfaceFromAddr

INET_ERROR GetInterfaceFromAddr(
  const IPAddress & addr,
  InterfaceId & intfId
)

Mendapatkan ID antarmuka untuk alamat IP yang ditentukan.

Jika ID antarmuka tidak dapat diperoleh, ID akan ditetapkan ke INET_NULL_INTERFACEID.

Detail

Parameter

`[in] addr`	Referensi ke objek IPAddress.
`[out] intfId`	Referensi ke objek InterfaceId.

Menampilkan

INET_NO_ERROR tanpa syarat.

GetLinkLocalAddr

INET_ERROR GetLinkLocalAddr(
  InterfaceId link,
  IPAddress *llAddr
)

Mendapatkan alamat IPv6 lokal link untuk link atau antarmuka yang ditentukan.

Detail

Parameter

`[in] link`	Antarmuka yang dicari oleh alamat IPv6 lokal link.
`[out] llAddr`	Alamat IPv6 lokal link untuk link.

Nilai yang Ditampilkan

`INET_ERROR_NOT_IMPLEMENTED`	Jika IPv6 tidak didukung.
`INET_ERROR_BAD_ARGS`	Jika alamat lokal link adalah NULL.
`INET_ERROR_ADDRESS_NOT_FOUND`	Jika link tidak memiliki alamat yang dikonfigurasi.
`INET_NO_ERROR`	Jika berhasil.

MendapatkanPlatform

void * GetPlatformData(
  void
)

Tindakan ini akan menampilkan data platform khusus klien yang ditetapkan ke instance, jika sebelumnya telah ditetapkan.

Detail
Menampilkan	Data platform khusus klien, jika sudah ditetapkan sebelumnya; jika tidak, NULL.

HandleSelectResult

void HandleSelectResult(
  int selectRes,
  fd_set *readfds,
  fd_set *writefds,
  fd_set *exceptfds
)

Tangani I/O dari panggilan telepon tertentu.

Metode ini mendaftarkan peristiwa I/O yang tertunda di setiap endpoint aktif, lalu memanggil fungsi penanganan I/O masing-masing untuk endpoint tersebut.

Detail

Parameter

`[in] selectRes`	Nilai hasil dari panggilan pilih.
`[in] readfds`	Pointer ke kumpulan deskriptor file yang telah dibaca.
`[in] writefds`	Pointer ke kumpulan deskripsi file tulis.
`[in] exceptfds`	Pointer ke kumpulan deskripsi file dengan error.

InetLayer

 InetLayer(
  void
)

Ini adalah konstruktor default InetLayer.

Ini melakukan beberapa inisialisasi anggota data dasar; namun, karena InetLayer mengikuti pola desain penginisialisasi eksplisit, metode InetLayer::Init harus berhasil dipanggil sebelum menggunakan objek.

Init

INET_ERROR Init(
  Weave::System::Layer & aSystemLayer,
  void *aContext
)

Ini adalah penginisialisasi eksplisit InetLayer.

Ini harus dipanggil dan berhasil diselesaikan sebelum InetLayer dapat digunakan.

Pemanggil dapat memberikan argumen konteks opsional yang akan diteruskan kembali melalui fungsi hook khusus platform. Untuk adaptasi berbasis LwIP, ini biasanya akan menjadi pointer ke antrean peristiwa yang terkait dengan instance InetLayer.

Platform dapat memilih untuk menegaskan INET_CONFIG_WILL_OVERRIDE_PLATFORM_XTOR_FUNCS dalam header konfigurasi khusus platformnya dan mengaktifkan Platform::InetLayer::WillInit dan Platform::InetLayer::DidInit ini untuk memengaruhi penyesuaian khusus platform atau ekstensi data ke InetLayer.

Detail

Parameter

`[in] aSystemLayer`	Instance Lapisan Sistem Weave yang diperlukan sudah berhasil diinisialisasi.
`[in] aContext`	Argumen konteks opsional yang akan diteruskan kembali ke pemanggil melalui fungsi hook khusus platform.

Nilai yang Ditampilkan

`INET_ERROR_INCORRECT_STATE`	Jika InetLayer dalam status yang salah.
`INET_ERROR_NO_MEMORY`	Jika InetLayer kehabisan sumber daya untuk permintaan ini untuk timer baru.
`other`	Error khusus platform yang menunjukkan alasan kegagalan inisialisasi.
`INET_NO_ERROR`	Jika berhasil.

InitQueueLimiter

INET_ERROR InitQueueLimiter(
  void
)

MatchLocalIPv6Subnet

bool MatchLocalIPv6Subnet(
  const IPAddress & addr
)

Periksa apakah ada pencocokan awalan antara alamat IPv6 yang ditentukan dan alamat IPv6 yang dikonfigurasi secara lokal.

Detail

Parameter

[in] addr

Alamat IPv6 untuk memeriksa pencocokan awalan.

Menampilkan

true jika ditemukan kecocokan yang berhasil, jika tidak, false.

NewRawEndPoint

INET_ERROR NewRawEndPoint(
  IPVersion ipVer,
  IPProtocol ipProto,
  RawEndPoint **retEndPoint
)

Membuat objek RawEndPoint baru untuk versi IP dan protokol tertentu.

Detail

Parameter

`[in] ipVer`	IPv4 atau IPv6.
`[in] ipProto`	Protokol dalam kelompok IP (mis., ICMPv4 atau ICMPv6).
`[in,out] retEndPoint`	Pointer ke pointer objek RawEndPoint yang merupakan parameter kembali setelah penyelesaian pembuatan objek. *retEndPoint NULL jika pembuatan gagal.

Nilai yang Ditampilkan

`INET_ERROR_INCORRECT_STATE`	Jika objek InetLayer tidak diinisialisasi.
`INET_ERROR_NO_ENDPOINTS`	Jika kumpulan InetLayer RawEndPoint penuh dan tidak ada endpoint baru yang dapat dibuat.
`INET_NO_ERROR`	Jika berhasil.

NewTCPEndPoint

INET_ERROR NewTCPEndPoint(
  TCPEndPoint **retEndPoint
)

Membuat objek TCPEndPoint baru.

Detail

Parameter

[in,out] retEndPoint

Pointer ke pointer objek TCPEndPoint yang merupakan parameter kembali setelah penyelesaian pembuatan objek. *retEndPoint NULL jika pembuatan gagal.

Nilai yang Ditampilkan

`INET_ERROR_INCORRECT_STATE`	Jika objek InetLayer tidak diinisialisasi.
`INET_ERROR_NO_ENDPOINTS`	Jika kumpulan InetLayer TCPEndPoint penuh dan tidak ada endpoint baru yang dapat dibuat.
`INET_NO_ERROR`	Jika berhasil.

NewTunEndPoint

INET_ERROR NewTunEndPoint(
  TunEndPoint **retEndPoint
)

Membuat objek TunEndPoint baru.

Detail

Parameter

[in,out] retEndPoint

Pointer ke pointer objek TunEndPoint yang merupakan parameter kembali setelah penyelesaian pembuatan objek. *retEndPoint NULL jika pembuatan gagal.

Nilai yang Ditampilkan

`INET_ERROR_INCORRECT_STATE`	Jika objek InetLayer tidak diinisialisasi.
`INET_ERROR_NO_ENDPOINTS`	Jika kumpulan InetLayer TunEndPoint penuh dan tidak ada yang baru dapat dibuat.
`INET_NO_ERROR`	Jika berhasil.

NewUDPEndPoint

INET_ERROR NewUDPEndPoint(
  UDPEndPoint **retEndPoint
)

Membuat objek UDPEndPoint baru.

Detail

Parameter

[in,out] retEndPoint

Pointer ke pointer objek UDPEndPoint yang merupakan parameter kembali setelah penyelesaian pembuatan objek. *retEndPoint NULL jika pembuatan gagal.

Nilai yang Ditampilkan

`INET_ERROR_INCORRECT_STATE`	Jika objek InetLayer tidak diinisialisasi.
`INET_ERROR_NO_ENDPOINTS`	Jika kumpulan InetLayer UDPEndPoint penuh dan tidak ada endpoint baru yang dapat dibuat.
`INET_NO_ERROR`	Jika berhasil.

PersiapanPilih

void PrepareSelect(
  int & nfds,
  fd_set *readfds,
  fd_set *writefds,
  fd_set *exceptfds,
  struct timeval & sleepTime
)

Siapkan kumpulan deskripsi file untuk select() yang akan digunakan.

Detail

Parameter

`[out] nfds`	Rentang deskriptor file dalam kumpulan deskriptor file.
`[in] readfds`	Pointer ke kumpulan deskriptor file yang dapat dibaca.
`[in] writefds`	Pointer ke kumpulan deskripsi file yang dapat ditulis.
`[in] exceptfds`	Pointer ke kumpulan deskripsi file dengan error.
`[in] sleepTimeTV`	Pointer ke struktur yang menentukan berapa lama pilihan harus tidur

ResolveHostAddress

INET_ERROR ResolveHostAddress(
  const char *hostName,
  uint16_t hostNameLen,
  uint8_t options,
  uint8_t maxAddrs,
  IPAddress *addrArray,
  DNSResolveCompleteFunct onComplete,
  void *appState
)

Melakukan resolusi alamat IP nama host yang ditentukan.

Detail

Parameter

`[in] hostName`	Pointer ke string C yang tidak dihentikan NULL yang mewakili nama host yang akan dikueri.
`[in] hostNameLen`	Panjang string nama host.
`[in] options`	Nilai bilangan bulat yang mengontrol performa resolusi nama host. Value should be one of the address family values from the #DNSOptions enumeration: #kDNSOption_AddrFamily_Any #kDNSOption_AddrFamily_IPv4Only #kDNSOption_AddrFamily_IPv6Only #kDNSOption_AddrFamily_IPv4Preferred #kDNSOption_AddrFamily_IPv6Preferred
`[in] maxAddrs`	Jumlah alamat maksimum yang akan disimpan dalam tabel DNS.
`[in] addrArray`	Pointer ke tabel DNS.
`[in] onComplete`	Pointer ke fungsi callback saat permintaan DNS selesai.
`[in] appState`	Pointer ke status aplikasi untuk diteruskan ke onComplete saat permintaan DNS selesai.

Nilai yang Ditampilkan

`INET_NO_ERROR`	jika permintaan DNS berhasil ditangani.
`INET_ERROR_NO_MEMORY`	jika kumpulan resolver lapisan Inet penuh.
`INET_ERROR_HOST_NAME_TOO_LONG`	jika nama host yang diminta terlalu panjang.
`INET_ERROR_HOST_NOT_FOUND`	jika nama host permintaan tidak dapat diselesaikan menjadi alamat.
`INET_ERROR_DNS_TRY_AGAIN`	jika server nama menampilkan indikasi kegagalan sementara; coba lagi nanti.
`INET_ERROR_DNS_NO_RECOVERY`	jika server nama menampilkan error yang tidak dapat dipulihkan.
`INET_ERROR_NOT_IMPLEMENTED`	jika resolusi DNS tidak diaktifkan di platform pokok.
`other`	Error POSIX jaringan atau OS yang ditampilkan oleh implementasi DNS resolver yang mendasarinya.

ResolveHostAddress

INET_ERROR ResolveHostAddress(
  const char *hostName,
  uint16_t hostNameLen,
  uint8_t maxAddrs,
  IPAddress *addrArray,
  DNSResolveCompleteFunct onComplete,
  void *appState
)

Melakukan resolusi alamat IP nama host yang ditentukan.

Detail

Parameter

`[in] hostName`	Pointer ke string C yang tidak dihentikan NULL yang mewakili nama host yang akan dikueri.
`[in] hostNameLen`	Panjang string nama host.
`[in] maxAddrs`	Jumlah alamat maksimum yang akan disimpan dalam tabel DNS.
`[in] addrArray`	Pointer ke tabel DNS.
`[in] onComplete`	Pointer ke fungsi callback saat permintaan DNS selesai.
`[in] appState`	Pointer ke status aplikasi untuk diteruskan ke onComplete saat permintaan DNS selesai.

Nilai yang Ditampilkan

`INET_NO_ERROR`	jika permintaan DNS berhasil ditangani.
`INET_ERROR_NO_MEMORY`	jika kumpulan resolver lapisan Inet penuh.
`INET_ERROR_HOST_NAME_TOO_LONG`	jika nama host yang diminta terlalu panjang.
`INET_ERROR_HOST_NOT_FOUND`	jika nama host permintaan tidak dapat diselesaikan menjadi alamat.
`INET_ERROR_DNS_TRY_AGAIN`	jika server nama menampilkan indikasi kegagalan sementara; coba lagi nanti.
`INET_ERROR_DNS_NO_RECOVERY`	jika server nama menampilkan error yang tidak dapat dipulihkan.
`INET_ERROR_NOT_IMPLEMENTED`	jika resolusi DNS tidak diaktifkan di platform pokok.
`other`	Error POSIX jaringan atau OS yang ditampilkan oleh implementasi DNS resolver yang mendasarinya.

ResolveHostAddress

INET_ERROR ResolveHostAddress(
  const char *hostName,
  uint8_t maxAddrs,
  IPAddress *addrArray,
  DNSResolveCompleteFunct onComplete,
  void *appState
)

Melakukan resolusi alamat IP nama host yang ditentukan.

Detail

Parameter

`[in] hostName`	Pointer ke string C yang diakhiri NULL yang mewakili nama host yang akan dikueri.
`[in] maxAddrs`	Jumlah alamat maksimum yang akan disimpan dalam tabel DNS.
`[in] addrArray`	Pointer ke tabel DNS.
`[in] onComplete`	Pointer ke fungsi callback saat permintaan DNS selesai.
`[in] appState`	Pointer ke status aplikasi untuk diteruskan ke onComplete saat permintaan DNS selesai.

Nilai yang Ditampilkan

`INET_NO_ERROR`	jika permintaan DNS berhasil ditangani.
`INET_ERROR_NO_MEMORY`	jika kumpulan resolver lapisan Inet penuh.
`INET_ERROR_HOST_NAME_TOO_LONG`	jika nama host yang diminta terlalu panjang.
`INET_ERROR_HOST_NOT_FOUND`	jika nama host permintaan tidak dapat diselesaikan menjadi alamat.
`INET_ERROR_DNS_TRY_AGAIN`	jika server nama menampilkan indikasi kegagalan sementara; coba lagi nanti.
`INET_ERROR_DNS_NO_RECOVERY`	jika server nama menampilkan error yang tidak dapat dipulihkan.
`INET_ERROR_NOT_IMPLEMENTED`	jika resolusi DNS tidak diaktifkan di platform pokok.
`other`	Error POSIX jaringan atau OS yang ditampilkan oleh implementasi DNS resolver yang mendasarinya.

SetPlatformData

void SetPlatformData(
  void *aPlatformData
)

Tindakan ini menetapkan data platform khusus klien yang ditentukan ke instance untuk diambil nanti oleh platform klien.

Detail

Parameter

[in] aPlatformData

Data platform khusus klien yang akan ditetapkan.

Mematikan

INET_ERROR Shutdown(
  void
)

Ini adalah deinisialisasir eksplisit InetLayer dan harus dipanggil sebelum membuang instance InetLayer yang dibuat instance.

Platform dapat memilih untuk menegaskan INET_CONFIG_WILL_OVERRIDE_PLATFORM_XTOR_FUNCS dalam header konfigurasi khusus platformnya dan mengaktifkan hook Platform::InetLayer::WillShutdown dan Platform::InetLayer::DidShutdown untuk memengaruhi pembersihan penyesuaian khusus platform atau ekstensi data ke InetLayer.

Detail
Menampilkan	INET_NO_ERROR saat berhasil; jika tidak, error tertentu akan menunjukkan alasan kegagalan penonaktifan.

SistemLayer

Weave::System::Layer * SystemLayer(
  void
) const

Fungsi statis publik

HandleInetLayerEvent

Weave::System::Error HandleInetLayerEvent(
  Weave::System::Object & aTarget,
  Weave::System::EventType aEventType,
  uintptr_t aArgument
)

PeristiwaIsDroppable

bool IsDroppableEvent(
  Weave::System::EventType aType
)

UpdateSnapshot

void UpdateSnapshot(
  nl::Weave::System::Stats::Snapshot & aSnapshot
)

nl::Inet::InetLayer

Ringkasan

Konstruktor dan Destruktor

Jenis publik

Atribut publik

Atribut statis publik

Fungsi publik

Fungsi statis publik

Jenis publik

@5

DNSResolveCompleteFunct

Atribut publik

Negara bagian

Atribut statis publik

sInetEventHandlerDelegate

Fungsi publik

PeristiwaCanEnqueueDroppable

BatalkanResolveHostAddress

DroppableEventDequeue

GetInterfaceFromAddr

GetLinkLocalAddr

MendapatkanPlatform

HandleSelectResult

InetLayer

Init

InitQueueLimiter

MatchLocalIPv6Subnet

NewRawEndPoint

NewTCPEndPoint

NewTunEndPoint

NewUDPEndPoint

PersiapanPilih

ResolveHostAddress

ResolveHostAddress

ResolveHostAddress

SetPlatformData

Mematikan

SistemLayer

Fungsi statis publik

HandleInetLayerEvent

PeristiwaIsDroppable

UpdateSnapshot