libnwam.h revision 6ba597c56d749c61b4f783157f63196d7b2445f0
/*
* 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
* 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 data structures and APIs of libnwam.
* Implementation is MT safe.
*/
#ifndef _LIBNWAM_H
#define _LIBNWAM_H
#ifdef __cplusplus
extern "C" {
#endif
/*
* Note - several interface functions below are not utilized in ON, but are
* used by the GNOME nwam-manager. One example is nwam_enm_get_name().
*/
/*
* Common definitions
*/
/* nwam FMRI and properties */
#define NWAM_PG "nwamd"
#define NWAM_PROP_ACTIVE_NCP "active_ncp"
/* Block waiting for commit if necessary */
#define NWAM_FLAG_BLOCKING 0x00000001
/* Committed object must be new */
#define NWAM_FLAG_CREATE 0x00000002
/* Tell destroy functions not to free handle */
#define NWAM_FLAG_DO_NOT_FREE 0x00000004
#define NWAM_FLAG_ENTITY_ENABLE 0x00000008
/* Known WLAN being read, committed or destroyed */
#define NWAM_FLAG_ENTITY_KNOWN_WLAN 0x00000010
/* nwam flags used for selecting ncu type for walk */
#define NWAM_FLAG_NCU_TYPE_ALL (NWAM_FLAG_NCU_TYPE_LINK | \
/* nwam flags used for selecting ncu class for walk */
#define NWAM_FLAG_NCU_CLASS_ALL (NWAM_FLAG_NCU_CLASS_ALL_INTERFACE | \
#define NWAM_FLAG_NCU_TYPE_CLASS_ALL (NWAM_FLAG_NCU_CLASS_ALL | \
/* flags used for selecting activation for walk */
/* Walk known WLANs in order of priority (lowest first) */
/* Do not perform priority collision checking for known WLANs */
/* nwam return codes */
typedef enum {
NWAM_SUCCESS, /* No error occured */
NWAM_LIST_END, /* End of list reached */
NWAM_INVALID_HANDLE, /* Entity handle is invalid */
NWAM_HANDLE_UNBOUND, /* Handle not bound to entity */
NWAM_INVALID_ARG, /* Argument is invalid */
NWAM_PERMISSION_DENIED, /* Insufficient privileges for action */
NWAM_NO_MEMORY, /* Out of memory */
NWAM_ENTITY_EXISTS, /* Entity already exists */
NWAM_ENTITY_IN_USE, /* Entity in use */
NWAM_ENTITY_COMMITTED, /* Entity already committed */
NWAM_ENTITY_NOT_FOUND, /* Entity not found */
NWAM_ENTITY_TYPE_MISMATCH, /* Entity type mismatch */
NWAM_ENTITY_INVALID, /* Validation of entity failed */
NWAM_ENTITY_INVALID_MEMBER, /* Entity member invalid */
NWAM_ENTITY_INVALID_STATE, /* Entity is not in appropriate state */
NWAM_ENTITY_INVALID_VALUE, /* Validation of entity value failed */
NWAM_ENTITY_MISSING_MEMBER, /* Required member is missing */
NWAM_ENTITY_NO_VALUE, /* No value associated with entity */
NWAM_ENTITY_MULTIPLE_VALUES, /* Multiple values for entity */
NWAM_ENTITY_READ_ONLY, /* Entity is marked read only */
NWAM_ENTITY_NOT_DESTROYABLE, /* Entity cannot be destroyed */
NWAM_ENTITY_NOT_MANUAL, /* Entity cannot be manually enabled/disabled */
NWAM_WALK_HALTED, /* Callback function returned nonzero */
NWAM_ERROR_BIND, /* Could not bind to backend */
NWAM_ERROR_BACKEND_INIT, /* Could not initialize backend */
NWAM_ERROR_INTERNAL /* Internal error */
} nwam_error_t;
#define NWAM_MAX_NAME_LEN 128
#define NWAM_MAX_VALUE_LEN 256
#define NWAM_MAX_FMRI_LEN NWAM_MAX_VALUE_LEN
#define NWAM_MAX_NUM_VALUES 32
#define NWAM_MAX_NUM_PROPERTIES 32
/* used for getting and setting of properties */
typedef enum {
/* Holds values of various types for getting and setting of properties */
/* Forward definition */
struct nwam_value;
typedef struct nwam_value *nwam_value_t;
/* Value-related functions. */
nwam_value_t *);
nwam_value_t *);
nwam_value_t *);
nwam_value_t *);
uint_t *);
uint_t *);
uint_t *);
uint_t *);
extern void nwam_value_free(nwam_value_t);
const char **);
extern nwam_error_t nwam_value_string_get_uint64(const char *, const char *,
uint64_t *);
/*
* To retrieve a localized error string
*/
extern const char *nwam_strerror(nwam_error_t);
/*
* State and auxiliary state describe the state of ENMs, NCUs and locations.
*/
typedef enum {
NWAM_STATE_UNINITIALIZED = 0x0,
NWAM_STATE_INITIALIZED = 0x1,
NWAM_STATE_OFFLINE = 0x2,
NWAM_STATE_OFFLINE_TO_ONLINE = 0x4,
NWAM_STATE_ONLINE_TO_OFFLINE = 0x8,
NWAM_STATE_ONLINE = 0x10,
NWAM_STATE_MAINTENANCE = 0x20,
NWAM_STATE_DEGRADED = 0x40,
NWAM_STATE_DISABLED = 0x80
} nwam_state_t;
#define NWAM_STATE_ANY (NWAM_STATE_UNINITIALIZED | \
/*
* The auxiliary state denotes specific reasons why an object is in a particular
* state (e.g. "script failed", "disabled by administrator", "waiting for DHCP
* response").
*/
typedef enum {
/* General auxiliary states */
/* Link-specific auxiliary states */
/* IP interface-specific auxiliary states */
/* Activation modes */
typedef enum {
/*
* Conditions are of the form
*
* ncu|enm|loc name is|is-not active
* ip-address is|is-not|is-in-range|is-not-in-range ipaddr[/prefixlen]
* advertised-domain is|is-not|contains|does-not-contain string
* system-domain is|is-not|contains|does-not-contain string
* essid is|is-not|contains|does-not-contain string
* bssid is|is-not <string>
*/
typedef enum {
typedef enum {
/*
* Activation condition-related functions that convert activation
* values to an appropriate string and back.
*/
nwam_condition_object_type_t, nwam_condition_t, const char *, char **);
extern nwam_error_t nwam_condition_string_to_condition(const char *,
nwam_condition_object_type_t *, nwam_condition_t *, char **);
/*
* Only one location can be active at one time. As a
* consequence, if the activation conditions of multiple
* locations are satisfied, we need to compare activation
* conditions to see if one is more specific than another.
*
* The following heuristics are applied to rate an
* activation condition:
* - "is" is the most specific condition
* - it is followed by "is-in-range" and "contains"
* - "is-not-in-range" and "does-not-contain" are next
* - finally "is-not" is least specific
*
* Regarding the objects these conditions apply to:
* - NCU, ENM and locations are most specific
* - system-domain is next
* - advertised-domain is next
* - IP address is next
* - wireless BSSID is next
* - wireless ESSID is least specific
*
*/
nwam_condition_t, uint64_t *);
/*
* Location definitions.
*/
#define NWAM_LOC_NAME_AUTOMATIC "Automatic"
#define NWAM_LOC_NAME_NO_NET "NoNet"
#define NWAM_LOC_NAME_LEGACY "Legacy"
#define NWAM_LOC_NAME_PRE_DEFINED(name) \
/* Forward definition */
struct nwam_handle;
typedef struct nwam_handle *nwam_loc_handle_t;
/* Location properties */
typedef enum {
typedef enum {
#define NWAM_LOC_PROP_ACTIVATION_MODE "activation-mode"
#define NWAM_LOC_PROP_CONDITIONS "conditions"
#define NWAM_LOC_PROP_ENABLED "enabled"
/* Nameservice location properties */
#define NWAM_LOC_PROP_NAMESERVICES "nameservices"
#define NWAM_LOC_PROP_NAMESERVICES_CONFIG_FILE "nameservices-config-file"
#define NWAM_LOC_PROP_DNS_NAMESERVICE_CONFIGSRC "dns-nameservice-configsrc"
#define NWAM_LOC_PROP_DNS_NAMESERVICE_DOMAIN "dns-nameservice-domain"
#define NWAM_LOC_PROP_DNS_NAMESERVICE_SERVERS "dns-nameservice-servers"
#define NWAM_LOC_PROP_DNS_NAMESERVICE_SEARCH "dns-nameservice-search"
#define NWAM_LOC_PROP_NIS_NAMESERVICE_CONFIGSRC "nis-nameservice-configsrc"
#define NWAM_LOC_PROP_NIS_NAMESERVICE_SERVERS "nis-nameservice-servers"
#define NWAM_LOC_PROP_LDAP_NAMESERVICE_CONFIGSRC "ldap-nameservice-configsrc"
#define NWAM_LOC_PROP_LDAP_NAMESERVICE_SERVERS "ldap-nameservice-servers"
#define NWAM_LOC_PROP_DEFAULT_DOMAIN "default-domain"
/* NFSv4 domain */
#define NWAM_LOC_PROP_NFSV4_DOMAIN "nfsv4-domain"
/* IPfilter configuration */
#define NWAM_LOC_PROP_IPFILTER_CONFIG_FILE "ipfilter-config-file"
#define NWAM_LOC_PROP_IPFILTER_V6_CONFIG_FILE "ipfilter-v6-config-file"
#define NWAM_LOC_PROP_IPNAT_CONFIG_FILE "ipnat-config-file"
#define NWAM_LOC_PROP_IPPOOL_CONFIG_FILE "ippool-config-file"
/* IPsec configuration */
#define NWAM_LOC_PROP_IKE_CONFIG_FILE "ike-config-file"
#define NWAM_LOC_PROP_IPSECPOLICY_CONFIG_FILE "ipsecpolicy-config-file"
/*
*/
#define NWAM_NCP_NAME_AUTOMATIC "Automatic"
#define NWAM_NCP_NAME_USER "User"
#define NWAM_NCP_AUTOMATIC(name) \
typedef struct nwam_handle *nwam_ncp_handle_t;
typedef struct nwam_handle *nwam_ncu_handle_t;
typedef enum {
NWAM_NCU_TYPE_UNKNOWN = -1,
typedef enum {
NWAM_NCU_CLASS_UNKNOWN = -1,
typedef enum {
typedef enum {
#define NWAM_NCU_PROP_TYPE "type"
#define NWAM_NCU_PROP_CLASS "class"
#define NWAM_NCU_PROP_PARENT_NCP "parent"
#define NWAM_NCU_PROP_ACTIVATION_MODE "activation-mode"
#define NWAM_NCU_PROP_ENABLED "enabled"
#define NWAM_NCU_PROP_PRIORITY_GROUP "priority-group"
#define NWAM_NCU_PROP_PRIORITY_MODE "priority-mode"
/* Link NCU properties */
#define NWAM_NCU_PROP_LINK_MAC_ADDR "link-mac-addr"
#define NWAM_NCU_PROP_LINK_AUTOPUSH "link-autopush"
#define NWAM_NCU_PROP_LINK_MTU "link-mtu"
/* IP NCU properties */
#define NWAM_NCU_PROP_IP_VERSION "ip-version"
#define NWAM_NCU_PROP_IPV4_ADDRSRC "ipv4-addrsrc"
#define NWAM_NCU_PROP_IPV4_ADDR "ipv4-addr"
#define NWAM_NCU_PROP_IPV4_DEFAULT_ROUTE "ipv4-default-route"
#define NWAM_NCU_PROP_IPV6_ADDRSRC "ipv6-addrsrc"
#define NWAM_NCU_PROP_IPV6_ADDR "ipv6-addr"
#define NWAM_NCU_PROP_IPV6_DEFAULT_ROUTE "ipv6-default-route"
/* Some properties should only be set on creation */
#define NWAM_NCU_PROP_SETONCE(prop) \
/*
* ENM definitions
*/
typedef struct nwam_handle *nwam_enm_handle_t;
#define NWAM_ENM_PROP_ACTIVATION_MODE "activation-mode"
#define NWAM_ENM_PROP_CONDITIONS "conditions"
#define NWAM_ENM_PROP_ENABLED "enabled"
/* FMRI associated with ENM */
#define NWAM_ENM_PROP_FMRI "fmri"
#define NWAM_ENM_PROP_START "start"
#define NWAM_ENM_PROP_STOP "stop"
/*
* Known Wireless LAN info (known WLAN) definitions.
*/
typedef struct nwam_handle *nwam_known_wlan_handle_t;
#define NWAM_KNOWN_WLAN_PROP_BSSIDS "bssids"
#define NWAM_KNOWN_WLAN_PROP_PRIORITY "priority"
#define NWAM_KNOWN_WLAN_PROP_KEYNAME "keyname"
#define NWAM_KNOWN_WLAN_PROP_KEYSLOT "keyslot"
#define NWAM_KNOWN_WLAN_PROP_SECURITY_MODE "security-mode"
/*
* Location Functions
*/
/* Create a location */
/* Copy a location */
/* Read a location from persistent storage */
/* Validate in-memory representation of a location */
/* Commit in-memory representation of a location to persistent storage */
/* Destroy a location in persistent storage */
/* Free in-memory representation of a location */
extern void nwam_loc_free(nwam_loc_handle_t);
/* read all locs from persistent storage and walk through each at a time */
uint64_t, int *);
/* activate/deactivate loc */
/* walk all properties of an in-memory loc */
int (*)(const char *, nwam_value_t, void *),
void *, uint64_t, int *);
const char *);
const char *, nwam_value_t *);
const char *, nwam_value_t);
/* Get the read-only value for a particular loc property */
/* Whether the property is multi-valued or not */
/* Retrieve data type */
/* Retrieve description */
extern nwam_error_t nwam_loc_get_prop_description(const char *, const char **);
/* get default loc props */
/* get sstate of loc from nwamd */
nwam_aux_state_t *);
/* Get whether the loc has manual activation-mode or not */
/*
*/
/* Create an ncp */
/* Read an ncp from persistent storage */
/* Make a copy of existing ncp */
/* Walk ncps */
void *, uint64_t, int *);
/* Get ncp name */
/* Get the read-only value for this ncp */
/* Destroy ncp */
/*
* be selected via flags, or all via NWAM_FLAG_ALL.
*/
int(*)(nwam_ncu_handle_t, void *), void *, uint64_t, int *);
/* Activate ncp */
/* Free in-memory representation of ncp */
extern void nwam_ncp_free(nwam_ncp_handle_t);
/* Get state of NCP from nwamd */
nwam_aux_state_t *);
/* Get the active priority-group */
/* Create an ncu or read it from persistent storage */
/* Destroy an ncu in persistent storage or free the in-memory representation */
extern void nwam_ncu_free(nwam_ncu_handle_t);
/* make a copy of existing ncu */
/* Commit ncu changes to persistent storage */
/* activate/deactivate an individual NCU (must be part of the active NCP) */
/* Get state of NCU from nwamd */
nwam_aux_state_t *);
/* Get NCU type */
/* Get NCU class */
nwam_ncu_class_t *);
/* Validate ncu content */
/* Walk all properties in in-memory representation of ncu */
int (*)(const char *, nwam_value_t, void *),
void *, uint64_t, int *);
char **);
char **);
nwam_ncu_class_t, const char ***, uint_t *);
const char *);
const char *, nwam_value_t *);
const char *, nwam_value_t);
/* Retrieve data type */
/* Retrieve prop description */
extern nwam_error_t nwam_ncu_get_prop_description(const char *, const char **);
/* Get the read-only value from the handle or parent NCP */
/* Get the read-only value for a particular NCU property */
/* Whether the property is multi-valued or not */
/* Get whether the NCU has manual activation-mode or not */
/* Get the flag from the given class for walks */
/* Get the NCU type from the given class */
/* ENM functions */
/*
* Obtain a specific enm handle, either be creating a new enm
* or reading an existing one from persistent storage.
*/
extern nwam_error_t nwam_enm_create(const char *, const char *,
/* Make a copy of existing enm */
/*
* Obtain handles for all existing enms. Caller-specified callback
* function will be called once for each enm, passing the handle and
* the caller-specified arg.
*/
uint64_t, int *);
/*
* Commit an enm to persistent storage. Does not free the handle.
*/
/*
* Remove an enm from persistent storage.
*/
/*
* Free an enm handle
*/
extern void nwam_enm_free(nwam_enm_handle_t);
/*
* Validate an enm, or a specific enm property. If validating
* an entire enm, the invalid property type is returned.
*/
/* Retrieve data type */
/* Retrieve prop description */
extern nwam_error_t nwam_enm_get_prop_description(const char *, const char **);
/*
*/
const char *);
const char *, nwam_value_t *);
const char *, nwam_value_t);
/* Get the read-only value for a particular ENM property */
/* Whether the property is multi-valued or not */
/*
* Walk all properties of a specific enm. For each property, specified
* callback function is called. Caller is responsible for freeing memory
* allocated for each property.
*/
int (*)(const char *, nwam_value_t, void *),
void *, uint64_t, int *);
/*
* allocate a buffer; the caller is responsible for freeing the memory.
*/
/*
*/
/*
* Get state of ENM from nwamd.
*/
nwam_aux_state_t *);
/*
* Get whether the ENM has manual activation-mode or not.
*/
/*
* Known Wireless LAN (WLAN) info.
*/
/* Create a known WLAN */
extern nwam_error_t nwam_known_wlan_create(const char *,
/* Read a known WLAN from persistent storage */
/*
* Destroy a known WLAN in persistent storage or free the in-memory
* representation.
*/
extern void nwam_known_wlan_free(nwam_known_wlan_handle_t);
/* make a copy of existing known WLAN */
/* Commit known WLAN changes to persistent storage */
/* Validate known WLAN content */
const char **);
/* Walk known WLANs */
(int(*)(nwam_known_wlan_handle_t, void *), void *, uint64_t, int *);
const char *);
/* walk all properties of an in-memory known WLAN */
int (*)(const char *, nwam_value_t, void *),
void *, uint64_t, int *);
const char *);
const char *, nwam_value_t *);
const char *, nwam_value_t);
const char *, nwam_value_t);
/* Retrieve data type */
extern nwam_error_t nwam_known_wlan_get_prop_type(const char *,
/* Retrieve prop description */
extern nwam_error_t nwam_known_wlan_get_prop_description(const char *,
const char **);
/* get default known WLAN props */
extern nwam_error_t nwam_known_wlan_get_default_proplist(const char ***,
uint_t *);
/* Whether the property is multi-valued or not */
/* Add a bssid to the known WLANs */
extern nwam_error_t nwam_known_wlan_add_to_known_wlans(const char *,
/* Remove a bssid from known WLANs */
extern nwam_error_t nwam_known_wlan_remove_from_known_wlans(const char *,
const char *, const char *);
/*
* nwam_wlan_get_scan_results(). The following fields are valid:
*
* - for scan and need choice event, ESSID, BSSID, signal strength, security
* mode, speed, channel, bsstype, key index, and if we already have a key
* (have_key), if the WLAN is the current selection (selected) and
* if the current WLAN is connected (connected).
* - for need key events, ESSID, security mode, have_key, selected and connected
* values are set. The rest of the fields are not set since multiple WLANs
* may match the ESSID and have different speeds, channels etc. If an
*
*/
typedef struct {
char nww_essid[NWAM_MAX_NAME_LEN];
char nww_bssid[NWAM_MAX_NAME_LEN];
} nwam_wlan_t;
/*
*/
extern nwam_error_t nwam_wlan_scan(const char *);
nwam_wlan_t **);
extern nwam_error_t nwam_wlan_select(const char *, const char *, const char *,
extern nwam_error_t nwam_wlan_set_key(const char *, const char *, const char *,
/*
* Event notification definitions
*/
#define NWAM_EVENT_TYPE_NOOP 0
#define NWAM_EVENT_TYPE_INIT 1
#define NWAM_EVENT_TYPE_SHUTDOWN 2
#define NWAM_EVENT_TYPE_OBJECT_ACTION 3
#define NWAM_EVENT_TYPE_OBJECT_STATE 4
#define NWAM_EVENT_TYPE_PRIORITY_GROUP 5
#define NWAM_EVENT_TYPE_INFO 6
#define NWAM_EVENT_TYPE_WLAN_SCAN_REPORT 7
#define NWAM_EVENT_TYPE_WLAN_NEED_CHOICE 8
#define NWAM_EVENT_TYPE_WLAN_NEED_KEY 9
#define NWAM_EVENT_TYPE_WLAN_CONNECTION_REPORT 10
#define NWAM_EVENT_TYPE_IF_ACTION 11
#define NWAM_EVENT_TYPE_IF_STATE 12
#define NWAM_EVENT_TYPE_LINK_ACTION 13
#define NWAM_EVENT_TYPE_LINK_STATE 14
#define NWAM_EVENT_STATUS_OK 0
#define NWAM_EVENT_STATUS_NOT_HANDLED 1
#define NWAM_EVENT_NETWORK_OBJECT_UNDEFINED 0
#define NWAM_EVENT_NETWORK_OBJECT_LINK 1
#define NWAM_EVENT_NETWORK_OBJECT_INTERFACE 2
#define NWAM_EVENT_REQUEST_UNDEFINED 0
#define NWAM_EVENT_REQUEST_WLAN 1
#define NWAM_EVENT_REQUEST_KEY 2
/*
* Actions for nwamd to perform, used in conjunction with
* nwam_request_type_t in nwam_door_arg_t.
* Add string representations to nwam_action_to_string() in libnwam_util.c.
*/
typedef enum {
NWAM_ACTION_UNKNOWN = -1,
typedef enum {
NWAM_OBJECT_TYPE_UNKNOWN = -1,
NWAM_OBJECT_TYPE_NCP = 0,
NWAM_OBJECT_TYPE_NCU = 1,
NWAM_OBJECT_TYPE_LOC = 2,
NWAM_OBJECT_TYPE_ENM = 3,
typedef struct nwam_event *nwam_event_t;
struct nwam_event {
int nwe_type;
union {
struct nwam_event_object_action {
char nwe_name[NWAM_MAX_NAME_LEN];
char nwe_parent[NWAM_MAX_NAME_LEN];
struct nwam_event_object_state {
char nwe_name[NWAM_MAX_NAME_LEN];
char nwe_parent[NWAM_MAX_NAME_LEN];
struct nwam_event_priority_group_info {
struct nwam_event_info {
char nwe_message[NWAM_MAX_VALUE_LEN];
} nwe_info;
/*
* wlan_info stores both scan results and the single
* WLAN we require a key for in the case of _WLAN_NEED_KEY
* events. For _WLAN_CONNECTION_REPORT events, it stores
*/
struct nwam_event_wlan_info {
char nwe_name[NWAM_MAX_NAME_LEN];
/*
* space may be allocated by user here for the
* number of wlans
*/
struct nwam_event_if_action {
char nwe_name[NWAM_MAX_NAME_LEN];
struct nwam_event_if_state {
char nwe_name[NWAM_MAX_NAME_LEN];
struct sockaddr_storage nwe_addr;
/* might be longer then sizeof(if_state) for addr */
} nwe_if_state;
struct nwam_event_link_state {
char nwe_name[NWAM_MAX_NAME_LEN];
struct nwam_event_link_action {
char nwe_name[NWAM_MAX_NAME_LEN];
} nwe_data;
};
/* NWAM client functions, used to register/unregister and receive events */
extern nwam_error_t nwam_events_init(void);
extern void nwam_events_fini(void);
extern void nwam_event_free(nwam_event_t);
/* Event-related string conversion functions */
extern const char *nwam_action_to_string(nwam_action_t);
extern const char *nwam_event_type_to_string(int);
extern const char *nwam_state_to_string(nwam_state_t);
extern const char *nwam_aux_state_to_string(nwam_aux_state_t);
extern const char *nwam_object_type_to_string(nwam_object_type_t);
extern nwam_object_type_t nwam_string_to_object_type(const char *);
/* Utility strtok_r-like function */
extern char *nwam_tokenize_by_unescaped_delim(char *, char, char **);
#ifdef __cplusplus
}
#endif
#endif /* _LIBNWAM_H */