Miscellaneous Library Functions

11.2in_utils.c

This file contains an assortment of general utility functions. They are described in this section. The functions are:

•con_page() on page 11-5

•hexdump() on page 11-6

•nextarg() on page 11-7

•ns_printf() on page 11-8

•panic() on page 11-9

•print_eth() on page 11-10

•print_ipad() on page 11-11.

•print_uptime() on page 11-12

•std_in() on page 11-13

•std_out() on page 11-14

•sysuptime() on page 11-14

•uslash() on page 11-15.

Miscellaneous Library Functions

11.2.1con_page()

This function implements a simple more facility.

Syntax

int con_page(int *line)

where:

Return value

Returns one of the following:

Usage

The con_page() function implements a simple more facility that increments the variable pointed to by line, and if more than a screen of information has been displayed, it waits for a key press from the user. Normally, 0 is returned. The value 1 is returned if the Escape key is pressed as a response to the press any key for more prompt, indicating that the user does not wish to see more output.

Miscellaneous Library Functions

11.2.2hexdump()

This function is used to display an area of memory, usually for debugging purposes.

Syntax

void hexdump(void *buffer, unsigned len)

Return value

None.

Usage

The hexdump() function displays len bytes of data, starting from the address buffer, using the dprintf() routine.

Miscellaneous Library Functions

11.2.3nextarg()

This function is used to parse a string into separate arguments.

Syntax

char *nextarg(char *argp)

where:

Return value

Returns a pointer to the next argument in argp, or to the terminating null character if there are no more arguments.

Usage

This function returns a pointer to the next argument in the string passed. Arguments are considered to be printable ASCII sequences of characters delimited by spaces. If there are no more arguments present within the string passed, this function returns a pointer to the null character that terminates the string. For example, calling nextarg() with the string one two three returns a pointer to the letter t of the word two. Calling nextarg() with that pointer returns a pointer to the letter t of the word three, and calling nextarg() once more returns a pointer to the terminating null character of the string.