struct bootp_addr_array {          struct in_addr *addr;   /* array of addresses */          int             len;    /* number of addresses */  };    struct bootp_net_info {          oskit_u32_t    flags;           /* which fields are valid */          struct in_addr ip;              /* client IP address */          struct in_addr netmask;         /* subnet mask */          struct in_addr server;          /* server that replied  */          struct bootp_addr_array gateway;        /* gateways */          struct bootp_addr_array dns_server;     /* DNS server address  */          struct bootp_addr_array time_server;    /* time server address  */          struct bootp_addr_array log_server;     /* log server address  */          struct bootp_addr_array lpr_server;     /* LPR server address  */          oskit_s32_t    time_offset;     /* offset from UTC */          char *hostname;                 /* client hostname */          char *server_name;              /* name of replying server */          char *bootfile_name;            /* boot file name */          char *domainname;               /* domain name */          unsigned char server_hwaddr[ETHER_ADDR_SIZE];   /* server address */  };

The first field of the struct bootp_net_info structure, flags, denotes which of the other fields are valid. flags is an ORed combination of the flag values below. Each flag corresponds to a field in the structure with the same name (in lower case).

All other fields are of one of three types:

1. An IP address encoded as a struct in_addr,
2. A string encoded as a char *,
3. A list of IP addresses encoded in a struct bootp_addr_array.

The following table gives an overview of the flags that are currently supported and the types of the corresponding fields.

The time_offset field specifies the time offset of the local subnet in seconds from Coordinated Universal Time (UTC). It is a signed 32-bit integer, positive numbers indicate west of the Prime Meridian.

#include <oskit/net/bootp.h>

int bootp_gen(oskit_etherdev_t *dev, [in/out] struct bootp_net_info *info, int retries, int timeout);

This function broadcasts retries BOOTP request packets, waiting timeout milliseconds for a reply.

The only field of info that is used as input for the request is the ip field corresponding to BOOTP_NET_IP. See RFC 1048 for more explanation. Users should set this field if they know their IP address; BOOTP_NET_IP needs to be set in flags if this is the case.

Lists of IP addresses and strings are dynamically allocated as needed, users of boopt_gen should pass the info struct to bootp_free to deallocate them.

dev:

A pointer to an oskit_etherdev device interface.

info:

The BOOTP info to be used.

retries:

Number of BOOTP request packets that are sent.

timeout:

Timeout in milliseconds.

Returns zero on success, OSKIT_ETIMEDOUT if the operation timed out, or another error code as specified in <oskit/error.h>

bootp_net_info

#include <oskit/net/bootp.h>

int bootp(oskit_etherdev_t *dev, [in/out] struct bootp_net_info *info);

This function performs a BOOTP request with a timeout of 200 milliseconds (1/5 of a second) with five retries using bootp_gen.

The only field of info that is used as input for the request is the ip field corresponding to BOOTP_NET_IP. See RFC 1048 for more explanation. Users should set this field if they know their IP address; BOOTP_NET_IP needs to be set in flags if this is the case.

Lists of IP addresses and strings are dynamically allocated as needed, users of boopt_gen should pass the info struct to bootp_free to deallocate them.

dev:

A pointer to an oskit_etherdev device interface.

info:

The BOOTP info to be used.

Returns zero on success, or an error code specified in <oskit/error.h> on error.

bootp_net_info

#include <oskit/net/bootp.h>

void bootp_free([in/out] struct bootp_net_info *info);

The function frees data structures that were allocated during a call to bootp_gen.

info:

The BOOTP info to be freed.

bootp_gen, bootp_net_info

#include <oskit/net/bootp.h>

void bootp_dump(struct bootp_net_info *info);

This function prints the contents stored in a bootp_net_info structure to via printf.

info:

The BOOTP info to be printed.

bootp_net_info, printf