OpenSolaris_b135/lib/libnwam/common/libnwam_priv.h

/*
 * 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.
 */

/*
 * This file contains private data structures and APIs of libnwam.  Currently
 * these are used by nwamd (nwam_event_*() and nwam_record_audit_event()) and
 * netcfgd (nwam_backend_*()) only, supporting the event messaging, audit
 * and backend configuration access that nwamd and netcfgd supply.
 *
 * Implementation is MT safe.
 */
#ifndef _LIBNWAM_PRIV_H
#define	_LIBNWAM_PRIV_H

#ifdef	__cplusplus
extern "C" {
#endif

#include <libnwam.h>

/* Name of directory containing the doors */
#define	NWAM_DOOR_DIR		"/etc/svc/volatile/nwam"

/* Name of door used to communicate with libnwam backend (in netcfgd) */
#define	NWAM_BACKEND_DOOR_FILE	NWAM_DOOR_DIR "/nwam_backend_door"

/* Name of door used to communicate with nwamd */
#define	NWAM_DOOR		NWAM_DOOR_DIR "/nwam_door"

/* Requests to nwamd door */
typedef enum {
	NWAM_REQUEST_TYPE_NOOP,
	NWAM_REQUEST_TYPE_EVENT_REGISTER,
	NWAM_REQUEST_TYPE_EVENT_UNREGISTER,
	NWAM_REQUEST_TYPE_ACTION,
	NWAM_REQUEST_TYPE_STATE,
	NWAM_REQUEST_TYPE_PRIORITY_GROUP,
	NWAM_REQUEST_TYPE_WLAN_SCAN,
	NWAM_REQUEST_TYPE_WLAN_SCAN_RESULTS,
	NWAM_REQUEST_TYPE_WLAN_SELECT,
	NWAM_REQUEST_TYPE_WLAN_SET_KEY
} nwam_request_type_t;

/* Status returned by nwamd door */
typedef enum {
	NWAM_REQUEST_STATUS_OK,
	NWAM_REQUEST_STATUS_FAILED,
	NWAM_REQUEST_STATUS_UNKNOWN,
	NWAM_REQUEST_STATUS_ALREADY
} nwam_request_status_t;

#define	NWAMD_MAX_NUM_WLANS	64

typedef union {
	/* Used for EVENT_[UN]REGISTER requests */
	struct {
		char nwdad_name[MAXPATHLEN];
	} nwdad_register_info;

	/* Used for ACTION requests */
	struct {
		nwam_object_type_t nwdad_object_type;
		char nwdad_name[NWAM_MAX_NAME_LEN];
		char nwdad_parent[NWAM_MAX_NAME_LEN];
		nwam_action_t nwdad_action;
	} nwdad_object_action;

	/* Used for STATE requests */
	struct {
		nwam_object_type_t nwdad_object_type;
		char nwdad_name[NWAM_MAX_NAME_LEN];
		char nwdad_parent[NWAM_MAX_NAME_LEN];
		nwam_state_t nwdad_state;
		nwam_aux_state_t nwdad_aux_state;
	} nwdad_object_state;

	/* Used for PRIORITY_GROUP requests */
	struct {
		int64_t nwdad_priority;
	} nwdad_priority_group_info;

	/* Used for WLAN request/responses */
	struct {
		char nwdad_name[NWAM_MAX_NAME_LEN];
		char nwdad_essid[NWAM_MAX_NAME_LEN];
		char nwdad_bssid[NWAM_MAX_NAME_LEN];
		uint32_t nwdad_security_mode;
		char nwdad_key[NWAM_MAX_NAME_LEN];
		uint_t nwdad_keyslot;
		boolean_t nwdad_add_to_known_wlans;
		uint_t nwdad_num_wlans;
		nwam_wlan_t nwdad_wlans[NWAMD_MAX_NUM_WLANS];
	} nwdad_wlan_info;

} nwamd_door_arg_data_t;

typedef struct {
	nwam_request_type_t nwda_type;
	nwam_request_status_t nwda_status;
	nwam_error_t nwda_error;
	nwamd_door_arg_data_t nwda_data;
} nwamd_door_arg_t;

typedef enum {
	NWAM_BACKEND_DOOR_CMD_READ_REQ,
	NWAM_BACKEND_DOOR_CMD_UPDATE_REQ,
	NWAM_BACKEND_DOOR_CMD_REMOVE_REQ
} nwam_backend_door_cmd_t;

typedef struct nwam_backend_door_arg {
	nwam_backend_door_cmd_t nwbda_cmd;
	char nwbda_dbname[MAXPATHLEN];			/* config filename */
	char nwbda_object[NWAM_MAX_NAME_LEN];		/* config object */
	size_t nwbda_datalen;				/* data follows arg */
	nwam_error_t nwbda_result;			/* return code */
	uint64_t nwbda_flags;
} nwam_backend_door_arg_t;

/*
 * Functions needed to initialize/stop processing of libnwam backend data
 * (used in netcfgd).
 */
extern nwam_error_t nwam_backend_init(void);
extern void nwam_backend_fini(void);

/*
 * create audit session, report event, end session.  Used by nwamd.
 */
extern void nwam_record_audit_event(const ucred_t *, au_event_t, char *, char *,
    int, int);

/*
 * NWAM daemon functions, used to send, stop sending, initialize or finish
 * event IPC.  Used by nwamd.
 */
extern nwam_error_t nwam_event_send(nwam_event_t);
extern void nwam_event_send_fini(void);
extern nwam_error_t nwam_event_queue_init(const char *);
extern void nwam_event_queue_fini(const char *);

#ifdef	__cplusplus
}
#endif

#endif	/* _LIBNWAM_PRIV_H */