lib/libgeom/libgeom.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
   3  *
   4  * Copyright (c) 2003 Poul-Henning Kamp
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  * 3. The names of the authors may not be used to endorse or promote
  16  *    products derived from this software without specific prior written
  17  *    permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29  * SUCH DAMAGE.
  30  *
  31  * $FreeBSD$
  32  */
  33 #ifndef _LIBGEOM_H_
  34 #define _LIBGEOM_H_
  35
  36 #include <sys/cdefs.h>
  37
  38 #include <sys/queue.h>
  39 #include <sys/time.h>
  40
  41 #include <geom/geom_ctl.h>
  42
  43 __BEGIN_DECLS
  44
  45 #ifndef DEBUG_LIBGEOM
  46 #define DEBUG_LIBGEOM 0
  47 #endif
  48
  49 void geom_stats_close(void);
  50 void geom_stats_resync(void);
  51 int geom_stats_open(void);
  52 void *geom_stats_snapshot_get(void);
  53 void geom_stats_snapshot_free(void *);
  54 void geom_stats_snapshot_timestamp(void *, struct timespec *);
  55 void geom_stats_snapshot_reset(void *);
  56 struct devstat *geom_stats_snapshot_next(void *);
  57
  58 char *geom_getxml(void);
  59
  60 /* geom_xml2tree.c */
  61
  62 /*
  63  * These structs are used to build the tree based on the XML.
  64  * they're named as the kernel variant without the first '_'.
  65  */
  66
  67 struct gclass;
  68 struct ggeom;
  69 struct gconsumer;
  70 struct gprovider;
  71
  72 LIST_HEAD(gconf, gconfig);
  73
  74 struct gident {
  75         void                    *lg_id;
  76         void                    *lg_ptr;
  77         enum {  ISCLASS,
  78                 ISGEOM,
  79                 ISPROVIDER,
  80                 ISCONSUMER }    lg_what;
  81 };
  82
  83 struct gmesh {
  84         LIST_HEAD(, gclass)     lg_class;
  85         struct gident           *lg_ident;
  86 };
  87
  88 struct gconfig {
  89         LIST_ENTRY(gconfig)     lg_config;
  90         char                    *lg_name;
  91         char                    *lg_val;
  92 };
  93
  94 struct gclass {
  95         void                    *lg_id;
  96         char                    *lg_name;
  97         LIST_ENTRY(gclass)      lg_class;
  98         LIST_HEAD(, ggeom)      lg_geom;
  99         struct gconf            lg_config;
 100 };
 101
 102 struct ggeom {
 103         void                    *lg_id;
 104         struct gclass           *lg_class;
 105         char                    *lg_name;
 106         u_int                   lg_rank;
 107         LIST_ENTRY(ggeom)       lg_geom;
 108         LIST_HEAD(, gconsumer)  lg_consumer;
 109         LIST_HEAD(, gprovider)  lg_provider;
 110         struct gconf            lg_config;
 111 };
 112
 113 struct gconsumer {
 114         void                    *lg_id;
 115         struct ggeom            *lg_geom;
 116         LIST_ENTRY(gconsumer)   lg_consumer;
 117         struct gprovider        *lg_provider;
 118         LIST_ENTRY(gconsumer)   lg_consumers;
 119         char                    *lg_mode;
 120         struct gconf            lg_config;
 121 };
 122
 123 struct gprovider {
 124         void                    *lg_id;
 125         char                    *lg_name;
 126         struct ggeom            *lg_geom;
 127         LIST_ENTRY(gprovider)   lg_provider;
 128         LIST_HEAD(, gconsumer)  lg_consumers;
 129         char                    *lg_mode;
 130         off_t                   lg_mediasize;
 131         u_int                   lg_sectorsize;
 132         off_t                   lg_stripeoffset;
 133         off_t                   lg_stripesize;
 134         struct gconf            lg_config;
 135 };
 136
 137 struct gident * geom_lookupid(struct gmesh *, const void *);
 138 int geom_xml2tree(struct gmesh *, char *);
 139 int geom_gettree(struct gmesh *);
 140 void geom_deletetree(struct gmesh *);
 141
 142 /* geom_ctl.c */
 143
 144 struct gctl_req;
 145
 146 #ifdef _STDIO_H_                        /* limit #include pollution */
 147 void gctl_dump(struct gctl_req *, FILE *);
 148 #endif
 149 void gctl_free(struct gctl_req *);
 150 struct gctl_req *gctl_get_handle(void);
 151 const char *gctl_issue(struct gctl_req *);
 152 void gctl_ro_param(struct gctl_req *, const char *, int, const void *);
 153 void gctl_rw_param(struct gctl_req *, const char *, int, void *);
 154
 155 /* geom_util.c */
 156 int g_open(const char *, int);
 157 int g_close(int);
 158 off_t g_mediasize(int);
 159 ssize_t g_sectorsize(int);
 160 off_t g_stripeoffset(int);
 161 off_t g_stripesize(int);
 162 int g_flush(int);
 163 int g_delete(int, off_t, off_t);
 164 int g_get_ident(int, char *, size_t);
 165 int g_get_name(const char *, char *, size_t);
 166 int g_open_by_ident(const char *, int, char *, size_t);
 167 char *g_device_path(const char *);
 168 char *g_providername(int);
 169
 170 __END_DECLS
 171
 172 #endif /* _LIBGEOM_H_ */