common/sys/dld.h

	dld.h revision da14cebe459d3275048785f25bd869cb09b5307f
/*
 * 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 2008 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#ifndef _SYS_DLD_H
#define _SYS_DLD_H

/*
 * Data-Link Driver (public header).
 *
 * Note that the datastructures defined here define an ioctl interface
 * that is shared betwen user and kernel space.  The dld driver thus
 * assumes that the structures have identical layout and size when
 * compiled in either IPL32 or LP64.
 */

#include <sys/types.h>
#include <sys/stream.h>
#include <sys/dld_ioc.h>
#include <sys/mac_flow.h>
#include <sys/conf.h>
#include <sys/sad.h>
#include <net/if.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>
#include <sys/mac.h>

#ifdef  __cplusplus
extern "C" {
#endif

/*
 * Data-Link Driver Information (text emitted by modinfo(1m))
 */
#define DLD_INFO    "Data-Link Driver"

/*
 * Options: To enable an option set the property name to a non-zero value
 *      in kernel/drv/dld.conf.
 */

/*
 * Prevent use of the IP fast-path (direct M_DATA transmit).
 */
#define DLD_PROP_NO_FASTPATH    "no-fastpath"

/*
 * Prevent advertising of the DL_CAPAB_POLL capability.
 */
#define DLD_PROP_NO_POLL    "no-poll"

/*
 * Prevent advertising of the DL_CAPAB_ZEROCOPY capability.
 */
#define DLD_PROP_NO_ZEROCOPY    "no-zerocopy"

/*
 * Prevent advertising of the DL_CAPAB_SOFTRING capability.
 */
#define DLD_PROP_NO_SOFTRING    "no-softring"

/*
 * The name of the driver.
 */
#define DLD_DRIVER_NAME     "dld"

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

/*
 * IOCTL codes and data structures.
 */
#define DLDIOC_ATTR DLDIOC(0x03)

typedef struct dld_ioc_attr {
    datalink_id_t       dia_linkid;
    uint_t          dia_max_sdu;
} dld_ioc_attr_t;

#define DLDIOC_VLAN_ATTR    DLDIOC(0x04)
typedef struct dld_ioc_vlan_attr {
    datalink_id_t   div_vlanid;
    uint16_t    div_vid;
    datalink_id_t   div_linkid;
    boolean_t   div_force;
} dld_ioc_vlan_attr_t;

#define DLDIOC_PHYS_ATTR    DLDIOC(0x05)
#define DLPI_LINKNAME_MAX   32

typedef struct dld_ioc_phys_attr {
    datalink_id_t   dip_linkid;
    /*
     * Whether this physical link supports vanity naming. Note that
     * physical links whose media type is not supported by GLDv3
     * can not support vanity naming.
     */
    boolean_t   dip_novanity;
    char        dip_dev[MAXLINKNAMELEN];
} dld_ioc_phys_attr_t;

/*
 * Secure objects ioctls
 */
typedef enum {
    DLD_SECOBJ_CLASS_WEP = 1,
    DLD_SECOBJ_CLASS_WPA
} dld_secobj_class_t;

#define DLD_SECOBJ_OPT_CREATE   0x00000001
#define DLD_SECOBJ_NAME_MAX 32
#define DLD_SECOBJ_VAL_MAX  256
typedef struct dld_secobj {
    char            so_name[DLD_SECOBJ_NAME_MAX];
    dld_secobj_class_t  so_class;
    uint8_t         so_val[DLD_SECOBJ_VAL_MAX];
    uint_t          so_len;
} dld_secobj_t;

#define DLDIOC_SECOBJ_SET   DLDIOC(0x06)
typedef struct dld_ioc_secobj_set {
    dld_secobj_t        ss_obj;
    uint_t          ss_flags;
} dld_ioc_secobj_set_t;

#define DLDIOC_SECOBJ_GET   DLDIOC(0x07)
typedef struct dld_ioc_secobj_get {
    dld_secobj_t        sg_obj;
    uint_t          sg_count;
    uint_t          sg_size;
} dld_ioc_secobj_get_t;

/*
 * The following two slots were used outside of ON, so don't reuse them.
 *
 * #define DLDIOCHOLDVLAN DLDIOC(0x08)
 * #define DLDIOCRELEVLAN DLDIOC(0x09)
 */

#define DLDIOC_SECOBJ_UNSET DLDIOC(0x0a)
typedef struct dld_ioc_secobj_unset {
    char            su_name[DLD_SECOBJ_NAME_MAX];
} dld_ioc_secobj_unset_t;

#define DLDIOC_CREATE_VLAN  DLDIOC(0x0b)
typedef struct dld_ioc_create_vlan {
    datalink_id_t   dic_vlanid;
    datalink_id_t   dic_linkid;
    uint16_t    dic_vid;
    boolean_t   dic_force;
} dld_ioc_create_vlan_t;

#define DLDIOC_DELETE_VLAN  DLDIOC(0x0c)
typedef struct dld_ioc_delete_vlan {
    datalink_id_t   did_linkid;
} dld_ioc_delete_vlan_t;

/*
 * The following constants have been removed, and the slots are open:
 *
 * #define DLDIOC_SETAUTOPUSH   DLDIOC(0x0d)
 * #define DLDIOC_GETAUTOPUSH   DLDIOC(0x0e)
 * #define DLDIOC_CLRAUTOPUSH   DLDIOC(0x0f)
 */

#define DLDIOC_DOORSERVER   DLDIOC(0x10)
typedef struct dld_ioc_door {
    boolean_t   did_start_door;
} dld_ioc_door_t;

#define DLDIOC_RENAME       DLDIOC(0x11)
typedef struct dld_ioc_rename {
    datalink_id_t   dir_linkid1;
    datalink_id_t   dir_linkid2;
    char        dir_link[MAXLINKNAMELEN];
} dld_ioc_rename_t;

/*
 * The following constants have been removed, and the slots are open:
 *
 * #define DLDIOC_SETZID    DLDIOC(0x12)
 * #define DLDIOC_GETZID    DLDIOC(0x13)
 */

typedef struct dld_ioc_zid {
    zoneid_t    diz_zid;
    char        diz_link[MAXLINKNAMELEN];
} dld_ioc_zid_t;

/*
 * data-link autopush configuration.
 */
struct dlautopush {
    uint_t  dap_anchor;
    uint_t  dap_npush;
    char    dap_aplist[MAXAPUSH][FMNAMESZ+1];
};

#define DLDIOC_MACADDRGET   DLDIOC(0x15)
typedef struct dld_ioc_macaddrget {
    datalink_id_t   dig_linkid;
    uint_t      dig_count;
    uint_t      dig_size;
} dld_ioc_macaddrget_t;

/* possible flags for dmi_flags below */
#define DLDIOCMACADDR_USED  0x1 /* address slot used */

typedef struct dld_macaddrinfo {
    uint_t      dmi_slot;
    uint_t      dmi_flags;
    uint_t      dmi_addrlen;
    uchar_t     dmi_addr[MAXMACADDRLEN];
    char        dmi_client_name[MAXNAMELEN];
    datalink_id_t   dma_client_linkid;
} dld_macaddrinfo_t;

/*
 * IOCTL codes and data structures for flowadm.
 */
#define DLDIOC_ADDFLOW      DLDIOC(0x16)
typedef struct dld_ioc_addflow {
    datalink_id_t       af_linkid;
    flow_desc_t     af_flow_desc;
    mac_resource_props_t    af_resource_props;
    char            af_name[MAXNAMELEN];
} dld_ioc_addflow_t;

#define DLDIOC_REMOVEFLOW   DLDIOC(0x17)
typedef struct dld_ioc_removeflow {
    char            rf_name[MAXNAMELEN];
} dld_ioc_removeflow_t;

#define DLDIOC_MODIFYFLOW   DLDIOC(0x18)
typedef struct dld_ioc_modifyflow {
    char            mf_name[MAXNAMELEN];
    mac_resource_props_t    mf_resource_props;
} dld_ioc_modifyflow_t;

#define DLDIOC_WALKFLOW     DLDIOC(0x19)
typedef struct dld_ioc_walkflow {
    datalink_id_t       wf_linkid;
    char            wf_name[MAXNAMELEN];
    uint32_t        wf_nflows;
    uint_t          wf_len;
} dld_ioc_walkflow_t;

typedef struct dld_flowinfo {
    datalink_id_t       fi_linkid;
    flow_desc_t     fi_flow_desc;
    mac_resource_props_t    fi_resource_props;
    char            fi_flowname[MAXNAMELEN];
    uint32_t        fi_pad;
} dld_flowinfo_t;

#define DLDIOC_USAGELOG     DLDIOC(0x1a)
typedef struct dld_ioc_usagelog {
    mac_logtype_t   ul_type;
    boolean_t   ul_onoff;
    uint_t      ul_interval;
} dld_ioc_usagelog_t;

#define DLDIOC_SETMACPROP   DLDIOC(0x1b)
#define DLDIOC_GETMACPROP   DLDIOC(0x1c)
#define MAC_PROP_VERSION    1

typedef struct dld_ioc_macprop_s {
    int     pr_version;
    uint_t      pr_flags;
    datalink_id_t   pr_linkid;
    mac_prop_id_t   pr_num;
    uint_t      pr_perm_flags;
    char        pr_name[MAXLINKPROPNAME];
    uint_t      pr_valsize;     /* sizeof pr_val */
    char        pr_val[1];
} dld_ioc_macprop_t;

#define DLDIOC_GETHWGRP     DLDIOC(0x1d)

typedef struct dld_ioc_hwgrpget {
    datalink_id_t   dih_linkid;
    uint_t      dih_n_groups;   /* number of groups included in ioc */
    uint_t      dih_size;
} dld_ioc_hwgrpget_t;

#define MAXCLIENTNAMELEN    1024
typedef struct dld_hwgrpinfo {
    char    dhi_link_name[MAXLINKNAMELEN];
    uint_t  dhi_grp_num;
    uint_t  dhi_grp_type;
    uint_t  dhi_n_rings;
    uint_t  dhi_n_clnts;
    /* XXXX later we should use dhi_n_clnts * MAXNAMELEN for dhi_clnts */
    char    dhi_clnts[MAXCLIENTNAMELEN];
} dld_hwgrpinfo_t;

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

#ifdef _KERNEL

#define DLD_CAPAB_DIRECT    0x00000001
#define DLD_CAPAB_POLL      0x00000002
#define DLD_CAPAB_PERIM     0x00000003
#define DLD_CAPAB_LSO       0x00000004

#define DLD_ENABLE      0x00000001
#define DLD_DISABLE     0x00000002
#define DLD_QUERY       0x00000003

/*
 * GLDv3 entry point for negotiating capabilities.
 * This is exposed to IP after negotiation of DL_CAPAB_DLD.
 *
 * This function takes the following arguments:
 * handle: used for identifying the interface to operate on (provided by dld).
 * type: capability type.
 * arg: points to a capability-specific structure.
 * flags: used for indicating whether to enable or disable a capability.
 *
 * With this function, capability negotiation is reduced from a multi-step
 * process to just one single function call.
 * e.g. the following code would pass 'x' from IP to dld and obtain
 * arg.output_arg from dld:
 *
 * arg.input_arg = x;
 * rc = (*dld_capab)(handle, DLD_CAPAB_XXX, &arg, DLD_ENABLE);
 * ill->info1 = arg.output_arg;
 */
typedef int (*dld_capab_func_t)(void *, uint_t, void *, uint_t);

/*
 * Direct Tx/Rx capability.
 */
typedef struct dld_capab_direct_s {
    /*
     * Rx entry point and handle, owned by IP.
     */
    uintptr_t   di_rx_cf;
    void        *di_rx_ch;

    /*
     * Tx entry points and handle, owned by DLD.
     */
    /* Entry point for transmitting packets */
    uintptr_t   di_tx_df;
    void        *di_tx_dh;

    /* flow control notification callback */
    uintptr_t   di_tx_cb_df; /* callback registration/de-registration */
    void        *di_tx_cb_dh;
} dld_capab_direct_t;

/*
 * Polling/softring capability.
 */
#define POLL_SOFTRING       0x00000001
typedef struct dld_capab_poll_s {
    uintptr_t   poll_ring_add_cf;
    uintptr_t   poll_ring_remove_cf;
    uintptr_t   poll_ring_quiesce_cf;
    uintptr_t   poll_ring_restart_cf;
    uintptr_t   poll_ring_bind_cf;
    void        *poll_ring_ch;
    uintptr_t   poll_mac_accept_df;
    void        *poll_mac_dh;
} dld_capab_poll_t;

/*
 * LSO capability
 */
/*
 * Currently supported flags for LSO.
 */
#define DLD_LSO_TX_BASIC_TCP_IPV4   0x01    /* TCP LSO capability */

typedef struct dld_capab_lso_s {
    uint_t  lso_flags;  /* capability flags */
    uint_t  lso_max;    /* maximum payload */
} dld_capab_lso_t;

int dld_getinfo(dev_info_t *, ddi_info_cmd_t, void *, void **);
int dld_open(queue_t *, dev_t *, int, int, cred_t *);
int dld_close(queue_t *);
void    dld_wput(queue_t *, mblk_t *);
void    dld_wsrv(queue_t *);
void    dld_init_ops(struct dev_ops *, const char *);
void    dld_fini_ops(struct dev_ops *);
int dld_autopush(dev_t *, struct dlautopush *);

int dld_add_flow(datalink_id_t, char *, flow_desc_t *,
    mac_resource_props_t *);
int dld_remove_flow(char *);
int dld_modify_flow(char *, mac_resource_props_t *);
int dld_walk_flow(dld_ioc_walkflow_t *, intptr_t);

#endif

#ifdef  __cplusplus
}
#endif

#endif  /* _SYS_DLD_H */