/*
 * 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 2009 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */
#ifndef _INET_ILB_H
#define _INET_ILB_H

#ifdef __cplusplus
extern "C" {
#endif

/*
 * This file contains the private interface to IP to configure ILB in
 * the system.  Note that this is not a supported interface, and is
 * subject to be changed without notice.  User level apps should instead
 * use the libilb library to interface with ILB.
 */

/* ioctl cmds to IP to configure ILB */
typedef enum {
        ILB_CREATE_RULE,
        ILB_DESTROY_RULE,
        ILB_ENABLE_RULE,
        ILB_DISABLE_RULE,
        ILB_NUM_RULES,
        ILB_NUM_SERVERS,
        ILB_RULE_NAMES,
        ILB_LIST_RULE,
        ILB_LIST_SERVERS,
        ILB_ADD_SERVERS,
        ILB_DEL_SERVERS,
        ILB_ENABLE_SERVERS,
        ILB_DISABLE_SERVERS,
        ILB_LIST_NAT_TABLE,
        ILB_LIST_STICKY_TABLE
} ilb_cmd_t;

/* Supported load balancing algorithm type */
typedef enum {
        ILB_ALG_IMPL_ROUNDROBIN = 1,
        ILB_ALG_IMPL_HASH_IP,
        ILB_ALG_IMPL_HASH_IP_SPORT,
        ILB_ALG_IMPL_HASH_IP_VIP
} ilb_algo_impl_t;

/* Supported load balancing method */
typedef enum {
        ILB_TOPO_IMPL_DSR = 1,
        ILB_TOPO_IMPL_NAT,
        ILB_TOPO_IMPL_HALF_NAT
} ilb_topo_impl_t;

/* Max ILB rule name length */
#define ILB_RULE_NAMESZ 20

/* Max kstat server name length */
#define ILB_SERVER_NAMESZ 20

/* Rule destroy/enable/disable command struct */
typedef struct {
        ilb_cmd_t       cmd;
        char            name[ILB_RULE_NAMESZ];
        uint32_t        flags;
} ilb_name_cmd_t;

/* Flags for rule creation command */
/* these are echoed in lib/libilb/common/libilb.h - please keep in sync */
#define ILB_RULE_ENABLED        0x1
#define ILB_RULE_STICKY         0x2
#define ILB_RULE_ALLRULES       0x4
#define ILB_RULE_BUSY           0x8

/* Rule creation/retrieval command struct */
typedef struct {
        ilb_cmd_t       cmd;
        char            name[ILB_RULE_NAMESZ];
        uint32_t        ip_ver;
        in6_addr_t      vip;
        char            vip_itf[LIFNAMSIZ];
        uint32_t        proto;
        in_port_t       min_port;       /* In network byte order */
        in_port_t       max_port;
        ilb_algo_impl_t algo;
        ilb_topo_impl_t topo;
        char            servers_itf[LIFNAMSIZ];
        in6_addr_t      nat_src_start;
        in6_addr_t      nat_src_end;
        uint32_t        flags;
        in6_addr_t      sticky_mask;
        uint32_t        conn_drain_timeout;     /* Time value is in seconds */
        uint32_t        nat_expiry;
        uint32_t        sticky_expiry;
} ilb_rule_cmd_t;

/* Get number of servers command struct */
typedef struct {
        ilb_cmd_t       cmd;
        char            name[ILB_RULE_NAMESZ];
        uint32_t        num;
} ilb_num_servers_cmd_t;

/* Get number of rules command struct */
typedef struct {
        ilb_cmd_t       cmd;
        uint32_t        num;
} ilb_num_rules_cmd_t;

/* Get all rule names command struct */
typedef struct {
        ilb_cmd_t       cmd;
        uint32_t        num_names;
        /* buf size is (num_names * ILB_RULE_NAMESZ) */
        char            buf[ILB_RULE_NAMESZ];
} ilb_rule_names_cmd_t;

/* Flags for ilb_server_info_t */
#define ILB_SERVER_ENABLED      0x1

/* Struct to represent a backend server for add/list command */
typedef struct {
        char            name[ILB_SERVER_NAMESZ];
        in6_addr_t      addr;
        in_port_t       min_port;       /* In network byte order */
        in_port_t       max_port;
        uint32_t        flags;
        int             err;    /* In return, non zero value indicates error */
} ilb_server_info_t;

/* Add/list servers command struct */
typedef struct {
        ilb_cmd_t               cmd;
        char                    name[ILB_RULE_NAMESZ];
        uint32_t                num_servers;
        ilb_server_info_t       servers[1];
} ilb_servers_info_cmd_t;

/*
 * Struct to represent a backend server for delete/enable/disable
 * command
 */
typedef struct {
        in6_addr_t      addr;
        int             err;    /* In return, non zero value indicates error */
} ilb_server_arg_t;

/* Delete/enable/disable a server command struct */
typedef struct {
        ilb_cmd_t               cmd;
        char                    name[ILB_RULE_NAMESZ];
        uint32_t                num_servers;
        ilb_server_arg_t        servers[1];
} ilb_servers_cmd_t;

/*
 * Flags for listing NAT/persistence table entries
 *
 * ILB_LIST_BEGIN: start from the beginning of the table
 * ILB_LIST_CONT: start from the last reply
 * ILB_LIST_END: on return, this flag indicates the end of the table
 */
#define ILB_LIST_BEGIN  0x1
#define ILB_LIST_CONT   0x2
#define ILB_LIST_END    0x4

#if _LONG_LONG_ALIGNMENT == 8 && _LONG_LONG_ALIGNMENT_32 == 4
#pragma pack(4)
#endif

typedef struct {
        uint32_t        proto;

        in6_addr_t      in_local;
        in6_addr_t      in_global;
        in6_addr_t      out_local;
        in6_addr_t      out_global;

        in_port_t       in_local_port;
        in_port_t       in_global_port;
        in_port_t       out_local_port;
        in_port_t       out_global_port;

        int64_t         create_time;
        int64_t         last_access_time;
        uint64_t        pkt_cnt;
} ilb_nat_entry_t;

/* List NAT table entries command struct */
typedef struct {
        ilb_cmd_t       cmd;
        uint32_t        flags;
        uint32_t        num_nat;
        ilb_nat_entry_t entries[1];
} ilb_list_nat_cmd_t;

typedef struct {
        char            rule_name[ILB_RULE_NAMESZ];
        in6_addr_t      req_addr;
        in6_addr_t      srv_addr;
        int64_t         expiry_time;
} ilb_sticky_entry_t;

/* List sticky table entries command struct */
typedef struct {
        ilb_cmd_t               cmd;
        uint32_t                flags;
        uint32_t                num_sticky;
        ilb_sticky_entry_t      entries[1];
} ilb_list_sticky_cmd_t;

#if _LONG_LONG_ALIGNMENT == 8 && _LONG_LONG_ALIGNMENT_32 == 4
#pragma pack()
#endif

#ifdef __cplusplus
}
#endif

#endif /* _INET_ILB_H */