]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sys/geom/geom_slice.c
bhnd(9): Fix a few mandoc related issues
[FreeBSD/FreeBSD.git] / sys / geom / geom_slice.c
1 /*-
2  * SPDX-License-Identifier: BSD-3-Clause
3  *
4  * Copyright (c) 2002 Poul-Henning Kamp
5  * Copyright (c) 2002 Networks Associates Technology, Inc.
6  * All rights reserved.
7  *
8  * This software was developed for the FreeBSD Project by Poul-Henning Kamp
9  * and NAI Labs, the Security Research Division of Network Associates, Inc.
10  * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
11  * DARPA CHATS research program.
12  *
13  * Redistribution and use in source and binary forms, with or without
14  * modification, are permitted provided that the following conditions
15  * are met:
16  * 1. Redistributions of source code must retain the above copyright
17  *    notice, this list of conditions and the following disclaimer.
18  * 2. Redistributions in binary form must reproduce the above copyright
19  *    notice, this list of conditions and the following disclaimer in the
20  *    documentation and/or other materials provided with the distribution.
21  * 3. The names of the authors may not be used to endorse or promote
22  *    products derived from this software without specific prior written
23  *    permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35  * SUCH DAMAGE.
36  */
37
38 #include <sys/cdefs.h>
39 __FBSDID("$FreeBSD$");
40
41 #include <sys/param.h>
42 #include <sys/systm.h>
43 #include <sys/kernel.h>
44 #include <sys/malloc.h>
45 #include <sys/bio.h>
46 #include <sys/sysctl.h>
47 #include <sys/proc.h>
48 #include <sys/lock.h>
49 #include <sys/mutex.h>
50 #include <sys/errno.h>
51 #include <sys/sbuf.h>
52 #include <geom/geom.h>
53 #include <geom/geom_slice.h>
54 #include <machine/stdarg.h>
55
56 static g_access_t g_slice_access;
57 static g_start_t g_slice_start;
58
59 static struct g_slicer *
60 g_slice_alloc(unsigned nslice, unsigned scsize)
61 {
62         struct g_slicer *gsp;
63
64         gsp = g_malloc(sizeof *gsp, M_WAITOK | M_ZERO);
65         if (scsize > 0)
66                 gsp->softc = g_malloc(scsize, M_WAITOK | M_ZERO);
67         else
68                 gsp->softc = NULL;
69         gsp->slices = g_malloc(nslice * sizeof(struct g_slice),
70             M_WAITOK | M_ZERO);
71         gsp->nslice = nslice;
72         return (gsp);
73 }
74
75 static void
76 g_slice_free(struct g_geom *gp)
77 {
78         struct g_slicer *gsp;
79
80         gsp = gp->softc;
81         gp->softc = NULL;
82
83         /*
84          * We can get multiple spoiled events before wither-washer
85          * detaches our consumer, so this can get called multiple
86          * times.
87          */
88         if (gsp == NULL)
89                 return;
90         g_free(gsp->slices);
91         if (gsp->hotspot != NULL)
92                 g_free(gsp->hotspot);
93         if (gsp->softc != NULL)
94                 g_free(gsp->softc);
95         g_free(gsp);
96 }
97
98 static int
99 g_slice_access(struct g_provider *pp, int dr, int dw, int de)
100 {
101         int error;
102         u_int u;
103         struct g_geom *gp;
104         struct g_consumer *cp;
105         struct g_provider *pp2;
106         struct g_slicer *gsp;
107         struct g_slice *gsl, *gsl2;
108
109         gp = pp->geom;
110         cp = LIST_FIRST(&gp->consumer);
111         KASSERT (cp != NULL, ("g_slice_access but no consumer"));
112         gsp = gp->softc;
113         if (dr > 0 || dw > 0 || de > 0) {
114                 gsl = &gsp->slices[pp->index];
115                 for (u = 0; u < gsp->nslice; u++) {
116                         gsl2 = &gsp->slices[u];
117                         if (gsl2->length == 0)
118                                 continue;
119                         if (u == pp->index)
120                                 continue;
121                         if (gsl->offset + gsl->length <= gsl2->offset)
122                                 continue;
123                         if (gsl2->offset + gsl2->length <= gsl->offset)
124                                 continue;
125                         /* overlap */
126                         pp2 = gsl2->provider;
127                         if ((pp->acw + dw) > 0 && pp2->ace > 0)
128                                 return (EPERM);
129                         if ((pp->ace + de) > 0 && pp2->acw > 0)
130                                 return (EPERM);
131                 }
132         }
133         /* On first open, grab an extra "exclusive" bit */
134         if (cp->acr == 0 && cp->acw == 0 && cp->ace == 0)
135                 de++;
136         /* ... and let go of it on last close */
137         if ((cp->acr + dr) == 0 && (cp->acw + dw) == 0 && (cp->ace + de) == 1)
138                 de--;
139         error = g_access(cp, dr, dw, de);
140
141         /*
142          * Free the softc if all providers have been closed and this geom
143          * is being removed.
144          */
145         if (error == 0 && (gp->flags & G_GEOM_WITHER) != 0 &&
146             (cp->acr + cp->acw + cp->ace) == 0)
147                 g_slice_free(gp);
148
149         return (error);
150 }
151
152 /*
153  * XXX: It should be possible to specify here if we should finish all of the
154  * XXX: bio, or only the non-hot bits.  This would get messy if there were
155  * XXX: two hot spots in the same bio, so for now we simply finish off the
156  * XXX: entire bio.  Modifying hot data on the way to disk is frowned on
157  * XXX: so making that considerably harder is not a bad idea anyway.
158  */
159 void
160 g_slice_finish_hot(struct bio *bp)
161 {
162         struct bio *bp2;
163         struct g_geom *gp;
164         struct g_consumer *cp;
165         struct g_slicer *gsp;
166         struct g_slice *gsl;
167         int idx;
168
169         KASSERT(bp->bio_to != NULL,
170             ("NULL bio_to in g_slice_finish_hot(%p)", bp));
171         KASSERT(bp->bio_from != NULL,
172             ("NULL bio_from in g_slice_finish_hot(%p)", bp));
173         gp = bp->bio_to->geom;
174         gsp = gp->softc;
175         cp = LIST_FIRST(&gp->consumer);
176         KASSERT(cp != NULL, ("NULL consumer in g_slice_finish_hot(%p)", bp));
177         idx = bp->bio_to->index;
178         gsl = &gsp->slices[idx];
179
180         bp2 = g_clone_bio(bp);
181         if (bp2 == NULL) {
182                 g_io_deliver(bp, ENOMEM);
183                 return;
184         }
185         if (bp2->bio_offset + bp2->bio_length > gsl->length)
186                 bp2->bio_length = gsl->length - bp2->bio_offset;
187         bp2->bio_done = g_std_done;
188         bp2->bio_offset += gsl->offset;
189         g_io_request(bp2, cp);
190         return;
191 }
192
193 static void
194 g_slice_done(struct bio *bp)
195 {
196
197         KASSERT(bp->bio_cmd == BIO_GETATTR &&
198             strcmp(bp->bio_attribute, "GEOM::ident") == 0,
199             ("bio_cmd=0x%x bio_attribute=%s", bp->bio_cmd, bp->bio_attribute));
200
201         if (bp->bio_error == 0 && bp->bio_data[0] != '\0') {
202                 char idx[8];
203
204                 /* Add index to the ident received. */
205                 snprintf(idx, sizeof(idx), "s%d",
206                     bp->bio_parent->bio_to->index);
207                 if (strlcat(bp->bio_data, idx, bp->bio_length) >=
208                     bp->bio_length) {
209                         bp->bio_error = EFAULT;
210                 }
211         }
212         g_std_done(bp);
213 }
214
215 static void
216 g_slice_start(struct bio *bp)
217 {
218         struct bio *bp2;
219         struct g_provider *pp;
220         struct g_geom *gp;
221         struct g_consumer *cp;
222         struct g_slicer *gsp;
223         struct g_slice *gsl;
224         struct g_slice_hot *ghp;
225         int idx, error;
226         u_int m_index;
227         off_t t;
228
229         pp = bp->bio_to;
230         gp = pp->geom;
231         gsp = gp->softc;
232         cp = LIST_FIRST(&gp->consumer);
233         idx = pp->index;
234         gsl = &gsp->slices[idx];
235         switch(bp->bio_cmd) {
236         case BIO_READ:
237         case BIO_WRITE:
238         case BIO_DELETE:
239                 if (bp->bio_offset > gsl->length) {
240                         g_io_deliver(bp, EINVAL); /* XXX: EWHAT ? */
241                         return;
242                 }
243                 /*
244                  * Check if we collide with any hot spaces, and call the
245                  * method once if so.
246                  */
247                 t = bp->bio_offset + gsl->offset;
248                 for (m_index = 0; m_index < gsp->nhotspot; m_index++) {
249                         ghp = &gsp->hotspot[m_index];
250                         if (t >= ghp->offset + ghp->length)
251                                 continue;
252                         if (t + bp->bio_length <= ghp->offset)
253                                 continue;
254                         switch(bp->bio_cmd) {
255                         case BIO_READ:          idx = ghp->ract; break;
256                         case BIO_WRITE:         idx = ghp->wact; break;
257                         case BIO_DELETE:        idx = ghp->dact; break;
258                         }
259                         switch(idx) {
260                         case G_SLICE_HOT_ALLOW:
261                                 /* Fall out and continue normal processing */
262                                 continue;
263                         case G_SLICE_HOT_DENY:
264                                 g_io_deliver(bp, EROFS);
265                                 return;
266                         case G_SLICE_HOT_START:
267                                 error = gsp->start(bp);
268                                 if (error && error != EJUSTRETURN)
269                                         g_io_deliver(bp, error);
270                                 return;
271                         case G_SLICE_HOT_CALL:
272                                 error = g_post_event(gsp->hot, bp, M_NOWAIT,
273                                     gp, NULL);
274                                 if (error)
275                                         g_io_deliver(bp, error);
276                                 return;
277                         }
278                         break;
279                 }
280                 bp2 = g_clone_bio(bp);
281                 if (bp2 == NULL) {
282                         g_io_deliver(bp, ENOMEM);
283                         return;
284                 }
285                 if (bp2->bio_offset + bp2->bio_length > gsl->length)
286                         bp2->bio_length = gsl->length - bp2->bio_offset;
287                 bp2->bio_done = g_std_done;
288                 bp2->bio_offset += gsl->offset;
289                 g_io_request(bp2, cp);
290                 return;
291         case BIO_GETATTR:
292                 /* Give the real method a chance to override */
293                 if (gsp->start != NULL && gsp->start(bp))
294                         return;
295                 if (!strcmp("GEOM::ident", bp->bio_attribute)) {
296                         bp2 = g_clone_bio(bp);
297                         if (bp2 == NULL) {
298                                 g_io_deliver(bp, ENOMEM);
299                                 return;
300                         }
301                         bp2->bio_done = g_slice_done;
302                         g_io_request(bp2, cp);
303                         return;
304                 }
305                 if (!strcmp("GEOM::kerneldump", bp->bio_attribute)) {
306                         struct g_kerneldump *gkd;
307
308                         gkd = (struct g_kerneldump *)bp->bio_data;
309                         gkd->offset += gsp->slices[idx].offset;
310                         if (gkd->length > gsp->slices[idx].length)
311                                 gkd->length = gsp->slices[idx].length;
312                         /* now, pass it on downwards... */
313                 }
314                 /* FALLTHROUGH */
315         case BIO_SPEEDUP:
316         case BIO_FLUSH:
317                 bp2 = g_clone_bio(bp);
318                 if (bp2 == NULL) {
319                         g_io_deliver(bp, ENOMEM);
320                         return;
321                 }
322                 bp2->bio_done = g_std_done;
323                 g_io_request(bp2, cp);
324                 break;
325         default:
326                 g_io_deliver(bp, EOPNOTSUPP);
327                 return;
328         }
329 }
330
331 void
332 g_slice_dumpconf(struct sbuf *sb, const char *indent, struct g_geom *gp, struct g_consumer *cp, struct g_provider *pp)
333 {
334         struct g_slicer *gsp;
335
336         gsp = gp->softc;
337         if (indent == NULL) {
338                 sbuf_printf(sb, " i %u", pp->index);
339                 sbuf_printf(sb, " o %ju", 
340                     (uintmax_t)gsp->slices[pp->index].offset);
341                 return;
342         }
343         if (pp != NULL) {
344                 sbuf_printf(sb, "%s<index>%u</index>\n", indent, pp->index);
345                 sbuf_printf(sb, "%s<length>%ju</length>\n",
346                     indent, (uintmax_t)gsp->slices[pp->index].length);
347                 sbuf_printf(sb, "%s<seclength>%ju</seclength>\n", indent,
348                     (uintmax_t)gsp->slices[pp->index].length / 512);
349                 sbuf_printf(sb, "%s<offset>%ju</offset>\n", indent,
350                     (uintmax_t)gsp->slices[pp->index].offset);
351                 sbuf_printf(sb, "%s<secoffset>%ju</secoffset>\n", indent,
352                     (uintmax_t)gsp->slices[pp->index].offset / 512);
353         }
354 }
355
356 int
357 g_slice_config(struct g_geom *gp, u_int idx, int how, off_t offset, off_t length, u_int sectorsize, const char *fmt, ...)
358 {
359         struct g_provider *pp, *pp2;
360         struct g_slicer *gsp;
361         struct g_slice *gsl;
362         va_list ap;
363         struct sbuf *sb;
364         int acc;
365
366         g_trace(G_T_TOPOLOGY, "g_slice_config(%s, %d, %d)",
367              gp->name, idx, how);
368         g_topology_assert();
369         gsp = gp->softc;
370         if (idx >= gsp->nslice)
371                 return(EINVAL);
372         gsl = &gsp->slices[idx];
373         pp = gsl->provider;
374         if (pp != NULL)
375                 acc = pp->acr + pp->acw + pp->ace;
376         else
377                 acc = 0;
378         if (acc != 0 && how != G_SLICE_CONFIG_FORCE) {
379                 if (length < gsl->length)
380                         return(EBUSY);
381                 if (offset != gsl->offset)
382                         return(EBUSY);
383         }
384         /* XXX: check offset + length <= MEDIASIZE */
385         if (how == G_SLICE_CONFIG_CHECK)
386                 return (0);
387         gsl->length = length;
388         gsl->offset = offset;
389         gsl->sectorsize = sectorsize;
390         if (length == 0) {
391                 if (pp == NULL)
392                         return (0);
393                 if (bootverbose)
394                         printf("GEOM: Deconfigure %s\n", pp->name);
395                 g_wither_provider(pp, ENXIO);
396                 gsl->provider = NULL;
397                 gsp->nprovider--;
398                 return (0);
399         }
400         if (pp != NULL) {
401                 if (bootverbose)
402                         printf("GEOM: Reconfigure %s, start %jd length %jd end %jd\n",
403                             pp->name, (intmax_t)offset, (intmax_t)length,
404                             (intmax_t)(offset + length - 1));
405                 g_resize_provider(pp, gsl->length);
406                 return (0);
407         }
408         sb = sbuf_new_auto();
409         va_start(ap, fmt);
410         sbuf_vprintf(sb, fmt, ap);
411         va_end(ap);
412         sbuf_finish(sb);
413         pp = g_new_providerf(gp, "%s", sbuf_data(sb));
414         pp2 = LIST_FIRST(&gp->consumer)->provider;
415         pp->stripesize = pp2->stripesize;
416         pp->stripeoffset = pp2->stripeoffset + offset;
417         if (pp->stripesize > 0)
418                 pp->stripeoffset %= pp->stripesize;
419         if (gsp->nhotspot == 0) {
420                 pp->flags |= pp2->flags & G_PF_ACCEPT_UNMAPPED;
421                 pp->flags |= G_PF_DIRECT_SEND | G_PF_DIRECT_RECEIVE;
422         }
423         if (0 && bootverbose)
424                 printf("GEOM: Configure %s, start %jd length %jd end %jd\n",
425                     pp->name, (intmax_t)offset, (intmax_t)length,
426                     (intmax_t)(offset + length - 1));
427         pp->index = idx;
428         pp->mediasize = gsl->length;
429         pp->sectorsize = gsl->sectorsize;
430         gsl->provider = pp;
431         gsp->nprovider++;
432         g_error_provider(pp, 0);
433         sbuf_delete(sb);
434         return(0);
435 }
436
437 /*
438  * Configure "hotspots".  A hotspot is a piece of the parent device which
439  * this particular slicer cares about for some reason.  Typically because
440  * it contains meta-data used to configure the slicer.
441  * A hotspot is identified by its index number. The offset and length are
442  * relative to the parent device, and the three "?act" fields specify
443  * what action to take on BIO_READ, BIO_DELETE and BIO_WRITE.
444  *
445  * XXX: There may be a race relative to g_slice_start() here, if an existing
446  * XXX: hotspot is changed wile I/O is happening.  Should this become a problem
447  * XXX: we can protect the hotspot stuff with a mutex.
448  */
449
450 int
451 g_slice_conf_hot(struct g_geom *gp, u_int idx, off_t offset, off_t length, int ract, int dact, int wact)
452 {
453         struct g_slicer *gsp;
454         struct g_slice_hot *gsl, *gsl2;
455         struct g_consumer *cp;
456         struct g_provider *pp;
457
458         g_trace(G_T_TOPOLOGY, "g_slice_conf_hot(%s, idx: %d, off: %jd, len: %jd)",
459             gp->name, idx, (intmax_t)offset, (intmax_t)length);
460         g_topology_assert();
461         gsp = gp->softc;
462         /* Deny unmapped I/O and direct dispatch if hotspots are used. */
463         if (gsp->nhotspot == 0) {
464                 LIST_FOREACH(pp, &gp->provider, provider)
465                         pp->flags &= ~(G_PF_ACCEPT_UNMAPPED |
466                             G_PF_DIRECT_SEND | G_PF_DIRECT_RECEIVE);
467                 LIST_FOREACH(cp, &gp->consumer, consumer)
468                         cp->flags &= ~(G_CF_DIRECT_SEND | G_CF_DIRECT_RECEIVE);
469         }
470         gsl = gsp->hotspot;
471         if(idx >= gsp->nhotspot) {
472                 gsl2 = g_malloc((idx + 1) * sizeof *gsl2, M_WAITOK | M_ZERO);
473                 if (gsp->hotspot != NULL)
474                         bcopy(gsp->hotspot, gsl2, gsp->nhotspot * sizeof *gsl2);
475                 gsp->hotspot = gsl2;
476                 if (gsp->hotspot != NULL)
477                         g_free(gsl);
478                 gsl = gsl2;
479                 gsp->nhotspot = idx + 1;
480         }
481         gsl[idx].offset = offset;
482         gsl[idx].length = length;
483         KASSERT(!((ract | dact | wact) & G_SLICE_HOT_START)
484             || gsp->start != NULL, ("G_SLICE_HOT_START but no slice->start"));
485         /* XXX: check that we _have_ a start function if HOT_START specified */
486         gsl[idx].ract = ract;
487         gsl[idx].dact = dact;
488         gsl[idx].wact = wact;
489         return (0);
490 }
491
492 void
493 g_slice_orphan(struct g_consumer *cp)
494 {
495         struct g_geom *gp;
496
497         g_topology_assert();
498         gp = cp->geom;
499         g_trace(G_T_TOPOLOGY, "%s(%p/%s)", __func__, cp, gp->name);
500         g_wither_geom(gp, ENXIO);
501
502         /*
503          * We can safely free the softc now if there are no accesses,
504          * otherwise g_slice_access() will do that after the last close.
505          */
506         if ((cp->acr + cp->acw + cp->ace) == 0)
507                 g_slice_free(gp);
508 }
509
510 void
511 g_slice_spoiled(struct g_consumer *cp)
512 {
513
514         g_trace(G_T_TOPOLOGY, "%s(%p/%s)", __func__, cp, cp->geom->name);
515         cp->flags |= G_CF_ORPHAN;
516         g_slice_orphan(cp);
517 }
518
519 int
520 g_slice_destroy_geom(struct gctl_req *req, struct g_class *mp, struct g_geom *gp)
521 {
522
523         g_slice_spoiled(LIST_FIRST(&gp->consumer));
524         return (0);
525 }
526
527 struct g_geom *
528 g_slice_new(struct g_class *mp, u_int slices, struct g_provider *pp, struct g_consumer **cpp, void *extrap, int extra, g_slice_start_t *start)
529 {
530         struct g_geom *gp;
531         struct g_slicer *gsp;
532         struct g_consumer *cp;
533         void **vp;
534         int error;
535
536         g_topology_assert();
537         vp = (void **)extrap;
538         gp = g_new_geomf(mp, "%s", pp->name);
539         gsp = g_slice_alloc(slices, extra);
540         gsp->start = start;
541         gp->softc = gsp;
542         gp->start = g_slice_start;
543         gp->access = g_slice_access;
544         gp->orphan = g_slice_orphan;
545         gp->spoiled = g_slice_spoiled;
546         if (gp->dumpconf == NULL)
547                 gp->dumpconf = g_slice_dumpconf;
548         if (gp->class->destroy_geom == NULL)
549                 gp->class->destroy_geom = g_slice_destroy_geom;
550         cp = g_new_consumer(gp);
551         cp->flags |= G_CF_DIRECT_SEND | G_CF_DIRECT_RECEIVE;
552         error = g_attach(cp, pp);
553         if (error == 0)
554                 error = g_access(cp, 1, 0, 0);
555         if (error) {
556                 g_wither_geom(gp, ENXIO);
557                 return (NULL);
558         }
559         if (extrap != NULL)
560                 *vp = gsp->softc;
561         *cpp = cp;
562         return (gp);
563 }