xref: /freebsd/sys/geom/vinum/geom_vinum.h (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2004, 2007 Lukas Ertl
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  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #ifndef	_GEOM_VINUM_H_
30 #define	_GEOM_VINUM_H_
31 
32 /* geom_vinum_create.c */
33 void	gv_concat(struct g_geom *gp, struct gctl_req *);
34 void	gv_mirror(struct g_geom *gp, struct gctl_req *);
35 void	gv_stripe(struct g_geom *gp, struct gctl_req *);
36 void	gv_raid5(struct g_geom *gp, struct gctl_req *);
37 int	gv_create_drive(struct gv_softc *, struct gv_drive *);
38 int	gv_create_volume(struct gv_softc *, struct gv_volume *);
39 int	gv_create_plex(struct gv_softc *, struct gv_plex *);
40 int	gv_create_sd(struct gv_softc *, struct gv_sd *);
41 
42 /* geom_vinum_drive.c */
43 void	gv_save_config(struct gv_softc *);
44 int	gv_read_header(struct g_consumer *, struct gv_hdr *);
45 int	gv_write_header(struct g_consumer *, struct gv_hdr *);
46 
47 /* geom_vinum_init.c */
48 void	gv_start_obj(struct g_geom *, struct gctl_req *);
49 int	gv_start_plex(struct gv_plex *);
50 int	gv_start_vol(struct gv_volume *);
51 
52 /* geom_vinum_list.c */
53 void	gv_ld(struct g_geom *, struct gctl_req *, struct sbuf *);
54 void	gv_lp(struct g_geom *, struct gctl_req *, struct sbuf *);
55 void	gv_ls(struct g_geom *, struct gctl_req *, struct sbuf *);
56 void	gv_lv(struct g_geom *, struct gctl_req *, struct sbuf *);
57 void	gv_list(struct g_geom *, struct gctl_req *);
58 
59 /* geom_vinum_move.c */
60 void	gv_move(struct g_geom *, struct gctl_req *);
61 int	gv_move_sd(struct gv_softc *, struct gv_sd *, struct gv_drive *, int);
62 
63 /* geom_vinum_rename.c */
64 void	gv_rename(struct g_geom *, struct gctl_req *);
65 int	gv_rename_drive(struct gv_softc *, struct gv_drive *, char *, int);
66 int	gv_rename_plex(struct gv_softc *, struct gv_plex *, char *, int);
67 int	gv_rename_sd(struct gv_softc *, struct gv_sd *, char *, int);
68 int	gv_rename_vol(struct gv_softc *, struct gv_volume *, char *, int);
69 
70 /* geom_vinum_rm.c */
71 void	gv_remove(struct g_geom *, struct gctl_req *);
72 int	gv_resetconfig(struct gv_softc *);
73 void	gv_rm_sd(struct gv_softc *sc, struct gv_sd *s);
74 void	gv_rm_drive(struct gv_softc *, struct gv_drive *, int);
75 void	gv_rm_plex(struct gv_softc *, struct gv_plex *);
76 void	gv_rm_vol(struct gv_softc *, struct gv_volume *);
77 
78 /* geom_vinum_state.c */
79 int	gv_sdstatemap(struct gv_plex *);
80 void	gv_setstate(struct g_geom *, struct gctl_req *);
81 int	gv_set_drive_state(struct gv_drive *, int, int);
82 int	gv_set_sd_state(struct gv_sd *, int, int);
83 int	gv_set_vol_state(struct gv_volume *, int, int);
84 int	gv_set_plex_state(struct gv_plex *, int, int);
85 void	gv_update_sd_state(struct gv_sd *);
86 void	gv_update_plex_state(struct gv_plex *);
87 void	gv_update_vol_state(struct gv_volume *);
88 
89 /* geom_vinum_subr.c */
90 void		 	 gv_adjust_freespace(struct gv_sd *, off_t);
91 void		 	 gv_free_sd(struct gv_sd *);
92 struct gv_drive		*gv_find_drive(struct gv_softc *, char *);
93 struct gv_drive		*gv_find_drive_device(struct gv_softc *, char *);
94 struct gv_plex		*gv_find_plex(struct gv_softc *, char *);
95 struct gv_sd		*gv_find_sd(struct gv_softc *, char *);
96 struct gv_volume	*gv_find_vol(struct gv_softc *, char *);
97 void			 gv_format_config(struct gv_softc *, struct sbuf *, int,
98 			     char *);
99 int			 gv_is_striped(struct gv_plex *);
100 int			 gv_consumer_is_open(struct g_consumer *);
101 int			 gv_provider_is_open(struct g_provider *);
102 int			 gv_object_type(struct gv_softc *, char *);
103 void			 gv_parse_config(struct gv_softc *, char *,
104 			     struct gv_drive *);
105 int			 gv_sd_to_drive(struct gv_sd *, struct gv_drive *);
106 int			 gv_sd_to_plex(struct gv_sd *, struct gv_plex *);
107 int			 gv_sdcount(struct gv_plex *, int);
108 void			 gv_update_plex_config(struct gv_plex *);
109 void			 gv_update_vol_size(struct gv_volume *, off_t);
110 off_t			 gv_vol_size(struct gv_volume *);
111 off_t			 gv_plex_size(struct gv_plex *);
112 int			 gv_plexdown(struct gv_volume *);
113 int			 gv_attach_plex(struct gv_plex *, struct gv_volume *,
114 			     int);
115 int			 gv_attach_sd(struct gv_sd *, struct gv_plex *, off_t,
116 			     int);
117 int			 gv_detach_plex(struct gv_plex *, int);
118 int			 gv_detach_sd(struct gv_sd *, int);
119 
120 /* geom_vinum.c */
121 void	gv_worker(void *);
122 void	gv_post_event(struct gv_softc *, int, void *, void *, intmax_t,
123 	    intmax_t);
124 void	gv_worker_exit(struct gv_softc *);
125 struct gv_event *gv_get_event(struct gv_softc *);
126 void	gv_remove_event(struct gv_softc *, struct gv_event *);
127 void	gv_drive_done(struct gv_drive *);
128 void	gv_drive_tasted(struct gv_softc *, struct g_provider *);
129 void	gv_drive_lost(struct gv_softc *, struct gv_drive *);
130 void	gv_setup_objects(struct gv_softc *);
131 void	gv_start(struct bio *);
132 int	gv_access(struct g_provider *, int, int, int);
133 void	gv_cleanup(struct gv_softc *);
134 
135 /* geom_vinum_volume.c */
136 void	gv_done(struct bio *);
137 void	gv_volume_start(struct gv_softc *, struct bio *);
138 void	gv_volume_flush(struct gv_volume *);
139 void	gv_bio_done(struct gv_softc *, struct bio *);
140 
141 /* geom_vinum_plex.c */
142 void	gv_plex_start(struct gv_plex *, struct bio *);
143 void	gv_plex_raid5_done(struct gv_plex *, struct bio *);
144 void	gv_plex_normal_done(struct gv_plex *, struct bio *);
145 int	gv_grow_request(struct gv_plex *, off_t, off_t, int, caddr_t);
146 void	gv_grow_complete(struct gv_plex *, struct bio *);
147 void	gv_init_request(struct gv_sd *, off_t, caddr_t, off_t);
148 void	gv_init_complete(struct gv_plex *, struct bio *);
149 void	gv_parity_request(struct gv_plex *, int, off_t);
150 void	gv_parity_complete(struct gv_plex *, struct bio *);
151 void	gv_rebuild_complete(struct gv_plex *, struct bio *);
152 int	gv_sync_request(struct gv_plex *, struct gv_plex *, off_t, off_t, int,
153 	    caddr_t);
154 int	gv_sync_complete(struct gv_plex *, struct bio *);
155 
156 extern	u_int	g_vinum_debug;
157 
158 #define	G_VINUM_DEBUG(lvl, ...) \
159     _GEOM_DEBUG("GEOM_VINUM", g_vinum_debug, (lvl), NULL, __VA_ARGS__)
160 #define	G_VINUM_LOGREQ(lvl, bp, ...) \
161     _GEOM_DEBUG("GEOM_VINUM", g_vinum_debug, (lvl), (bp), __VA_ARGS__)
162 
163 #endif /* !_GEOM_VINUM_H_ */
164