/*
 * This file and its contents are supplied under the terms of the
 * Common Development and Distribution License ("CDDL"), version 1.0.
 * You may only use this file in accordance with the terms of version
 * 1.0 of the CDDL.
 *
 * A full copy of the text of the CDDL should have accompanied this
 * source.  A copy of the CDDL is also available via the Internet at
 * http://www.illumos.org/license/CDDL.
 */

/*
 * Copyright (c) 2015 Joyent, Inc.
 * Copyright 2020 OmniOS Community Edition (OmniOSce) Association.
 */

#ifndef _LIBDLOVERLAY_H
#define	_LIBDLOVERLAY_H

/*
 * libdladm Overlay device routines
 */

#include <libdladm.h>
#include <libdladm_impl.h>
#include <sys/overlay.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dladm_overlay_attr {
	datalink_id_t		oa_linkid;
	char			oa_name[MAXLINKNAMELEN];
	char			oa_encap[OVERLAY_PROP_SIZEMAX];
	char			oa_search[OVERLAY_PROP_SIZEMAX];
	uint64_t		oa_vid;
	uint32_t		oa_flags;
} dladm_overlay_attr_t;

#define	DLADM_OVERLAY_F_DROP	0x0001
#define	DLADM_OVERLAY_F_DEFAULT	0xf000

typedef struct dladm_overlay_point {
	uint_t			dop_dest;
	struct ether_addr	dop_mac;
	uint16_t		dop_flags;
	struct in6_addr		dop_ip;
	uint16_t		dop_port;
} dladm_overlay_point_t;

typedef struct dladm_overlay_status {
	boolean_t	dos_degraded;
	char		dos_fmamsg[256];
} dladm_overlay_status_t;

extern dladm_status_t dladm_overlay_create(dladm_handle_t, const char *,
    const char *, const char *, uint64_t, dladm_arg_list_t *, dladm_errlist_t *,
    uint32_t);
extern dladm_status_t dladm_overlay_delete(dladm_handle_t, datalink_id_t,
    uint32_t);
extern dladm_status_t dladm_overlay_up(dladm_handle_t, datalink_id_t,
    dladm_errlist_t *);

typedef void (*dladm_overlay_status_f)(dladm_handle_t, datalink_id_t,
    dladm_overlay_status_t *, void *);
extern dladm_status_t dladm_overlay_status(dladm_handle_t, datalink_id_t,
    dladm_overlay_status_f, void *);

extern dladm_status_t dladm_overlay_cache_flush(dladm_handle_t, datalink_id_t);
extern dladm_status_t dladm_overlay_cache_delete(dladm_handle_t, datalink_id_t,
    const struct ether_addr *);
extern dladm_status_t dladm_overlay_cache_set(dladm_handle_t, datalink_id_t,
    const struct ether_addr *, char *);
extern dladm_status_t dladm_overlay_cache_get(dladm_handle_t, datalink_id_t,
    const struct ether_addr *, dladm_overlay_point_t *);

#define	DLADM_OVERLAY_PROP_SIZEMAX	256
#define	DLADM_OVERLAY_PROP_NAMELEN	32

typedef struct __dladm_overlay_propinfo *dladm_overlay_propinfo_handle_t;

extern dladm_status_t dladm_overlay_prop_info(dladm_overlay_propinfo_handle_t,
    const char **, uint_t *, uint_t *, const void **, uint32_t *,
    const mac_propval_range_t **);
extern dladm_status_t dladm_overlay_get_prop(dladm_handle_t, datalink_id_t,
    dladm_overlay_propinfo_handle_t, void *buf, size_t *bufsize);

typedef int (*dladm_overlay_prop_f)(dladm_handle_t, datalink_id_t,
    dladm_overlay_propinfo_handle_t, void *);
extern dladm_status_t dladm_overlay_walk_prop(dladm_handle_t, datalink_id_t,
    dladm_overlay_prop_f, void *arg, dladm_errlist_t *);

typedef int (*dladm_overlay_cache_f)(dladm_handle_t, datalink_id_t,
    const struct ether_addr *, const dladm_overlay_point_t *, void *);
extern dladm_status_t dladm_overlay_walk_cache(dladm_handle_t, datalink_id_t,
    dladm_overlay_cache_f, void *);

/*
 * Some day we'll want to support being able to set properties after creation.
 * If we do, the following strawman API might serve us well.
 *
 * extern dladm_status_t dladm_overlay_prop_lookup(dladm_handle_t,
 *     datalink_id_t, const char *, dladm_overlay_propinfo_handle_t *);
 * extern void dladm_overlay_prop_handle_free(dladm_handle_t, datalink_id_t,
 *     dladm_overlay_propinfo_handle_t *);
 * extern dladm_status_t dladm_overlay_set_prop(dladm_handle_t, datalink_id_t,
 *     dladm_propinfo_handle_t, void *buf, size_t *bufsize);
 * extern dladm_status_t dladm_overlay_str_to_buf(dladm_handle_t, datalink_id_t,
 *     dladm_overlay_propinfo_handle_t *, const char *, void *, size_t *);
 * extern dladm_status_t dladm_overlay_buf_to_str(dladm_handle_t, datalink_id_t,
 *     dladm_overlay_propinfo_handle_t *, const void *, const size_t, char *,
 *     size_t *);
 */

#ifdef __cplusplus
}
#endif

#endif /* _LIBDLOVERLAY_H */