Miscellaneous Library Functions

11.2.4ns_printf()

This function is used to report network statistics.

Syntax

int ns_printf(void *vio, char *format, …)

Return value

Returns one of the following:

number of characters printed

if successful.

negative value

if not successful.

Usage

The ns_printf() function is used by the various network statistics printing routines within the stack to report current counter values. The vio argument is a pointer to a GenericIO structure, which can be used to direct output to different streams, such as the debug console or a TELNET socket.

Miscellaneous Library Functions

11.2.5panic()

This function is used to indicate a nonrecoverable fault within the system.

Syntax

void panic(char *msg)

where:

Return value

None.

Usage

This function uses dprintf() to print the message string passed, attempts to trap to the debugger using dtrap(), and then halts the system by calling netexit(). You must modify this code if you want your system to restart (warm boot) after such a failure.

Miscellaneous Library Functions

11.2.6print_eth()

This function is used to format an Ethernet address as an ASCII string for printing.

Syntax

char *print_eth(char *addr, char spacer)

where:

spacer is the character to be used between each octet.

Return value

Returns a pointer to a statically allocated buffer containing a null-terminated ASCII string that represents the Ethernet address pointed to by addr.

Usage

This function is useful for formatting Ethernet MAC addresses. It returns a pointer to a static buffer containing the MAC address represented as a string of six 2-digit hexadecimal numbers. Each number is separated from the next by the character spacer. The complete string of six numbers is null-terminated. If spacer is passed as \0, no spacing characters are inserted into the output string and the resulting string is 12 characters long. If spacer is nonzero, the resulting string is 17 characters long.

Miscellaneous Library Functions

11.2.7print_ipad()

This function is used to format an IP address as an ASCII string for printing.

Syntax

char *print_ipad(unsigned long ipaddr)

where:

ipaddr is the network address to be printed, in network byte order.

Return value

Returns a pointer to a statically allocated buffer containing a null-terminated ASCII string that represents the Internet address passed in ipaddr.

Usage

This function returns a pointer to a static buffer that contains the dotted quad notation for the IP address passed. The IP address is expected to be in network byte order (big-endian).