ifenum.h 5.06 KB
Newer Older
1
/* ifenum.h
2
 * Copyright (C) 2003,2006 Juan Lang
3 4 5 6 7 8 9 10 11 12 13 14 15
 *
 * 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
16
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17
 *
18 19 20
 * This module implements network interface and address enumeration.  It's
 * meant to hide some problematic defines like socket(), and make iphlpapi
 * more portable.
21 22 23 24 25 26 27
 *
 * 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
Juan Lang's avatar
Juan Lang committed
28
 * valid indexes; use getInterfaceIndexTable() instead.
29 30 31 32 33 34 35
 *
 * See also the companion file, ipstats.h, for functions related to getting
 * statistics.
 */
#ifndef WINE_IFENUM_H_
#define WINE_IFENUM_H_

36 37
#include <stdarg.h>

38
#include "windef.h"
39
#include "winbase.h"
40
#include "iprtrmib.h"
41 42
#define USE_WS_PREFIX
#include "winsock2.h"
43 44 45 46

#define MAX_INTERFACE_PHYSADDR    8
#define MAX_INTERFACE_DESCRIPTION 256

47 48 49
DWORD getNumInterfaces(void) DECLSPEC_HIDDEN;
DWORD getNumNonLoopbackInterfaces(void) DECLSPEC_HIDDEN;
BOOL isIfIndexLoopback(ULONG idx) DECLSPEC_HIDDEN;
50

51
/* A table of interface indexes, see get*InterfaceTable(). */
52 53 54 55 56 57
typedef struct _InterfaceIndexTable {
  DWORD numIndexes;
  DWORD indexes[1];
} InterfaceIndexTable;

/* Returns a table with all known interface indexes, or NULL if one could not
58
 * be allocated.  HeapFree() the returned table.
59
 */
60
InterfaceIndexTable *getInterfaceIndexTable(void) DECLSPEC_HIDDEN;
61 62

/* Like getInterfaceIndexTable, but filters out loopback interfaces. */
63
InterfaceIndexTable *getNonLoopbackInterfaceIndexTable(void) DECLSPEC_HIDDEN;
64 65 66 67

/* ByName/ByIndex versions of various getter functions. */

/* can be used as quick check to see if you've got a valid index, returns NULL
68 69
 * if not.  Overwrites your buffer, which should be at least of size
 * MAX_ADAPTER_NAME.
70
 */
71
char *getInterfaceNameByIndex(DWORD index, char *name) DECLSPEC_HIDDEN;
72 73 74 75 76

/* 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.
 */
77
DWORD getInterfaceIndexByName(const char *name, PDWORD index) DECLSPEC_HIDDEN;
78

Austin English's avatar
Austin English committed
79
/* Gets a few physical characteristics of a device:  MAC addr len, MAC addr,
80 81 82 83 84 85 86 87 88 89 90 91 92
 * 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 getInterfacePhysicalByIndex(DWORD index, PDWORD len, PBYTE addr,
93
 PDWORD type) DECLSPEC_HIDDEN;
94

95
/* Fills in the MIB_IFROW by name.  Doesn't fill in interface statistics,
96
 * see ipstats.h for that.
97 98
 * Returns ERROR_INVALID_PARAMETER if name is NULL, ERROR_INVALID_DATA
 * if name isn't valid, and NO_ERROR otherwise.
99
 */
100
DWORD getInterfaceEntryByName(const char *name, PMIB_IFROW entry) DECLSPEC_HIDDEN;
101

102
DWORD getNumIPAddresses(void) DECLSPEC_HIDDEN;
103

104 105 106 107 108
/* Gets the configured IP addresses for the system, and sets *ppIpAddrTable to
 * a table of them allocated from heap, or NULL if out of memory.  Returns
 * NO_ERROR on success, something else on failure.  Note there may be more than
 * one IP address may exist per interface.
 */
109
DWORD getIPAddrTable(PMIB_IPADDRTABLE *ppIpAddrTable, HANDLE heap, DWORD flags) DECLSPEC_HIDDEN;
110

111 112 113
/* Returns the IPv6 addresses for a particular interface index.
 * Returns NO_ERROR on success, something else on failure.
 */
114
ULONG v6addressesFromIndex(DWORD index, SOCKET_ADDRESS **addrs, ULONG *num_addrs) DECLSPEC_HIDDEN;
115

116 117 118
/* Converts the network-order bytes in addr to a printable string.  Returns
 * string.
 */
119
char *toIPAddressString(unsigned int addr, char string[16]) DECLSPEC_HIDDEN;
120

121 122
DWORD getInterfaceMtuByName(const char *name, PDWORD mtu) DECLSPEC_HIDDEN;
DWORD getInterfaceStatusByName(const char *name, PDWORD status) DECLSPEC_HIDDEN;
123

124
#endif /* ndef WINE_IFENUM_H_ */