139 lines
5.5 KiB
C
139 lines
5.5 KiB
C
/* ifenum.h
|
|
* Copyright (C) 2003 Juan Lang
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
* This module implements functions shared by DLLs that need to enumerate
|
|
* network interfaces and addresses. It's meant to hide some problematic
|
|
* defines like socket(), as well as provide only one file
|
|
* that needs to be ported to implement these functions on different platforms,
|
|
* since the Windows API provides multiple ways to get at this info.
|
|
*
|
|
* Like Windows, it uses a numeric index to identify an interface uniquely.
|
|
* As implemented, an interface represents a UNIX network interface, virtual
|
|
* or real, and thus can have 0 or 1 IP addresses associated with it. (This
|
|
* only supports IPv4.)
|
|
* The indexes returned are not guaranteed to be contiguous, so don't call
|
|
* getNumInterfaces() and assume the values [0,getNumInterfaces() - 1] will be
|
|
* valid indexes; use getInterfaceIndexTable() instead. Non-loopback
|
|
* interfaces have lower index values than loopback interfaces, in order to
|
|
* make the indexes somewhat reusable as Netbios LANA numbers. See ifenum.c
|
|
* for more detail on this.
|
|
*
|
|
* See also the companion file, ipstats.h, for functions related to getting
|
|
* statistics.
|
|
*/
|
|
#ifndef WINE_IFENUM_H_
|
|
#define WINE_IFENUM_H_
|
|
|
|
#include <stdarg.h>
|
|
|
|
#include "windef.h"
|
|
#include "winbase.h"
|
|
#include "iprtrmib.h"
|
|
|
|
#define MAX_INTERFACE_PHYSADDR 8
|
|
#define MAX_INTERFACE_DESCRIPTION 256
|
|
|
|
/* Call before using the functions in this module */
|
|
void interfaceMapInit(void);
|
|
/* Call to free resources allocated in interfaceMapInit() */
|
|
void interfaceMapFree(void);
|
|
|
|
DWORD getNumInterfaces(void);
|
|
DWORD getNumNonLoopbackInterfaces(void);
|
|
|
|
/* A table of interface indexes, see get*InterfaceTable(). Ignore numAllocated,
|
|
* it's used during the creation of the table.
|
|
*/
|
|
typedef struct _InterfaceIndexTable {
|
|
DWORD numIndexes;
|
|
DWORD numAllocated;
|
|
DWORD indexes[1];
|
|
} InterfaceIndexTable;
|
|
|
|
/* Returns a table with all known interface indexes, or NULL if one could not
|
|
* be allocated. free() the returned table.
|
|
*/
|
|
InterfaceIndexTable *getInterfaceIndexTable(void);
|
|
|
|
/* Like getInterfaceIndexTable, but filters out loopback interfaces. */
|
|
InterfaceIndexTable *getNonLoopbackInterfaceIndexTable(void);
|
|
|
|
/* ByName/ByIndex versions of various getter functions. */
|
|
|
|
/* can be used as quick check to see if you've got a valid index, returns NULL
|
|
* if not. The buffer's only valid till the next call, so copy it right away
|
|
* if you care.
|
|
*/
|
|
const char *getInterfaceNameByIndex(DWORD index);
|
|
|
|
/* Fills index with the index of name, if found. Returns
|
|
* ERROR_INVALID_PARAMETER if name or index is NULL, ERROR_INVALID_DATA if name
|
|
* is not found, and NO_ERROR on success.
|
|
*/
|
|
DWORD getInterfaceIndexByName(const char *name, PDWORD index);
|
|
|
|
/* This bunch returns IP addresses, and INADDR_ANY or INADDR_NONE if not found,
|
|
* appropriately depending on the f/n.
|
|
*/
|
|
DWORD getInterfaceIPAddrByName(const char *name);
|
|
DWORD getInterfaceIPAddrByIndex(DWORD index);
|
|
DWORD getInterfaceMaskByName(const char *name);
|
|
DWORD getInterfaceMaskByIndex(DWORD index);
|
|
DWORD getInterfaceBCastAddrByName(const char *name);
|
|
DWORD getInterfaceBCastAddrByIndex(DWORD index);
|
|
|
|
/* Gets a few physical charactersistics of a device: MAC addr len, MAC addr,
|
|
* and type as one of the MIB_IF_TYPEs.
|
|
* len's in-out: on in, needs to say how many bytes are available in addr,
|
|
* which to be safe should be MAX_INTERFACE_PHYSADDR. On out, it's how many
|
|
* bytes were set, or how many were required if addr isn't big enough.
|
|
* Returns ERROR_INVALID_PARAMETER if name, len, addr, or type is NULL.
|
|
* Returns ERROR_INVALID_DATA if name/index isn't valid.
|
|
* Returns ERROR_INSUFFICIENT_BUFFER if addr isn't large enough for the
|
|
* physical address; *len will contain the required size.
|
|
* May return other errors, e.g. ERROR_OUTOFMEMORY or ERROR_NO_MORE_FILES,
|
|
* if internal errors occur.
|
|
* Returns NO_ERROR on success.
|
|
*/
|
|
DWORD getInterfacePhysicalByName(const char *name, PDWORD len, PBYTE addr,
|
|
PDWORD type);
|
|
DWORD getInterfacePhysicalByIndex(DWORD index, PDWORD len, PBYTE addr,
|
|
PDWORD type);
|
|
|
|
/* Get the operational status as a (MIB_)IF_OPER_STATUS type.
|
|
*/
|
|
DWORD getInterfaceStatusByName(const char *name, PDWORD status);
|
|
DWORD getInterfaceStatusByIndex(DWORD index, PDWORD status);
|
|
|
|
DWORD getInterfaceMtuByName(const char *name, PDWORD mtu);
|
|
DWORD getInterfaceMtuByIndex(DWORD index, PDWORD mtu);
|
|
|
|
/* Fills in the MIB_IFROW by name/index. Doesn't fill in interface statistics,
|
|
* see ipstats.h for that.
|
|
* Returns ERROR_INVALID_PARAMETER if name or entry is NULL, ERROR_INVALID_DATA
|
|
* if name/index isn't valid, and NO_ERROR otherwise.
|
|
*/
|
|
DWORD getInterfaceEntryByName(const char *name, PMIB_IFROW entry);
|
|
DWORD getInterfaceEntryByIndex(DWORD index, PMIB_IFROW entry);
|
|
|
|
/* Converts the network-order bytes in addr to a printable string. Returns
|
|
* string.
|
|
*/
|
|
char *toIPAddressString(unsigned int addr, char string[16]);
|
|
|
|
#endif /* ndef WINE_IFENUM_H_ */
|