/**************************************************************************** * netutils/netlib/netlib_getessid.c * * Copyright (C) 2017 Gregory Nutt. All rights reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include "netutils/netlib.h" #if defined(CONFIG_NET) && CONFIG_NSOCKET_DESCRIPTORS > 0 /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* The address family that we used to create the socket and in the IOCTL * data really does not matter. It should, however, be valid in the current * configuration. */ #if defined(CONFIG_NET_IPv4) # define PF_FAMILY PF_INET # define AF_FAMILY AF_INET #elif defined(CONFIG_NET_IPv6) # define PF_FAMILY PF_INET6 # define AF_FAMILY AF_INET6 #elif defined(CONFIG_NET_IEEE802154) # define PF_FAMILY PF_IEEE802154 # define AF_FAMILY AF_IEEE802154 #endif /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: netlib_getessid * * Description: * Get the wireless access point ESSID * * Parameters: * ifname The name of the interface to use * essid Location to store the returned ESSID, size must be * IW_ESSID_MAX_SIZE + 1 or larger * idlen size of memory set asdie for the ESSID. * * Return: * 0 on success; -1 on failure (errno may not be set) * ****************************************************************************/ int netlib_getessid(FAR const char *ifname, FAR char *essid, size_t idlen) { int ret = ERROR; if (ifname != NULL && essid != NULL && idlen > IW_ESSID_MAX_SIZE) { /* Get a socket (only so that we get access to the INET subsystem) */ int sockfd = socket(PF_FAMILY, NETLIB_SOCK_IOCTL, 0); if (sockfd >= 0) { struct iwreq req; /* Put the driver name into the request */ memset(&req, 0, sizeof(struct iwreq)); strncpy(req.ifr_name, ifname, IFNAMSIZ); /* Put pointer to receive the ESSID into the request */ req.u.essid.pointer = (FAR void *)essid; /* Perform the ioctl to get the ESSID */ ret = ioctl(sockfd, SIOCGIWESSID, (unsigned long)&req); close(sockfd); } } return ret; } #endif /* CONFIG_NET && CONFIG_NSOCKET_DESCRIPTORS */