1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in 12 * the documentation and/or other materials provided with the 13 * distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #pragma once 30 31 /** 32 * @file netinet/ether.h 33 * @brief Ethernet (MAC) addresses. 34 */ 35 36 #include <sys/cdefs.h> 37 #include <netinet/if_ether.h> 38 39 __BEGIN_DECLS 40 41 /** 42 * [ether_ntoa(3)](http://man7.org/linux/man-pages/man3/ether_ntoa.3.html) returns a string 43 * representation of the given Ethernet address. 44 * 45 * Returns a pointer to a static buffer. 46 * 47 * Available since API level 11. 48 */ 49 char* ether_ntoa(const struct ether_addr* __addr) __INTRODUCED_IN(11); 50 51 /** 52 * [ether_ntoa_r(3)](http://man7.org/linux/man-pages/man3/ether_ntoa_r.3.html) returns a string 53 * representation of the given Ethernet address. 54 * 55 * Returns a pointer to the given buffer. 56 * 57 * Available since API level 11. 58 */ 59 char* ether_ntoa_r(const struct ether_addr* __addr, char* __buf) __INTRODUCED_IN(11); 60 61 /** 62 * [ether_aton(3)](http://man7.org/linux/man-pages/man3/ether_aton.3.html) returns an `ether_addr` 63 * corresponding to the given Ethernet address string. 64 * 65 * Returns a pointer to a static buffer, or NULL if the given string isn't a valid MAC address. 66 * 67 * Available since API level 11. 68 */ 69 struct ether_addr* ether_aton(const char* __ascii) __INTRODUCED_IN(11); 70 71 /** 72 * [ether_aton_r(3)](http://man7.org/linux/man-pages/man3/ether_aton_r.3.html) returns an 73 * `ether_addr` corresponding to the given Ethernet address string. 74 * 75 * Returns a pointer to the given buffer, or NULL if the given string isn't a valid MAC address. 76 * 77 * Available since API level 11. 78 */ 79 struct ether_addr* ether_aton_r(const char* __ascii, struct ether_addr* __addr) __INTRODUCED_IN(11); 80 81 __END_DECLS 82