path: root/usr/src/lib/libnwam/common/libnwam_known_wlan.c

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#include <assert.h>
#include <ctype.h>
#include <sys/param.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <strings.h>
#include <unistd.h>
#include <libdllink.h>
#include <libdlwlan.h>

#include "libnwam_impl.h"
#include <libnwam_priv.h>
#include <libnwam.h>

/*
 * Functions to support creating, modifying and destroying
 * known WLAN objects. These represent the WiFi connection history,
 * and are used by nwamd to identify and connect to known WLANs in
 * scan results.
 */

static nwam_error_t valid_keyname(nwam_value_t);
static nwam_error_t valid_keyslot(nwam_value_t);
static nwam_error_t valid_secmode(nwam_value_t);

struct nwam_prop_table_entry known_wlan_prop_table_entries[] = {
	{NWAM_KNOWN_WLAN_PROP_PRIORITY, NWAM_VALUE_TYPE_UINT64, B_FALSE,
	    1, 1, nwam_valid_uint64,
	    "specifies priority of known WLAN - lower values are prioritized",
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY},
	{NWAM_KNOWN_WLAN_PROP_BSSIDS, NWAM_VALUE_TYPE_STRING, B_FALSE,
	    0, NWAM_MAX_NUM_VALUES, nwam_valid_mac_addr,
	    "specifies BSSID(s) (of the form aa:bb:cc:dd:ee:ff) associated "
	    "with known WLAN",
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY},
	{NWAM_KNOWN_WLAN_PROP_KEYNAME, NWAM_VALUE_TYPE_STRING, B_FALSE,
	    0, 1, valid_keyname,
	    "specifies security key name used with known WLAN",
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY},
	{NWAM_KNOWN_WLAN_PROP_KEYSLOT, NWAM_VALUE_TYPE_UINT64, B_FALSE,
	    0, 1, valid_keyslot,
	    "specifies key slot [1-4] for security key used with known WLAN",
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY},
	{NWAM_KNOWN_WLAN_PROP_SECURITY_MODE, NWAM_VALUE_TYPE_UINT64, B_FALSE,
	    0, 1, valid_secmode,
	    "specifies security mode used for known WLAN",
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY}
};

#define	NWAM_NUM_KNOWN_WLAN_PROPS	\
		(sizeof (known_wlan_prop_table_entries) / \
		sizeof (*known_wlan_prop_table_entries))

struct nwam_prop_table known_wlan_prop_table =
	{ NWAM_NUM_KNOWN_WLAN_PROPS, known_wlan_prop_table_entries };

nwam_error_t
nwam_known_wlan_read(const char *name, uint64_t flags,
    nwam_known_wlan_handle_t *kwhp)
{
	return (nwam_read(NWAM_OBJECT_TYPE_KNOWN_WLAN,
	    NWAM_KNOWN_WLAN_CONF_FILE, name, flags, kwhp));
}

nwam_error_t
nwam_known_wlan_create(const char *name, nwam_known_wlan_handle_t *kwhp)
{
	nwam_error_t err;
	nwam_value_t priorityval = NULL;

	assert(kwhp != NULL && name != NULL);

	if ((err = nwam_create(NWAM_OBJECT_TYPE_KNOWN_WLAN,
	    NWAM_KNOWN_WLAN_CONF_FILE, name, kwhp)) != NWAM_SUCCESS)
		return (err);

	/*
	 * Create new object list for known WLAN.  The initial priority is
	 * also set.
	 */
	if ((err = nwam_alloc_object_list(&((*kwhp)->nwh_data)))
	    != NWAM_SUCCESS)
		goto finish;
	if ((err = nwam_value_create_uint64(0, &priorityval)) != NWAM_SUCCESS)
		goto finish;
	err = nwam_set_prop_value((*kwhp)->nwh_data,
	    NWAM_KNOWN_WLAN_PROP_PRIORITY, priorityval);

finish:
	nwam_value_free(priorityval);
	if (err != NWAM_SUCCESS) {
		nwam_known_wlan_free(*kwhp);
		*kwhp = NULL;
	}
	return (err);
}

nwam_error_t
nwam_known_wlan_get_name(nwam_known_wlan_handle_t kwh, char **namep)
{
	return (nwam_get_name(kwh, namep));
}

nwam_error_t
nwam_known_wlan_set_name(nwam_known_wlan_handle_t kwh, const char *name)
{
	return (nwam_set_name(kwh, name));
}

boolean_t
nwam_known_wlan_can_set_name(nwam_known_wlan_handle_t kwh)
{
	return (!kwh->nwh_committed);
}

/*
 * Used to store wlan names/priorities for prioritized walk.
 */
struct nwam_wlan_info {
	char *wlan_name;
	uint64_t wlan_priority;
	boolean_t wlan_walked;
};

struct nwam_wlan_info_list {
	struct nwam_wlan_info **list;
	uint_t num_wlans;
};

/*
 * Used to read in each known WLAN name/priority.
 */
static int
get_wlans_cb(nwam_known_wlan_handle_t kwh, void *data)
{
	struct nwam_wlan_info_list *wil = data;
	struct nwam_wlan_info **list = wil->list;
	struct nwam_wlan_info **newlist = NULL;
	nwam_error_t err;
	nwam_value_t priorityval = NULL;
	uint_t num_wlans = wil->num_wlans;

	/* Reallocate WLAN list and allocate new info list element. */
	if ((newlist = realloc(list,
	    sizeof (struct nwam_wlan_info *) * ++num_wlans)) == NULL ||
	    (newlist[num_wlans - 1] = calloc(1,
	    sizeof (struct nwam_wlan_info))) == NULL) {
		if (newlist != NULL)
			free(newlist);
		return (NWAM_NO_MEMORY);
	}

	/* Update list since realloc() may have relocated it */
	wil->list = newlist;

	/* Retrieve name/priority */
	if ((err = nwam_known_wlan_get_name(kwh,
	    &((newlist[num_wlans - 1])->wlan_name))) != NWAM_SUCCESS ||
	    (err = nwam_known_wlan_get_prop_value(kwh,
	    NWAM_KNOWN_WLAN_PROP_PRIORITY, &priorityval)) != NWAM_SUCCESS ||
	    (err = nwam_value_get_uint64(priorityval,
	    &((newlist[num_wlans - 1])->wlan_priority))) != NWAM_SUCCESS) {
		free(newlist[num_wlans - 1]->wlan_name);
		nwam_value_free(priorityval);
		free(newlist[num_wlans - 1]);
		return (err);
	}
	nwam_value_free(priorityval);

	(newlist[num_wlans - 1])->wlan_walked = B_FALSE;

	wil->num_wlans = num_wlans;

	return (NWAM_SUCCESS);
}

/*
 * Some recursion is required here, since if _WALK_PRIORITY_ORDER is specified,
 * we need to first walk the list of known WLANs to retrieve names
 * and priorities, then utilize that list to carry out an in-order walk.
 */
nwam_error_t
nwam_walk_known_wlans(int(*cb)(nwam_known_wlan_handle_t, void *), void *data,
    uint64_t flags, int *retp)
{
	nwam_known_wlan_handle_t kwh;
	nwam_error_t err;
	int ret = 0;

	assert(cb != NULL);

	if ((err = nwam_valid_flags(flags,
	    NWAM_FLAG_KNOWN_WLAN_WALK_PRIORITY_ORDER | NWAM_FLAG_BLOCKING))
	    != NWAM_SUCCESS)
		return (err);

	if ((flags & NWAM_FLAG_KNOWN_WLAN_WALK_PRIORITY_ORDER) != 0) {
		struct nwam_wlan_info_list wil = { NULL, 0};
		uint64_t iflags = flags &~
		    NWAM_FLAG_KNOWN_WLAN_WALK_PRIORITY_ORDER;
		uint64_t minpriority;
		int errval, i, j, minindex;

		if (nwam_walk_known_wlans(get_wlans_cb, &wil, iflags, &errval)
		    != NWAM_SUCCESS) {
			err = (nwam_error_t)errval;
			goto done;
		}

		err = NWAM_SUCCESS;

		for (i = 0; i < wil.num_wlans; i++) {
			/* Find lowest priority value not walked so far. */
			minpriority = (uint64_t)-1;
			for (j = 0; j < wil.num_wlans; j++) {
				if (wil.list[j]->wlan_priority < minpriority &&
				    !(wil.list[j]->wlan_walked)) {
					minpriority =
					    wil.list[j]->wlan_priority;
					minindex = j;
				}
			}
			wil.list[minindex]->wlan_walked = B_TRUE;
			if ((err = nwam_known_wlan_read
			    (wil.list[minindex]->wlan_name,
			    iflags, &kwh)) != NWAM_SUCCESS) {
				goto done;
			}
			ret = cb(kwh, data);
			if (ret != 0) {
				nwam_known_wlan_free(kwh);
				err = NWAM_WALK_HALTED;
				goto done;
			}
			nwam_known_wlan_free(kwh);
		}
done:
		if (wil.list != NULL) {
			for (j = 0; j < wil.num_wlans; j++) {
				free(wil.list[j]->wlan_name);
				free(wil.list[j]);
			}
			free(wil.list);
		}
		if (retp != NULL)
			*retp = ret;
		return (err);
	}

	return (nwam_walk(NWAM_OBJECT_TYPE_KNOWN_WLAN,
	    NWAM_KNOWN_WLAN_CONF_FILE, cb, data, flags, retp, NULL));
}

void
nwam_known_wlan_free(nwam_known_wlan_handle_t kwh)
{
	nwam_free(kwh);
}

nwam_error_t
nwam_known_wlan_copy(nwam_known_wlan_handle_t oldkwh, const char *newname,
    nwam_known_wlan_handle_t *newkwhp)
{
	return (nwam_copy(NWAM_KNOWN_WLAN_CONF_FILE, oldkwh, newname, newkwhp));
}

nwam_error_t
nwam_known_wlan_delete_prop(nwam_known_wlan_handle_t kwh, const char *propname)
{
	nwam_error_t err;
	void *olddata;

	assert(kwh != NULL && propname != NULL);

	/*
	 * Duplicate data, remove property and validate. If validation
	 * fails, revert to data duplicated prior to remove.
	 */
	if ((err = nwam_dup_object_list(kwh->nwh_data, &olddata))
	    != NWAM_SUCCESS)
		return (err);
	if ((err = nwam_delete_prop(kwh->nwh_data, propname)) != NWAM_SUCCESS) {
		nwam_free_object_list(kwh->nwh_data);
		kwh->nwh_data = olddata;
		return (err);
	}
	if ((err = nwam_known_wlan_validate(kwh, NULL)) != NWAM_SUCCESS) {
		nwam_free_object_list(kwh->nwh_data);
		kwh->nwh_data = olddata;
		return (err);
	}
	nwam_free_object_list(olddata);

	return (NWAM_SUCCESS);
}

nwam_error_t
nwam_known_wlan_set_prop_value(nwam_known_wlan_handle_t kwh,
    const char *propname, nwam_value_t value)
{
	nwam_error_t err;

	assert(kwh != NULL && propname != NULL && value != NULL);

	if ((err = nwam_known_wlan_validate_prop(kwh, propname, value))
	    != NWAM_SUCCESS)
		return (err);

	return (nwam_set_prop_value(kwh->nwh_data, propname, value));
}

nwam_error_t
nwam_known_wlan_get_prop_value(nwam_known_wlan_handle_t kwh,
    const char *propname, nwam_value_t *valuep)
{
	return (nwam_get_prop_value(kwh->nwh_data, propname, valuep));
}

nwam_error_t
nwam_known_wlan_walk_props(nwam_known_wlan_handle_t kwh,
    int (*cb)(const char *, nwam_value_t, void *),
    void *data, uint64_t flags, int *retp)
{
	return (nwam_walk_props(kwh, cb, data, flags, retp));
}

struct priority_collision_data {
	char *wlan_name;
	uint64_t priority;
};

static int
avoid_priority_collisions_cb(nwam_known_wlan_handle_t kwh, void *data)
{
	nwam_value_t priorityval;
	nwam_error_t err;
	struct priority_collision_data *pcd = data;
	char *name;
	uint64_t priority;

	err = nwam_known_wlan_get_name(kwh, &name);
	if (err != NWAM_SUCCESS)
		return (err);
	if (strcmp(name, pcd->wlan_name) == 0) {
		/* skip to-be-updated wlan */
		free(name);
		return (NWAM_SUCCESS);
	}
	free(name);

	err = nwam_known_wlan_get_prop_value(kwh, NWAM_KNOWN_WLAN_PROP_PRIORITY,
	    &priorityval);
	if (err != NWAM_SUCCESS)
		return (err);
	err = nwam_value_get_uint64(priorityval, &priority);
	if (err != NWAM_SUCCESS)
		return (err);
	nwam_value_free(priorityval);

	if (priority < pcd->priority)
		return (NWAM_SUCCESS);

	if (priority == pcd->priority) {
		/* Two priority values collide.  Move this one up. */
		err = nwam_value_create_uint64(priority + 1, &priorityval);
		if (err != NWAM_SUCCESS)
			return (err);
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_PRIORITY, priorityval);
		nwam_value_free(priorityval);
		if (err != NWAM_SUCCESS) {
			return (err);
		}
		/*
		 * We are doing a walk, and will continue shifting until
		 * we find a gap in the priority numbers; thus no need to
		 * do collision checking here.
		 */
		err = nwam_known_wlan_commit(kwh,
		    NWAM_FLAG_KNOWN_WLAN_NO_COLLISION_CHECK);
		if (err != NWAM_SUCCESS)
			return (err);

		(pcd->priority)++;
		return (NWAM_SUCCESS);
	}

	/*
	 * Only possiblity left at this point is that we're looking
	 * at a priority greater than the last one we wrote, so we've
	 * found a gap.  We can halt the walk now.
	 */
	return (NWAM_WALK_HALTED);
}

nwam_error_t
nwam_known_wlan_commit(nwam_known_wlan_handle_t kwh, uint64_t flags)
{
	nwam_error_t err;
	nwam_value_t priorityval;
	int ret = 0;
	struct priority_collision_data pcd;

	assert(kwh != NULL && kwh->nwh_data != NULL);

	if ((err = nwam_known_wlan_validate(kwh, NULL)) != NWAM_SUCCESS)
		return (err);

	/*
	 * If the NO_COLLISION_CHECK flag is set, no need to check for
	 * collision.
	 */
	if (flags & NWAM_FLAG_KNOWN_WLAN_NO_COLLISION_CHECK)
		return (nwam_commit(NWAM_KNOWN_WLAN_CONF_FILE, kwh,
		    (flags & NWAM_FLAG_GLOBAL_MASK) |
		    NWAM_FLAG_ENTITY_KNOWN_WLAN));

	/*
	 * We need to do priority checking.  Walk the list, looking
	 * for the first entry with priority greater than or equal
	 * to the entry we're adding.  Commit the new one (without
	 * doing additional checking), and then increment other
	 * entries as needed.
	 */
	err = nwam_known_wlan_get_prop_value(kwh,
	    NWAM_KNOWN_WLAN_PROP_PRIORITY, &priorityval);
	if (err != NWAM_SUCCESS)
		return (err);
	err = nwam_value_get_uint64(priorityval, &(pcd.priority));
	nwam_value_free(priorityval);
	if (err != NWAM_SUCCESS)
		return (err);
	err = nwam_known_wlan_get_name(kwh, &(pcd.wlan_name));
	if (err != NWAM_SUCCESS)
		return (err);
	err = nwam_walk_known_wlans(avoid_priority_collisions_cb, &pcd,
	    NWAM_FLAG_KNOWN_WLAN_WALK_PRIORITY_ORDER, &ret);
	free(pcd.wlan_name);
	/*
	 * a halted walk is okay, it just means we didn't have
	 * to walk the entire list to resolve priorities
	 */
	if (ret != NWAM_SUCCESS && ret != NWAM_WALK_HALTED)
		return (ret);

	return (nwam_known_wlan_commit(kwh,
	    flags | NWAM_FLAG_KNOWN_WLAN_NO_COLLISION_CHECK));
}

nwam_error_t
nwam_known_wlan_destroy(nwam_known_wlan_handle_t kwh, uint64_t flags)
{
	return (nwam_destroy(NWAM_KNOWN_WLAN_CONF_FILE, kwh,
	    flags | NWAM_FLAG_ENTITY_KNOWN_WLAN));
}

nwam_error_t
nwam_known_wlan_get_prop_description(const char *propname,
    const char **descriptionp)
{
	return (nwam_get_prop_description(known_wlan_prop_table, propname,
	    descriptionp));
}

/* Property-specific value validation functions should go here. */

static nwam_error_t
valid_keyname(nwam_value_t value)
{
	char *keyname;

	if (nwam_value_get_string(value, &keyname) != NWAM_SUCCESS)
		return (NWAM_ENTITY_INVALID_VALUE);

	if (!dladm_valid_secobj_name(keyname))
		return (NWAM_ENTITY_INVALID_VALUE);

	return (NWAM_SUCCESS);
}

static nwam_error_t
valid_keyslot(nwam_value_t value)
{
	uint64_t keyslot;

	if (nwam_value_get_uint64(value, &keyslot) != NWAM_SUCCESS)
		return (NWAM_ENTITY_INVALID_VALUE);

	if (keyslot < 1 || keyslot > 4)
		return (NWAM_ENTITY_INVALID_VALUE);

	return (NWAM_SUCCESS);
}

static nwam_error_t
valid_secmode(nwam_value_t value)
{
	uint64_t secmode;

	if (nwam_value_get_uint64(value, &secmode) != NWAM_SUCCESS)
		return (NWAM_ENTITY_INVALID_VALUE);

	if (secmode != DLADM_WLAN_SECMODE_NONE &&
	    secmode != DLADM_WLAN_SECMODE_WEP &&
	    secmode != DLADM_WLAN_SECMODE_WPA)
		return (NWAM_ENTITY_INVALID_VALUE);

	return (NWAM_SUCCESS);
}

nwam_error_t
nwam_known_wlan_validate(nwam_known_wlan_handle_t kwh, const char **errpropp)
{
	return (nwam_validate(known_wlan_prop_table, kwh, errpropp));
}

nwam_error_t
nwam_known_wlan_validate_prop(nwam_known_wlan_handle_t kwh,
    const char *propname, nwam_value_t value)
{
	return (nwam_validate_prop(known_wlan_prop_table, kwh, propname,
	    value));
}

/*
 * Given a property, return expected property data type
 */
nwam_error_t
nwam_known_wlan_get_prop_type(const char *propname, nwam_value_type_t *typep)
{
	return (nwam_get_prop_type(known_wlan_prop_table, propname, typep));
}

nwam_error_t
nwam_known_wlan_prop_multivalued(const char *propname, boolean_t *multip)
{
	return (nwam_prop_multivalued(known_wlan_prop_table, propname, multip));
}

nwam_error_t
nwam_known_wlan_get_default_proplist(const char ***prop_list,
    uint_t *numvaluesp)
{
	return (nwam_get_default_proplist(known_wlan_prop_table,
	    NWAM_TYPE_ANY, NWAM_CLASS_ANY, prop_list, numvaluesp));
}

/*
 * Add the given ESSID, BSSID, secmode, keyslot and key name to known WLANs.
 * BSSID and keyname can be NULL.
 */
nwam_error_t
nwam_known_wlan_add_to_known_wlans(const char *essid, const char *bssid,
    uint32_t secmode, uint_t keyslot, const char *keyname)
{
	nwam_known_wlan_handle_t kwh;
	nwam_value_t keynameval = NULL, keyslotval = NULL, bssidsval = NULL;
	nwam_value_t secmodeval = NULL, priorityval = NULL;
	char **old_bssids = NULL, **new_bssids;
	uint_t nelem = 0;
	nwam_error_t err;
	int i, j;

	/*
	 * Check if the given ESSID already exists as known WLAN.  If so,
	 * add the BSSID to the bssids property.  If not, create one with
	 * the given ESSID and add BSSID if given.
	 */
	err = nwam_known_wlan_read(essid, 0, &kwh);

	switch (err) {
	case NWAM_ENTITY_NOT_FOUND:
		if ((err = nwam_known_wlan_create(essid, &kwh)) != NWAM_SUCCESS)
			return (err);
		/* New known WLAN - set priority to 0 */
		if ((err = nwam_value_create_uint64(0, &priorityval))
		    != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_PRIORITY, priorityval);
		nwam_value_free(priorityval);
		if (err != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		/* If BSSID is NULL, nothing more to do here. */
		if (bssid == NULL)
			break;
		if ((err = nwam_value_create_string((char *)bssid, &bssidsval))
		    != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		/* Set the bssids property */
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_BSSIDS, bssidsval);
		nwam_value_free(bssidsval);
		if (err != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		break;
	case NWAM_SUCCESS:
		/* If no bssid is specified, nothing to do */
		if (bssid == NULL)
			break;

		/* known WLAN exists, retrieve the existing bssids property */
		err = nwam_known_wlan_get_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_BSSIDS, &bssidsval);
		if (err != NWAM_SUCCESS && err != NWAM_ENTITY_NOT_FOUND) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		if (err == NWAM_SUCCESS) {
			if ((err = nwam_value_get_string_array(bssidsval,
			    &old_bssids, &nelem)) != NWAM_SUCCESS) {
				nwam_value_free(bssidsval);
				nwam_known_wlan_free(kwh);
				return (err);
			}
		}
		/* Create a new array to append given BSSID */
		new_bssids = calloc(nelem + 1, sizeof (char *));
		if (new_bssids == NULL) {
			nwam_value_free(bssidsval);
			nwam_known_wlan_free(kwh);
			return (NWAM_NO_MEMORY);
		}

		/*
		 * Copy over existing BSSIDs to the new array.  Also, check
		 * to make sure that the given BSSID doesn't already exist
		 * in the known WLAN.  If so, do abort copying and return
		 * NWAM_SUCCESS.
		 */
		for (i = 0; i < nelem; i++) {
			if (strcmp(old_bssids[i], bssid) == 0) {
				/* nothing to do, so free up everything */
				for (j = 0; j < i; j++)
					free(new_bssids[j]);
				free(new_bssids);
				nwam_value_free(bssidsval);
				goto set_key_info;
			}
			new_bssids[i] = strdup(old_bssids[i]);
		}
		new_bssids[nelem] = strdup(bssid);
		nwam_value_free(bssidsval);

		err = nwam_value_create_string_array(new_bssids, nelem + 1,
		    &bssidsval);
		for (i = 0; i < nelem + 1; i++)
			free(new_bssids[i]);
		free(new_bssids);
		if (err != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		/* Set the bssids property */
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_BSSIDS, bssidsval);
		nwam_value_free(bssidsval);
		if (err != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		break;
	default:
		return (err);
	}

set_key_info:
	/* Set the security mode property */
	if ((err = nwam_value_create_uint64(secmode, &secmodeval))
	    != NWAM_SUCCESS) {
		nwam_known_wlan_free(kwh);
		return (err);
	}
	err = nwam_known_wlan_set_prop_value(kwh,
	    NWAM_KNOWN_WLAN_PROP_SECURITY_MODE, secmodeval);
	nwam_value_free(secmodeval);

	if (err != NWAM_SUCCESS) {
		nwam_known_wlan_free(kwh);
		return (err);
	}

	if (keyname != NULL) {
		if ((err = nwam_value_create_string((char *)keyname,
		    &keynameval)) != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_KEYNAME, keynameval);
		nwam_value_free(keynameval);
		if (err != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		if ((err = nwam_value_create_uint64(keyslot,
		    &keyslotval)) != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		err = nwam_known_wlan_set_prop_value(kwh,
		    NWAM_KNOWN_WLAN_PROP_KEYSLOT, keyslotval);
		nwam_value_free(keyslotval);
	}

	err = nwam_known_wlan_commit(kwh, 0);
	nwam_known_wlan_free(kwh);

	return (err);
}

/*
 * Remove the given BSSID/keyname from the bssids/keyname property for the
 * given ESSID.
 */
nwam_error_t
nwam_known_wlan_remove_from_known_wlans(const char *essid, const char *bssid,
    const char *keyname)
{
	nwam_known_wlan_handle_t kwh;
	nwam_value_t bssidsval;
	char **old_bssids, **new_bssids;
	uint_t nelem;
	nwam_error_t err;
	int i, found = -1;

	/* Retrieve the existing bssids */
	if ((err = nwam_known_wlan_read(essid, 0, &kwh)) != NWAM_SUCCESS)
		return (err);
	if ((err = nwam_known_wlan_get_prop_value(kwh,
	    NWAM_KNOWN_WLAN_PROP_BSSIDS, &bssidsval)) != NWAM_SUCCESS) {
		nwam_known_wlan_free(kwh);
		return (err);
	}
	if ((err = nwam_value_get_string_array(bssidsval, &old_bssids, &nelem))
	    != NWAM_SUCCESS) {
		nwam_value_free(bssidsval);
		nwam_known_wlan_free(kwh);
		return (err);
	}

	/* Cycle through the BSSIDs array to find the BSSID to remove */
	for (i = 0; i < nelem; i++) {
		if (strcmp(old_bssids[i], bssid)  == 0) {
			found = i;
			break;
		}
	}

	/* Given BSSID was not found in the array */
	if (found == -1) {
		nwam_value_free(bssidsval);
		nwam_known_wlan_free(kwh);
		return (NWAM_INVALID_ARG);
	}

	/* If removing the only BSSID entry, remove the bssids property */
	if (nelem == 1) {
		nwam_value_free(bssidsval);
		if ((err = nwam_known_wlan_delete_prop(kwh,
		    NWAM_KNOWN_WLAN_PROP_BSSIDS)) != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		err = nwam_known_wlan_commit(kwh, 0);
		nwam_known_wlan_free(kwh);
		return (err);
	}

	new_bssids = calloc(nelem - 1, sizeof (char *));
	if (new_bssids == NULL) {
		nwam_value_free(bssidsval);
		nwam_known_wlan_free(kwh);
		return (NWAM_NO_MEMORY);
	}

	/* Copy over other BSSIDs */
	for (i = 0; i < found; i++)
		new_bssids[i] = strdup(old_bssids[i]);
	for (i = found + 1; i < nelem; i++)
		new_bssids[i-1] = strdup(old_bssids[i]);
	nwam_value_free(bssidsval);

	err = nwam_value_create_string_array(new_bssids, nelem - 1, &bssidsval);
	for (i = 0; i < nelem - 1; i++)
		free(new_bssids[i]);
	free(new_bssids);
	if (err != NWAM_SUCCESS) {
		nwam_known_wlan_free(kwh);
		return (err);
	}

	/* Set the bssids property */
	err = nwam_known_wlan_set_prop_value(kwh, NWAM_KNOWN_WLAN_PROP_BSSIDS,
	    bssidsval);
	nwam_value_free(bssidsval);
	if (err != NWAM_SUCCESS) {
		nwam_known_wlan_free(kwh);
		return (err);
	}

	if (keyname != NULL) {
		if ((err = nwam_known_wlan_delete_prop(kwh,
		    NWAM_KNOWN_WLAN_PROP_KEYNAME)) != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
		if ((err = nwam_known_wlan_delete_prop(kwh,
		    NWAM_KNOWN_WLAN_PROP_KEYSLOT)) != NWAM_SUCCESS) {
			nwam_known_wlan_free(kwh);
			return (err);
		}
	}

	err = nwam_known_wlan_commit(kwh, 0);
	nwam_known_wlan_free(kwh);

	return (err);
}