17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 5c0192a57Sericheng * Common Development and Distribution License (the "License"). 6c0192a57Sericheng * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 217c478bd9Sstevel@tonic-gate /* 22d62bc4baSyz147064 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 237c478bd9Sstevel@tonic-gate * Use is subject to license terms. 247c478bd9Sstevel@tonic-gate */ 257c478bd9Sstevel@tonic-gate 267c478bd9Sstevel@tonic-gate #ifndef _SYS_DLS_H 277c478bd9Sstevel@tonic-gate #define _SYS_DLS_H 287c478bd9Sstevel@tonic-gate 297c478bd9Sstevel@tonic-gate #include <sys/types.h> 307c478bd9Sstevel@tonic-gate #include <sys/stream.h> 31d62bc4baSyz147064 #include <net/if.h> 327c478bd9Sstevel@tonic-gate #include <sys/mac.h> 337c478bd9Sstevel@tonic-gate 347c478bd9Sstevel@tonic-gate /* 357c478bd9Sstevel@tonic-gate * Data-Link Services Module 367c478bd9Sstevel@tonic-gate */ 377c478bd9Sstevel@tonic-gate 387c478bd9Sstevel@tonic-gate #ifdef __cplusplus 397c478bd9Sstevel@tonic-gate extern "C" { 407c478bd9Sstevel@tonic-gate #endif 417c478bd9Sstevel@tonic-gate 427c478bd9Sstevel@tonic-gate /* 437c478bd9Sstevel@tonic-gate * Module name. 447c478bd9Sstevel@tonic-gate */ 457c478bd9Sstevel@tonic-gate #define DLS_MODULE_NAME "dls" 467c478bd9Sstevel@tonic-gate 477c478bd9Sstevel@tonic-gate /* 487c478bd9Sstevel@tonic-gate * Data-Link Services Information (text emitted by modinfo(1m)) 497c478bd9Sstevel@tonic-gate */ 50*39b361b2SRichard Bean #define DLS_INFO "Data-Link Services" 517c478bd9Sstevel@tonic-gate 527c478bd9Sstevel@tonic-gate /* 53ba2e4443Sseb * Macros for converting ppas to instance #s, Vlan ID, or minor. 54210db224Sericheng */ 55210db224Sericheng #define DLS_PPA2INST(ppa) ((int)((ppa) % 1000)) 56d62bc4baSyz147064 #define DLS_PPA2VID(ppa) ((ppa) / 1000) 57f4b3ec61Sdh155122 58f4b3ec61Sdh155122 /* 59c0192a57Sericheng * Converts a minor to an instance#; makes sense only when minor <= 1000. 60c0192a57Sericheng */ 61c0192a57Sericheng #define DLS_MINOR2INST(minor) ((int)((minor) - 1)) 62210db224Sericheng 63d62bc4baSyz147064 typedef enum { 64d62bc4baSyz147064 DATALINK_CLASS_PHYS = 0x01, 65d62bc4baSyz147064 DATALINK_CLASS_VLAN = 0x02, 66d62bc4baSyz147064 DATALINK_CLASS_AGGR = 0x04, 67d62bc4baSyz147064 DATALINK_CLASS_VNIC = 0x08 68d62bc4baSyz147064 } datalink_class_t; 69d62bc4baSyz147064 70d62bc4baSyz147064 #define DATALINK_CLASS_ALL (DATALINK_CLASS_PHYS | \ 71d62bc4baSyz147064 DATALINK_CLASS_VLAN | DATALINK_CLASS_AGGR | DATALINK_CLASS_VNIC) 72d62bc4baSyz147064 73d62bc4baSyz147064 /* 74d62bc4baSyz147064 * A combination of flags and media. 75d62bc4baSyz147064 * flags is the higher 32 bits, and if it is 0x01, it indicates all media 76d62bc4baSyz147064 * types can be accepted; otherwise, only the given media type (specified 77d62bc4baSyz147064 * in the lower 32 bits) is accepted. 78d62bc4baSyz147064 */ 79d62bc4baSyz147064 typedef uint64_t datalink_media_t; 80d62bc4baSyz147064 81d62bc4baSyz147064 #define DATALINK_ANY_MEDIATYPE \ 82d62bc4baSyz147064 ((datalink_media_t)(((datalink_media_t)0x01) << 32)) 83d62bc4baSyz147064 84d62bc4baSyz147064 #define DATALINK_MEDIA_ACCEPTED(dmedia, media) \ 85d62bc4baSyz147064 (((uint32_t)(((dmedia) >> 32) & 0xfffffffful) & 0x01) ? \ 86d62bc4baSyz147064 B_TRUE : ((uint32_t)((dmedia) & 0xfffffffful) == (media))) 87d62bc4baSyz147064 88d62bc4baSyz147064 #define MAXLINKATTRLEN 32 89024b0a25Sseb #define MAXLINKATTRVALLEN 1024 90d62bc4baSyz147064 91d62bc4baSyz147064 /* 92d62bc4baSyz147064 * Link attributes used by the kernel. 93d62bc4baSyz147064 */ 94d62bc4baSyz147064 /* 95d62bc4baSyz147064 * The major number and instance number of the underlying physical device 96d62bc4baSyz147064 * are kept as FPHYMAJ and FPHYINST (major, instance + 1). 97d62bc4baSyz147064 * 98d62bc4baSyz147064 * Set for physical links only. 99d62bc4baSyz147064 */ 100d62bc4baSyz147064 #define FPHYMAJ "phymaj" /* uint64_t */ 101d62bc4baSyz147064 #define FPHYINST "phyinst" /* uint64_t */ 102d62bc4baSyz147064 103d62bc4baSyz147064 /* 104d62bc4baSyz147064 * The devname of the physical link. For example, bge0, ce1. Set for physical 105d62bc4baSyz147064 * links only. 106d62bc4baSyz147064 */ 107d62bc4baSyz147064 #define FDEVNAME "devname" /* string */ 108d62bc4baSyz147064 109d62bc4baSyz147064 /* 110b9e076dcSyz147064 * The door file for the dlmgmtd (data-link management) daemon. 111b9e076dcSyz147064 */ 112b9e076dcSyz147064 #define DLMGMT_DOOR "/etc/svc/volatile/dladm/dlmgmt_door" 113b9e076dcSyz147064 114b9e076dcSyz147064 /* 115b9e076dcSyz147064 * Door upcall commands. 116d62bc4baSyz147064 */ 117d62bc4baSyz147064 #define DLMGMT_CMD_DLS_CREATE 1 118d62bc4baSyz147064 #define DLMGMT_CMD_DLS_GETATTR 2 119d62bc4baSyz147064 #define DLMGMT_CMD_DLS_DESTROY 3 120d62bc4baSyz147064 #define DLMGMT_CMD_GETNAME 4 121d62bc4baSyz147064 #define DLMGMT_CMD_GETLINKID 5 122d62bc4baSyz147064 #define DLMGMT_CMD_GETNEXT 6 123d62bc4baSyz147064 #define DLMGMT_CMD_DLS_UPDATE 7 12430890389Sartem #define DLMGMT_CMD_LINKPROP_INIT 8 125d62bc4baSyz147064 #define DLMGMT_CMD_BASE 128 126d62bc4baSyz147064 127d62bc4baSyz147064 /* 128d62bc4baSyz147064 * Indicate the link mapping is active or persistent 129d62bc4baSyz147064 */ 130d62bc4baSyz147064 #define DLMGMT_ACTIVE 0x01 131d62bc4baSyz147064 #define DLMGMT_PERSIST 0x02 132d62bc4baSyz147064 133d62bc4baSyz147064 /* upcall argument */ 134024b0a25Sseb typedef struct dlmgmt_door_arg { 135024b0a25Sseb uint_t ld_cmd; 136024b0a25Sseb } dlmgmt_door_arg_t; 137024b0a25Sseb 138d62bc4baSyz147064 typedef struct dlmgmt_upcall_arg_create { 139d62bc4baSyz147064 int ld_cmd; 140d62bc4baSyz147064 datalink_class_t ld_class; 141d62bc4baSyz147064 uint32_t ld_media; 142d62bc4baSyz147064 boolean_t ld_persist; 143d62bc4baSyz147064 uint64_t ld_phymaj; 144d62bc4baSyz147064 uint64_t ld_phyinst; 145d62bc4baSyz147064 char ld_devname[MAXNAMELEN]; 146d62bc4baSyz147064 } dlmgmt_upcall_arg_create_t; 147d62bc4baSyz147064 148024b0a25Sseb /* 149024b0a25Sseb * Note: ld_padding is necessary to keep the size of the structure the 150024b0a25Sseb * same on amd64 and i386. The same note applies to other ld_padding 151024b0a25Sseb * and lr_paddding fields in structures throughout this file. 152024b0a25Sseb */ 153d62bc4baSyz147064 typedef struct dlmgmt_upcall_arg_destroy { 154d62bc4baSyz147064 int ld_cmd; 155d62bc4baSyz147064 datalink_id_t ld_linkid; 156d62bc4baSyz147064 boolean_t ld_persist; 157024b0a25Sseb int ld_padding; 158d62bc4baSyz147064 } dlmgmt_upcall_arg_destroy_t; 159d62bc4baSyz147064 160d62bc4baSyz147064 typedef struct dlmgmt_upcall_arg_update { 161d62bc4baSyz147064 int ld_cmd; 162d62bc4baSyz147064 boolean_t ld_novanity; 163d62bc4baSyz147064 uint32_t ld_media; 164024b0a25Sseb uint32_t ld_padding; 165d62bc4baSyz147064 char ld_devname[MAXNAMELEN]; 166d62bc4baSyz147064 } dlmgmt_upcall_arg_update_t; 167d62bc4baSyz147064 168d62bc4baSyz147064 typedef struct dlmgmt_upcall_arg_getattr { 169d62bc4baSyz147064 int ld_cmd; 170d62bc4baSyz147064 datalink_id_t ld_linkid; 171d62bc4baSyz147064 char ld_attr[MAXLINKATTRLEN]; 172d62bc4baSyz147064 } dlmgmt_upcall_arg_getattr_t; 173d62bc4baSyz147064 174d62bc4baSyz147064 typedef struct dlmgmt_door_getname { 175d62bc4baSyz147064 int ld_cmd; 176d62bc4baSyz147064 datalink_id_t ld_linkid; 177d62bc4baSyz147064 } dlmgmt_door_getname_t; 178d62bc4baSyz147064 179d62bc4baSyz147064 typedef struct dlmgmt_door_getlinkid { 180d62bc4baSyz147064 int ld_cmd; 181d62bc4baSyz147064 char ld_link[MAXLINKNAMELEN]; 182d62bc4baSyz147064 } dlmgmt_door_getlinkid_t; 183d62bc4baSyz147064 184d62bc4baSyz147064 typedef struct dlmgmt_door_getnext_s { 185d62bc4baSyz147064 int ld_cmd; 186d62bc4baSyz147064 datalink_id_t ld_linkid; 187d62bc4baSyz147064 datalink_class_t ld_class; 188d62bc4baSyz147064 uint32_t ld_flags; 189d62bc4baSyz147064 datalink_media_t ld_dmedia; 190d62bc4baSyz147064 } dlmgmt_door_getnext_t; 191d62bc4baSyz147064 19230890389Sartem typedef struct dlmgmt_door_linkprop_init { 19330890389Sartem int ld_cmd; 19430890389Sartem datalink_id_t ld_linkid; 19530890389Sartem } dlmgmt_door_linkprop_init_t; 19630890389Sartem 197d62bc4baSyz147064 /* upcall return value */ 198024b0a25Sseb typedef struct dlmgmt_retval_s { 199024b0a25Sseb uint_t lr_err; /* return error code */ 200024b0a25Sseb } dlmgmt_retval_t; 201024b0a25Sseb 20230890389Sartem typedef dlmgmt_retval_t dlmgmt_destroy_retval_t, 20330890389Sartem dlmgmt_linkprop_init_retval_t; 204024b0a25Sseb 205d62bc4baSyz147064 struct dlmgmt_linkid_retval_s { 206d62bc4baSyz147064 uint_t lr_err; 207d62bc4baSyz147064 datalink_id_t lr_linkid; 208d62bc4baSyz147064 uint32_t lr_flags; 209d62bc4baSyz147064 datalink_class_t lr_class; 210d62bc4baSyz147064 uint32_t lr_media; 211024b0a25Sseb uint32_t lr_padding; 212d62bc4baSyz147064 }; 213d62bc4baSyz147064 214d62bc4baSyz147064 typedef struct dlmgmt_linkid_retval_s dlmgmt_create_retval_t, 215d62bc4baSyz147064 dlmgmt_update_retval_t, 216d62bc4baSyz147064 dlmgmt_getlinkid_retval_t, 217d62bc4baSyz147064 dlmgmt_getnext_retval_t; 218d62bc4baSyz147064 219d62bc4baSyz147064 typedef struct dlmgmt_getname_retval_s { 220d62bc4baSyz147064 uint_t lr_err; 221d62bc4baSyz147064 char lr_link[MAXLINKNAMELEN]; 222d62bc4baSyz147064 datalink_class_t lr_class; 223d62bc4baSyz147064 uint32_t lr_media; 224d62bc4baSyz147064 uint32_t lr_flags; 225d62bc4baSyz147064 } dlmgmt_getname_retval_t; 226d62bc4baSyz147064 227d62bc4baSyz147064 typedef struct dlmgmt_getattr_retval_s { 228d62bc4baSyz147064 uint_t lr_err; 229d62bc4baSyz147064 uint_t lr_type; 230024b0a25Sseb uint_t lr_attrsz; 231024b0a25Sseb uint_t lr_padding; 232024b0a25Sseb char lr_attrval[MAXLINKATTRVALLEN]; 233d62bc4baSyz147064 } dlmgmt_getattr_retval_t; 234d62bc4baSyz147064 2357c478bd9Sstevel@tonic-gate #ifdef _KERNEL 2367c478bd9Sstevel@tonic-gate 237d62bc4baSyz147064 #define DLS_MAX_PPA 999 238d62bc4baSyz147064 #define DLS_MAX_MINOR (DLS_MAX_PPA + 1) 2397c478bd9Sstevel@tonic-gate 2407c478bd9Sstevel@tonic-gate typedef struct dls_t *dls_channel_t; 2417c478bd9Sstevel@tonic-gate 242d62bc4baSyz147064 extern int dls_open_style2_vlan(major_t, uint_t, dls_channel_t *); 243d62bc4baSyz147064 extern int dls_open_by_dev(dev_t, dls_channel_t *); 2447c478bd9Sstevel@tonic-gate extern void dls_close(dls_channel_t); 2457c478bd9Sstevel@tonic-gate 2467c478bd9Sstevel@tonic-gate extern mac_handle_t dls_mac(dls_channel_t); 2477c478bd9Sstevel@tonic-gate extern uint16_t dls_vid(dls_channel_t); 2487c478bd9Sstevel@tonic-gate 2497c478bd9Sstevel@tonic-gate #define DLS_SAP_LLC 0 2507c478bd9Sstevel@tonic-gate #define DLS_SAP_PROMISC (1 << 16) 2517c478bd9Sstevel@tonic-gate 252ba2e4443Sseb extern int dls_bind(dls_channel_t, uint32_t); 2537c478bd9Sstevel@tonic-gate extern void dls_unbind(dls_channel_t); 2547c478bd9Sstevel@tonic-gate 2557c478bd9Sstevel@tonic-gate #define DLS_PROMISC_SAP 0x00000001 2567c478bd9Sstevel@tonic-gate #define DLS_PROMISC_MULTI 0x00000002 2577c478bd9Sstevel@tonic-gate #define DLS_PROMISC_PHYS 0x00000004 2587c478bd9Sstevel@tonic-gate 2597c478bd9Sstevel@tonic-gate extern int dls_promisc(dls_channel_t, uint32_t); 2607c478bd9Sstevel@tonic-gate 2617c478bd9Sstevel@tonic-gate extern int dls_multicst_add(dls_channel_t, const uint8_t *); 2627c478bd9Sstevel@tonic-gate extern int dls_multicst_remove(dls_channel_t, const uint8_t *); 2637c478bd9Sstevel@tonic-gate 264d62bc4baSyz147064 extern mblk_t *dls_header(dls_channel_t, const uint8_t *, 265d62bc4baSyz147064 uint16_t, uint_t, mblk_t **); 266d62bc4baSyz147064 extern int dls_header_info(dls_channel_t, mblk_t *, 267d62bc4baSyz147064 mac_header_info_t *); 2687c478bd9Sstevel@tonic-gate 269605445d5Sdg199075 typedef void (*dls_rx_t)(void *, mac_resource_handle_t, mblk_t *, 270605445d5Sdg199075 mac_header_info_t *); 2717c478bd9Sstevel@tonic-gate 2727c478bd9Sstevel@tonic-gate extern void dls_rx_set(dls_channel_t, dls_rx_t, void *); 2737c478bd9Sstevel@tonic-gate 2747c478bd9Sstevel@tonic-gate extern mblk_t *dls_tx(dls_channel_t, mblk_t *); 2757c478bd9Sstevel@tonic-gate 2767c478bd9Sstevel@tonic-gate extern boolean_t dls_active_set(dls_channel_t); 2777c478bd9Sstevel@tonic-gate extern void dls_active_clear(dls_channel_t); 2787c478bd9Sstevel@tonic-gate 279f4b3ec61Sdh155122 extern dev_info_t *dls_finddevinfo(dev_t); 280d62bc4baSyz147064 281d62bc4baSyz147064 typedef struct dls_devnet_s *dls_dl_handle_t; 282d62bc4baSyz147064 typedef struct dls_dev_t *dls_dev_handle_t; 283d62bc4baSyz147064 284d62bc4baSyz147064 extern int dls_devnet_open(const char *, 285d62bc4baSyz147064 dls_dl_handle_t *, dev_t *); 286d62bc4baSyz147064 extern void dls_devnet_close(dls_dl_handle_t); 287d62bc4baSyz147064 extern boolean_t dls_devnet_rebuild(); 288d62bc4baSyz147064 289d62bc4baSyz147064 extern int dls_devnet_rename(datalink_id_t, datalink_id_t, 290d62bc4baSyz147064 const char *); 291d62bc4baSyz147064 extern int dls_devnet_create(mac_handle_t, datalink_id_t); 292d62bc4baSyz147064 extern int dls_devnet_destroy(mac_handle_t, datalink_id_t *); 293d62bc4baSyz147064 extern int dls_devnet_recreate(mac_handle_t, datalink_id_t); 294d62bc4baSyz147064 extern int dls_devnet_create_vlan(datalink_id_t, 295d62bc4baSyz147064 datalink_id_t, uint16_t, boolean_t); 296d62bc4baSyz147064 extern int dls_devnet_destroy_vlan(datalink_id_t); 297d62bc4baSyz147064 extern int dls_devnet_hold_tmp(datalink_id_t, dls_dl_handle_t *); 298d62bc4baSyz147064 extern void dls_devnet_rele_tmp(dls_dl_handle_t); 29930890389Sartem extern void dls_devnet_prop_task_wait(dls_dl_handle_t); 300d62bc4baSyz147064 301d62bc4baSyz147064 extern const char *dls_devnet_mac(dls_dl_handle_t); 302d62bc4baSyz147064 extern uint16_t dls_devnet_vid(dls_dl_handle_t); 303d62bc4baSyz147064 extern datalink_id_t dls_devnet_linkid(dls_dl_handle_t); 304d62bc4baSyz147064 extern boolean_t dls_devnet_is_explicit(dls_dl_handle_t); 305d62bc4baSyz147064 extern int dls_devnet_dev2linkid(dev_t, datalink_id_t *); 306d62bc4baSyz147064 extern int dls_devnet_phydev(datalink_id_t, dev_t *); 307d62bc4baSyz147064 extern int dls_devnet_setzid(const char *, zoneid_t); 308d62bc4baSyz147064 extern int dls_devnet_getzid(datalink_id_t, zoneid_t *); 309d62bc4baSyz147064 310d62bc4baSyz147064 extern int dls_mgmt_door_set(boolean_t); 311d62bc4baSyz147064 extern int dls_mgmt_create(const char *, dev_t, datalink_class_t, 312d62bc4baSyz147064 uint32_t, boolean_t, datalink_id_t *); 313d62bc4baSyz147064 extern int dls_mgmt_destroy(datalink_id_t, boolean_t); 314d62bc4baSyz147064 extern int dls_mgmt_update(const char *, uint32_t, boolean_t, 315d62bc4baSyz147064 uint32_t *, datalink_id_t *); 316d62bc4baSyz147064 extern int dls_mgmt_get_linkinfo(datalink_id_t, char *, 317d62bc4baSyz147064 datalink_class_t *, uint32_t *, uint32_t *); 318d62bc4baSyz147064 extern int dls_mgmt_get_linkid(const char *, datalink_id_t *); 319d62bc4baSyz147064 extern datalink_id_t dls_mgmt_get_next(datalink_id_t, datalink_class_t, 320d62bc4baSyz147064 datalink_media_t, uint32_t); 321d62bc4baSyz147064 3227c478bd9Sstevel@tonic-gate #endif /* _KERNEL */ 3237c478bd9Sstevel@tonic-gate 3247c478bd9Sstevel@tonic-gate #ifdef __cplusplus 3257c478bd9Sstevel@tonic-gate } 3267c478bd9Sstevel@tonic-gate #endif 3277c478bd9Sstevel@tonic-gate 3287c478bd9Sstevel@tonic-gate #endif /* _SYS_DLS_H */ 329