nbns_common.h File Reference

Definitions common to NBNS client and NBNS responder. More...

#include "core/net.h"
#include "dns/dns_common.h"

Go to the source code of this file.


#define NBNS_PORT   137
#define NBNS_ENCODE_H(c)   ('A' + (((c) >> 4) & 0x0F))
#define NBNS_ENCODE_L(c)   ('A' + ((c) & 0x0F))


struct {
   uint16_t   id
   uint8_t   rd: 1
   uint8_t   tc: 1
   uint8_t   aa: 1
   uint8_t   opcode: 4
   uint8_t   qr: 1
   uint8_t   rcode: 4
   uint8_t   b: 1
   uint8_t   z: 2
   uint8_t   ra: 1
   uint16_t   qdcount
   uint16_t   ancount
   uint16_t   nscount
   uint16_t   arcount
   uint8_t   questions []
 NBNS message header. More...
struct {
   uint16_t   flags
   Ipv4Addr   addr
 NBNS address entry. More...


enum  DnsFlags {
  NBNS_ONT_BNODE = 0x0000 , NBNS_ONT_PNODE = 0x2000 , NBNS_ONT_MNODE = 0x4000 , NBNS_G_UNIQUE = 0x0000 ,
  NBNS_G_GROUP = 0x8000
 NBNS flags. More...


error_t nbnsInit (NetInterface *interface)
 NBNS related initialization. More...
void nbnsProcessMessage (NetInterface *interface, const IpPseudoHeader *pseudoHeader, const UdpHeader *udpHeader, const NetBuffer *buffer, size_t offset, const NetRxAncillary *ancillary, void *param)
 Process incoming NBNS message. More...
size_t nbnsEncodeName (const char_t *src, uint8_t *dest)
 Encode a NetBIOS name. More...
size_t nbnsParseName (const NbnsHeader *message, size_t length, size_t pos, char_t *dest)
 Decode a NetBIOS name. More...
bool_t nbnsCompareName (const NbnsHeader *message, size_t length, size_t pos, const char_t *name)
 Compare NetBIOS names. More...

Detailed Description

Definitions common to NBNS client and NBNS responder.


SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2022 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Oryx Embedded SARL (www.oryx-embedded.com)

Definition in file nbns_common.h.

Macro Definition Documentation



Definition at line 40 of file nbns_common.h.


#define NBNS_ENCODE_H (   c)    ('A' + (((c) >> 4) & 0x0F))

Definition at line 49 of file nbns_common.h.


#define NBNS_ENCODE_L (   c)    ('A' + ((c) & 0x0F))

Definition at line 50 of file nbns_common.h.


#define NBNS_PORT   137

Definition at line 46 of file nbns_common.h.

Typedef Documentation


typedef { ... } NbnsAddrEntry

NBNS address entry.


typedef { ... } NbnsHeader

NBNS message header.

Enumeration Type Documentation

◆ DnsFlags

enum DnsFlags

NBNS flags.


Definition at line 62 of file nbns_common.h.

Function Documentation

◆ nbnsCompareName()

bool_t nbnsCompareName ( const NbnsHeader message,
size_t  length,
size_t  pos,
const char_t name 

Compare NetBIOS names.

[in]messagePointer to the NBNS message
[in]lengthLength of the NBNS message
[in]posOffset of the encoded domain name
[in]nameNULL-terminated string that holds a domain name
TRUE if the NetBIOS names match, else FALSE

Definition at line 289 of file nbns_common.c.

◆ nbnsEncodeName()

size_t nbnsEncodeName ( const char_t src,
uint8_t *  dest 

Encode a NetBIOS name.

[in]srcPointer to the name to encode
[out]destPointer to the encoded NetBIOS name
Length of the encoded NetBIOS name

Definition at line 153 of file nbns_common.c.

◆ nbnsInit()

error_t nbnsInit ( NetInterface interface)

NBNS related initialization.

[in]interfaceUnderlying network interface
Error code

Definition at line 56 of file nbns_common.c.

◆ nbnsParseName()

size_t nbnsParseName ( const NbnsHeader message,
size_t  length,
size_t  pos,
char_t dest 

Decode a NetBIOS name.

[in]messagePointer to the NBNS message
[in]lengthLength of the NBNS message
[in]posOffset of the name to decode
[out]destPointer to the decoded name (optional)
The position of the resource record that immediately follows the NetBIOS name

Definition at line 205 of file nbns_common.c.

◆ nbnsProcessMessage()

void nbnsProcessMessage ( NetInterface interface,
const IpPseudoHeader pseudoHeader,
const UdpHeader udpHeader,
const NetBuffer buffer,
size_t  offset,
const NetRxAncillary ancillary,
void *  param 

Process incoming NBNS message.

[in]interfaceUnderlying network interface
[in]pseudoHeaderUDP pseudo header
[in]udpHeaderUDP header
[in]bufferMulti-part buffer containing the incoming NBNS message
[in]offsetOffset to the first byte of the NBNS message
[in]ancillaryAdditional options passed to the stack along with the packet
[in]paramCallback function parameter (not used)

Definition at line 83 of file nbns_common.c.

Variable Documentation

◆ aa

uint8_t aa

Definition at line 98 of file nbns_common.h.

◆ addr

Ipv4Addr addr

Definition at line 121 of file nbns_common.h.

◆ ancount

uint16_t ancount

Definition at line 107 of file nbns_common.h.

◆ arcount

uint16_t arcount

Definition at line 109 of file nbns_common.h.

◆ b

uint8_t b

Definition at line 102 of file nbns_common.h.

◆ flags

uint16_t flags

Definition at line 120 of file nbns_common.h.

◆ id

uint16_t id

Definition at line 84 of file nbns_common.h.

◆ nscount

uint16_t nscount

Definition at line 108 of file nbns_common.h.

◆ opcode

uint8_t opcode

Definition at line 99 of file nbns_common.h.

◆ qdcount

uint16_t qdcount

Definition at line 106 of file nbns_common.h.

◆ qr

uint8_t qr

Definition at line 100 of file nbns_common.h.

◆ questions

uint8_t questions[]

Definition at line 110 of file nbns_common.h.

◆ ra

uint8_t ra

Definition at line 104 of file nbns_common.h.

◆ rcode

uint8_t rcode

Definition at line 101 of file nbns_common.h.

◆ rd

uint8_t rd

Definition at line 96 of file nbns_common.h.

◆ tc

uint8_t tc

Definition at line 97 of file nbns_common.h.

◆ z

uint8_t z

Definition at line 103 of file nbns_common.h.