1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 
  22 /*
  23  * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
  24  */
  25 
  26 /*
  27  * Functions to maintain a table of datalink configuration information.
  28  */
  29 
  30 #ifndef _DLMGMT_IMPL_H
  31 #define _DLMGMT_IMPL_H
  32 
  33 #ifdef  __cplusplus
  34 extern "C" {
  35 #endif
  36 
  37 #include <door.h>
  38 #include <libdllink.h>
  39 #include <sys/avl.h>
  40 
  41 /*
  42  * datalink attribute structure
  43  */
  44 typedef struct dlmgmt_linkattr_s {
  45         struct dlmgmt_linkattr_s        *lp_next;
  46         struct dlmgmt_linkattr_s        *lp_prev;
  47         char                            lp_name[MAXLINKATTRLEN];
  48         void                            *lp_val;
  49         dladm_datatype_t                lp_type;
  50         uint_t                          lp_sz;
  51         boolean_t                       lp_linkprop;
  52 } dlmgmt_linkattr_t;
  53 
  54 /*
  55  * datalink structure
  56  */
  57 typedef struct dlmgmt_link_s {
  58         dlmgmt_linkattr_t       *ll_head;
  59         char                    ll_link[MAXLINKNAMELEN];
  60         datalink_class_t        ll_class;
  61         uint32_t                ll_media;
  62         datalink_id_t           ll_linkid;
  63         zoneid_t                ll_zoneid;
  64         boolean_t               ll_onloan;
  65         avl_node_t              ll_name_node;
  66         avl_node_t              ll_id_node;
  67         avl_node_t              ll_loan_node;
  68         uint32_t                ll_flags;
  69         uint32_t                ll_gen;         /* generation number */
  70         boolean_t               ll_tomb;        /* tombstombed */
  71 } dlmgmt_link_t;
  72 
  73 /*
  74  * datalink configuration request structure
  75  */
  76 typedef struct dlmgmt_dlconf_s {
  77         dlmgmt_linkattr_t       *ld_head;
  78         char                    ld_link[MAXLINKNAMELEN];
  79         datalink_id_t           ld_linkid;
  80         datalink_class_t        ld_class;
  81         uint32_t                ld_media;
  82         int                     ld_id;
  83         zoneid_t                ld_zoneid;
  84         uint32_t                ld_gen;
  85         avl_node_t              ld_node;
  86 } dlmgmt_dlconf_t;
  87 
  88 #define ZONE_LOCK       "/etc/dladm/zone.lck"
  89 
  90 extern boolean_t        debug;
  91 extern const char       *progname;
  92 extern char             cachefile[];
  93 extern dladm_handle_t   dld_handle;
  94 extern datalink_id_t    dlmgmt_nextlinkid;
  95 extern avl_tree_t       dlmgmt_name_avl;
  96 extern avl_tree_t       dlmgmt_id_avl;
  97 extern avl_tree_t       dlmgmt_loan_avl;
  98 extern avl_tree_t       dlmgmt_dlconf_avl;
  99 
 100 boolean_t       linkattr_equal(dlmgmt_linkattr_t **, const char *, void *,
 101                     size_t);
 102 dlmgmt_linkattr_t *linkattr_find(dlmgmt_linkattr_t *, const char *);
 103 void            linkattr_unset(dlmgmt_linkattr_t **, const char *);
 104 int             linkattr_set(dlmgmt_linkattr_t **, const char *, void *,
 105                     size_t, dladm_datatype_t);
 106 int             linkattr_get(dlmgmt_linkattr_t **, const char *, void **,
 107                     size_t *, dladm_datatype_t *);
 108 void            linkattr_destroy(dlmgmt_link_t *);
 109 
 110 void            link_destroy(dlmgmt_link_t *);
 111 int             link_activate(dlmgmt_link_t *);
 112 boolean_t       link_is_visible(dlmgmt_link_t *, zoneid_t);
 113 dlmgmt_link_t   *link_by_id(datalink_id_t, zoneid_t);
 114 dlmgmt_link_t   *link_by_name(const char *, zoneid_t);
 115 int             dlmgmt_create_common(const char *, datalink_class_t,
 116                     uint32_t, zoneid_t, uint32_t, dlmgmt_link_t **);
 117 int             dlmgmt_destroy_common(dlmgmt_link_t *, uint32_t);
 118 int             dlmgmt_getattr_common(dlmgmt_linkattr_t **, const char *,
 119                     dlmgmt_getattr_retval_t *);
 120 
 121 void            dlmgmt_advance(dlmgmt_link_t *);
 122 void            dlmgmt_table_lock(boolean_t);
 123 void            dlmgmt_table_unlock();
 124 
 125 int             dlconf_create(const char *, datalink_id_t, datalink_class_t,
 126                     uint32_t, zoneid_t, dlmgmt_dlconf_t **);
 127 void            dlconf_destroy(dlmgmt_dlconf_t *);
 128 void            dlmgmt_advance_dlconfid(dlmgmt_dlconf_t *);
 129 void            dlmgmt_dlconf_table_lock(boolean_t);
 130 void            dlmgmt_dlconf_table_unlock(void);
 131 
 132 int             dlmgmt_generate_name(const char *, char *, size_t, zoneid_t);
 133 
 134 void            dlmgmt_linktable_init(void);
 135 void            dlmgmt_linktable_fini(void);
 136 
 137 int             dlmgmt_zone_init(zoneid_t);
 138 int             dlmgmt_elevate_privileges(void);
 139 int             dlmgmt_drop_privileges();
 140 void            dlmgmt_handler(void *, char *, size_t, door_desc_t *, uint_t);
 141 void            dlmgmt_log(int, const char *, ...);
 142 int             dlmgmt_write_db_entry(const char *, dlmgmt_link_t *, uint32_t);
 143 int             dlmgmt_delete_db_entry(dlmgmt_link_t *, uint32_t);
 144 int             dlmgmt_db_init(zoneid_t, char *);
 145 void            dlmgmt_db_fini(zoneid_t);
 146 
 147 #ifdef  __cplusplus
 148 }
 149 #endif
 150 
 151 #endif  /* _DLMGMT_IMPL_H */