26.3.3 oskit_freebsd_net_open_first_ether_if: find and open first ethernet interface

 

SYNOPSIS

#include <oskit/net/freebsd.h>

oskit_error_t oskit_freebsd_net_open_first_ether_if( [out] struct oskit_freebsd_net_ether_if ** out_eif);

DIRECTION

OS Network stack

DESCRIPTION

This function is a convenience function to find and open the first ethernet device and to create an associated oskit_freebsd_net_ether_if structure.
Limitation/pecularity of the current implementation:

It leaks references to other ethernet devices, if any.

PARAMETERS

out_eif

*out_eif points to an oskit_freebsd_net_ether_if structure on success.

RETURNS

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