2 * Copyright (c) 2005-2011 Pawel Jakub Dawidek <pawel@dawidek.net>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
30 #include <sys/param.h>
31 #include <sys/systm.h>
33 #include <sys/kernel.h>
34 #include <sys/linker.h>
35 #include <sys/module.h>
37 #include <sys/mutex.h>
40 #include <sys/sysctl.h>
41 #include <sys/malloc.h>
42 #include <sys/eventhandler.h>
43 #include <sys/kthread.h>
45 #include <sys/sched.h>
48 #include <sys/vnode.h>
52 #include <geom/geom.h>
53 #include <geom/eli/g_eli.h>
54 #include <geom/eli/pkcs5v2.h>
56 #include <crypto/intake.h>
58 FEATURE(geom_eli, "GEOM crypto module");
60 MALLOC_DEFINE(M_ELI, "eli data", "GEOM_ELI Data");
62 SYSCTL_DECL(_kern_geom);
63 SYSCTL_NODE(_kern_geom, OID_AUTO, eli, CTLFLAG_RW, 0, "GEOM_ELI stuff");
64 static int g_eli_version = G_ELI_VERSION;
65 SYSCTL_INT(_kern_geom_eli, OID_AUTO, version, CTLFLAG_RD, &g_eli_version, 0,
68 SYSCTL_INT(_kern_geom_eli, OID_AUTO, debug, CTLFLAG_RWTUN, &g_eli_debug, 0,
70 static u_int g_eli_tries = 3;
71 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, tries, CTLFLAG_RWTUN, &g_eli_tries, 0,
72 "Number of tries for entering the passphrase");
73 static u_int g_eli_visible_passphrase = GETS_NOECHO;
74 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, visible_passphrase, CTLFLAG_RWTUN,
75 &g_eli_visible_passphrase, 0,
76 "Visibility of passphrase prompt (0 = invisible, 1 = visible, 2 = asterisk)");
77 u_int g_eli_overwrites = G_ELI_OVERWRITES;
78 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, overwrites, CTLFLAG_RWTUN, &g_eli_overwrites,
79 0, "Number of times on-disk keys should be overwritten when destroying them");
80 static u_int g_eli_threads = 0;
81 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, threads, CTLFLAG_RWTUN, &g_eli_threads, 0,
82 "Number of threads doing crypto work");
83 u_int g_eli_batch = 0;
84 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, batch, CTLFLAG_RWTUN, &g_eli_batch, 0,
85 "Use crypto operations batching");
88 * Passphrase cached during boot, in order to be more user-friendly if
89 * there are multiple providers using the same passphrase.
91 static char cached_passphrase[256];
92 static u_int g_eli_boot_passcache = 1;
93 TUNABLE_INT("kern.geom.eli.boot_passcache", &g_eli_boot_passcache);
94 SYSCTL_UINT(_kern_geom_eli, OID_AUTO, boot_passcache, CTLFLAG_RD,
95 &g_eli_boot_passcache, 0,
96 "Passphrases are cached during boot process for possible reuse");
98 fetch_loader_passphrase(void * dummy)
100 char * env_passphrase;
102 KASSERT(dynamic_kenv, ("need dynamic kenv"));
104 if ((env_passphrase = kern_getenv("kern.geom.eli.passphrase")) != NULL) {
105 /* Extract passphrase from the environment. */
106 strlcpy(cached_passphrase, env_passphrase,
107 sizeof(cached_passphrase));
108 freeenv(env_passphrase);
110 /* Wipe the passphrase from the environment. */
111 kern_unsetenv("kern.geom.eli.passphrase");
114 SYSINIT(geli_fetch_loader_passphrase, SI_SUB_KMEM + 1, SI_ORDER_ANY,
115 fetch_loader_passphrase, NULL);
118 zero_boot_passcache(void)
121 explicit_bzero(cached_passphrase, sizeof(cached_passphrase));
125 zero_geli_intake_keys(void)
127 struct keybuf *keybuf;
130 if ((keybuf = get_keybuf()) != NULL) {
131 /* Scan the key buffer, clear all GELI keys. */
132 for (i = 0; i < keybuf->kb_nents; i++) {
133 if (keybuf->kb_ents[i].ke_type == KEYBUF_TYPE_GELI) {
134 explicit_bzero(keybuf->kb_ents[i].ke_data,
135 sizeof(keybuf->kb_ents[i].ke_data));
136 keybuf->kb_ents[i].ke_type = KEYBUF_TYPE_NONE;
143 zero_intake_passcache(void *dummy)
145 zero_boot_passcache();
146 zero_geli_intake_keys();
148 EVENTHANDLER_DEFINE(mountroot, zero_intake_passcache, NULL, 0);
150 static eventhandler_tag g_eli_pre_sync = NULL;
152 static int g_eli_destroy_geom(struct gctl_req *req, struct g_class *mp,
154 static void g_eli_init(struct g_class *mp);
155 static void g_eli_fini(struct g_class *mp);
157 static g_taste_t g_eli_taste;
158 static g_dumpconf_t g_eli_dumpconf;
160 struct g_class g_eli_class = {
161 .name = G_ELI_CLASS_NAME,
162 .version = G_VERSION,
163 .ctlreq = g_eli_config,
164 .taste = g_eli_taste,
165 .destroy_geom = g_eli_destroy_geom,
174 * g_eli_start -> g_eli_crypto_read -> g_io_request -> g_eli_read_done -> g_eli_crypto_run -> g_eli_crypto_read_done -> g_io_deliver
176 * g_eli_start -> g_eli_crypto_run -> g_eli_crypto_write_done -> g_io_request -> g_eli_write_done -> g_io_deliver
181 * EAGAIN from crypto(9) means, that we were probably balanced to another crypto
182 * accelerator or something like this.
183 * The function updates the SID and rerun the operation.
186 g_eli_crypto_rerun(struct cryptop *crp)
188 struct g_eli_softc *sc;
189 struct g_eli_worker *wr;
193 bp = (struct bio *)crp->crp_opaque;
194 sc = bp->bio_to->geom->softc;
195 LIST_FOREACH(wr, &sc->sc_workers, w_next) {
196 if (wr->w_number == bp->bio_pflags)
199 KASSERT(wr != NULL, ("Invalid worker (%u).", bp->bio_pflags));
200 G_ELI_DEBUG(1, "Rerunning crypto %s request (sid: %ju -> %ju).",
201 bp->bio_cmd == BIO_READ ? "READ" : "WRITE", (uintmax_t)wr->w_sid,
202 (uintmax_t)crp->crp_sid);
203 wr->w_sid = crp->crp_sid;
205 error = crypto_dispatch(crp);
208 G_ELI_DEBUG(1, "%s: crypto_dispatch() returned %d.", __func__, error);
209 crp->crp_etype = error;
214 * The function is called afer reading encrypted data from the provider.
216 * g_eli_start -> g_eli_crypto_read -> g_io_request -> G_ELI_READ_DONE -> g_eli_crypto_run -> g_eli_crypto_read_done -> g_io_deliver
219 g_eli_read_done(struct bio *bp)
221 struct g_eli_softc *sc;
224 G_ELI_LOGREQ(2, bp, "Request done.");
225 pbp = bp->bio_parent;
226 if (pbp->bio_error == 0 && bp->bio_error != 0)
227 pbp->bio_error = bp->bio_error;
230 * Do we have all sectors already?
233 if (pbp->bio_inbed < pbp->bio_children)
235 sc = pbp->bio_to->geom->softc;
236 if (pbp->bio_error != 0) {
237 G_ELI_LOGREQ(0, pbp, "%s() failed (error=%d)", __func__,
239 pbp->bio_completed = 0;
240 if (pbp->bio_driver2 != NULL) {
241 free(pbp->bio_driver2, M_ELI);
242 pbp->bio_driver2 = NULL;
244 g_io_deliver(pbp, pbp->bio_error);
245 atomic_subtract_int(&sc->sc_inflight, 1);
248 mtx_lock(&sc->sc_queue_mtx);
249 bioq_insert_tail(&sc->sc_queue, pbp);
250 mtx_unlock(&sc->sc_queue_mtx);
255 * The function is called after we encrypt and write data.
257 * g_eli_start -> g_eli_crypto_run -> g_eli_crypto_write_done -> g_io_request -> G_ELI_WRITE_DONE -> g_io_deliver
260 g_eli_write_done(struct bio *bp)
262 struct g_eli_softc *sc;
265 G_ELI_LOGREQ(2, bp, "Request done.");
266 pbp = bp->bio_parent;
267 if (pbp->bio_error == 0 && bp->bio_error != 0)
268 pbp->bio_error = bp->bio_error;
271 * Do we have all sectors already?
274 if (pbp->bio_inbed < pbp->bio_children)
276 free(pbp->bio_driver2, M_ELI);
277 pbp->bio_driver2 = NULL;
278 if (pbp->bio_error != 0) {
279 G_ELI_LOGREQ(0, pbp, "%s() failed (error=%d)", __func__,
281 pbp->bio_completed = 0;
283 pbp->bio_completed = pbp->bio_length;
286 * Write is finished, send it up.
288 sc = pbp->bio_to->geom->softc;
289 g_io_deliver(pbp, pbp->bio_error);
290 atomic_subtract_int(&sc->sc_inflight, 1);
294 * This function should never be called, but GEOM made as it set ->orphan()
295 * method for every geom.
298 g_eli_orphan_spoil_assert(struct g_consumer *cp)
301 panic("Function %s() called for %s.", __func__, cp->geom->name);
305 g_eli_orphan(struct g_consumer *cp)
307 struct g_eli_softc *sc;
310 sc = cp->geom->softc;
313 g_eli_destroy(sc, TRUE);
318 * G_ELI_START -> g_eli_crypto_read -> g_io_request -> g_eli_read_done -> g_eli_crypto_run -> g_eli_crypto_read_done -> g_io_deliver
320 * G_ELI_START -> g_eli_crypto_run -> g_eli_crypto_write_done -> g_io_request -> g_eli_write_done -> g_io_deliver
323 g_eli_start(struct bio *bp)
325 struct g_eli_softc *sc;
326 struct g_consumer *cp;
329 sc = bp->bio_to->geom->softc;
331 ("Provider's error should be set (error=%d)(device=%s).",
332 bp->bio_to->error, bp->bio_to->name));
333 G_ELI_LOGREQ(2, bp, "Request received.");
335 switch (bp->bio_cmd) {
344 * If the user hasn't set the NODELETE flag, we just pass
345 * it down the stack and let the layers beneath us do (or
346 * not) whatever they do with it. If they have, we
347 * reject it. A possible extension would be an
348 * additional flag to take it as a hint to shred the data
349 * with [multiple?] overwrites.
351 if (!(sc->sc_flags & G_ELI_FLAG_NODELETE))
354 g_io_deliver(bp, EOPNOTSUPP);
357 cbp = g_clone_bio(bp);
359 g_io_deliver(bp, ENOMEM);
362 bp->bio_driver1 = cbp;
363 bp->bio_pflags = G_ELI_NEW_BIO;
364 switch (bp->bio_cmd) {
366 if (!(sc->sc_flags & G_ELI_FLAG_AUTH)) {
367 g_eli_crypto_read(sc, bp, 0);
372 mtx_lock(&sc->sc_queue_mtx);
373 bioq_insert_tail(&sc->sc_queue, bp);
374 mtx_unlock(&sc->sc_queue_mtx);
381 cbp->bio_done = g_std_done;
382 cp = LIST_FIRST(&sc->sc_geom->consumer);
383 cbp->bio_to = cp->provider;
384 G_ELI_LOGREQ(2, cbp, "Sending request.");
385 g_io_request(cbp, cp);
391 g_eli_newsession(struct g_eli_worker *wr)
393 struct g_eli_softc *sc;
394 struct cryptoini crie, cria;
399 bzero(&crie, sizeof(crie));
400 crie.cri_alg = sc->sc_ealgo;
401 crie.cri_klen = sc->sc_ekeylen;
402 if (sc->sc_ealgo == CRYPTO_AES_XTS)
404 if ((sc->sc_flags & G_ELI_FLAG_FIRST_KEY) != 0) {
405 crie.cri_key = g_eli_key_hold(sc, 0,
406 LIST_FIRST(&sc->sc_geom->consumer)->provider->sectorsize);
408 crie.cri_key = sc->sc_ekey;
410 if (sc->sc_flags & G_ELI_FLAG_AUTH) {
411 bzero(&cria, sizeof(cria));
412 cria.cri_alg = sc->sc_aalgo;
413 cria.cri_klen = sc->sc_akeylen;
414 cria.cri_key = sc->sc_akey;
415 crie.cri_next = &cria;
418 switch (sc->sc_crypto) {
419 case G_ELI_CRYPTO_SW:
420 error = crypto_newsession(&wr->w_sid, &crie,
421 CRYPTOCAP_F_SOFTWARE);
423 case G_ELI_CRYPTO_HW:
424 error = crypto_newsession(&wr->w_sid, &crie,
425 CRYPTOCAP_F_HARDWARE);
427 case G_ELI_CRYPTO_UNKNOWN:
428 error = crypto_newsession(&wr->w_sid, &crie,
429 CRYPTOCAP_F_HARDWARE);
431 mtx_lock(&sc->sc_queue_mtx);
432 if (sc->sc_crypto == G_ELI_CRYPTO_UNKNOWN)
433 sc->sc_crypto = G_ELI_CRYPTO_HW;
434 mtx_unlock(&sc->sc_queue_mtx);
436 error = crypto_newsession(&wr->w_sid, &crie,
437 CRYPTOCAP_F_SOFTWARE);
438 mtx_lock(&sc->sc_queue_mtx);
439 if (sc->sc_crypto == G_ELI_CRYPTO_UNKNOWN)
440 sc->sc_crypto = G_ELI_CRYPTO_SW;
441 mtx_unlock(&sc->sc_queue_mtx);
445 panic("%s: invalid condition", __func__);
448 if ((sc->sc_flags & G_ELI_FLAG_FIRST_KEY) != 0)
449 g_eli_key_drop(sc, crie.cri_key);
455 g_eli_freesession(struct g_eli_worker *wr)
458 crypto_freesession(wr->w_sid);
462 g_eli_cancel(struct g_eli_softc *sc)
466 mtx_assert(&sc->sc_queue_mtx, MA_OWNED);
468 while ((bp = bioq_takefirst(&sc->sc_queue)) != NULL) {
469 KASSERT(bp->bio_pflags == G_ELI_NEW_BIO,
470 ("Not new bio when canceling (bp=%p).", bp));
471 g_io_deliver(bp, ENXIO);
476 g_eli_takefirst(struct g_eli_softc *sc)
480 mtx_assert(&sc->sc_queue_mtx, MA_OWNED);
482 if (!(sc->sc_flags & G_ELI_FLAG_SUSPEND))
483 return (bioq_takefirst(&sc->sc_queue));
485 * Device suspended, so we skip new I/O requests.
487 TAILQ_FOREACH(bp, &sc->sc_queue.queue, bio_queue) {
488 if (bp->bio_pflags != G_ELI_NEW_BIO)
492 bioq_remove(&sc->sc_queue, bp);
497 * This is the main function for kernel worker thread when we don't have
498 * hardware acceleration and we have to do cryptography in software.
499 * Dedicated thread is needed, so we don't slow down g_up/g_down GEOM
500 * threads with crypto work.
503 g_eli_worker(void *arg)
505 struct g_eli_softc *sc;
506 struct g_eli_worker *wr;
512 #ifdef EARLY_AP_STARTUP
513 MPASS(!sc->sc_cpubind || smp_started);
515 /* Before sched_bind() to a CPU, wait for all CPUs to go on-line. */
516 if (sc->sc_cpubind) {
518 tsleep(wr, 0, "geli:smp", hz / 4);
521 thread_lock(curthread);
522 sched_prio(curthread, PUSER);
524 sched_bind(curthread, wr->w_number % mp_ncpus);
525 thread_unlock(curthread);
527 G_ELI_DEBUG(1, "Thread %s started.", curthread->td_proc->p_comm);
530 mtx_lock(&sc->sc_queue_mtx);
532 bp = g_eli_takefirst(sc);
534 if (sc->sc_flags & G_ELI_FLAG_DESTROY) {
536 LIST_REMOVE(wr, w_next);
537 g_eli_freesession(wr);
539 G_ELI_DEBUG(1, "Thread %s exiting.",
540 curthread->td_proc->p_comm);
541 wakeup(&sc->sc_workers);
542 mtx_unlock(&sc->sc_queue_mtx);
545 while (sc->sc_flags & G_ELI_FLAG_SUSPEND) {
546 if (sc->sc_inflight > 0) {
547 G_ELI_DEBUG(0, "inflight=%d",
550 * We still have inflight BIOs, so
553 msleep(sc, &sc->sc_queue_mtx, PRIBIO,
558 * Suspend requested, mark the worker as
559 * suspended and go to sleep.
562 g_eli_freesession(wr);
563 wr->w_active = FALSE;
565 wakeup(&sc->sc_workers);
566 msleep(sc, &sc->sc_queue_mtx, PRIBIO,
569 !(sc->sc_flags & G_ELI_FLAG_SUSPEND)) {
570 error = g_eli_newsession(wr);
572 ("g_eli_newsession() failed on resume (error=%d)",
578 msleep(sc, &sc->sc_queue_mtx, PDROP, "geli:w", 0);
581 if (bp->bio_pflags == G_ELI_NEW_BIO)
582 atomic_add_int(&sc->sc_inflight, 1);
583 mtx_unlock(&sc->sc_queue_mtx);
584 if (bp->bio_pflags == G_ELI_NEW_BIO) {
586 if (sc->sc_flags & G_ELI_FLAG_AUTH) {
587 if (bp->bio_cmd == BIO_READ)
588 g_eli_auth_read(sc, bp);
590 g_eli_auth_run(wr, bp);
592 if (bp->bio_cmd == BIO_READ)
593 g_eli_crypto_read(sc, bp, 1);
595 g_eli_crypto_run(wr, bp);
598 if (sc->sc_flags & G_ELI_FLAG_AUTH)
599 g_eli_auth_run(wr, bp);
601 g_eli_crypto_run(wr, bp);
607 g_eli_read_metadata(struct g_class *mp, struct g_provider *pp,
608 struct g_eli_metadata *md)
611 struct g_consumer *cp;
617 gp = g_new_geomf(mp, "eli:taste");
618 gp->start = g_eli_start;
619 gp->access = g_std_access;
621 * g_eli_read_metadata() is always called from the event thread.
622 * Our geom is created and destroyed in the same event, so there
623 * could be no orphan nor spoil event in the meantime.
625 gp->orphan = g_eli_orphan_spoil_assert;
626 gp->spoiled = g_eli_orphan_spoil_assert;
627 cp = g_new_consumer(gp);
628 error = g_attach(cp, pp);
631 error = g_access(cp, 1, 0, 0);
635 buf = g_read_data(cp, pp->mediasize - pp->sectorsize, pp->sectorsize,
640 error = eli_metadata_decode(buf, md);
643 /* Metadata was read and decoded successfully. */
647 if (cp->provider != NULL) {
649 g_access(cp, -1, 0, 0);
652 g_destroy_consumer(cp);
658 * The function is called when we had last close on provider and user requested
659 * to close it when this situation occur.
662 g_eli_last_close(void *arg, int flags __unused)
670 strlcpy(gpname, gp->name, sizeof(gpname));
671 error = g_eli_destroy(gp->softc, TRUE);
672 KASSERT(error == 0, ("Cannot detach %s on last close (error=%d).",
674 G_ELI_DEBUG(0, "Detached %s on last close.", gpname);
678 g_eli_access(struct g_provider *pp, int dr, int dw, int de)
680 struct g_eli_softc *sc;
687 if (sc->sc_flags & G_ELI_FLAG_RO) {
688 /* Deny write attempts. */
691 /* Someone is opening us for write, we need to remember that. */
692 sc->sc_flags |= G_ELI_FLAG_WOPEN;
695 /* Is this the last close? */
696 if (pp->acr + dr > 0 || pp->acw + dw > 0 || pp->ace + de > 0)
700 * Automatically detach on last close if requested.
702 if ((sc->sc_flags & G_ELI_FLAG_RW_DETACH) ||
703 (sc->sc_flags & G_ELI_FLAG_WOPEN)) {
704 g_post_event(g_eli_last_close, gp, M_WAITOK, NULL);
710 g_eli_cpu_is_disabled(int cpu)
713 return (CPU_ISSET(cpu, &hlt_cpus_mask));
720 g_eli_create(struct gctl_req *req, struct g_class *mp, struct g_provider *bpp,
721 const struct g_eli_metadata *md, const u_char *mkey, int nkey)
723 struct g_eli_softc *sc;
724 struct g_eli_worker *wr;
726 struct g_provider *pp;
727 struct g_consumer *cp;
731 G_ELI_DEBUG(1, "Creating device %s%s.", bpp->name, G_ELI_SUFFIX);
733 gp = g_new_geomf(mp, "%s%s", bpp->name, G_ELI_SUFFIX);
734 sc = malloc(sizeof(*sc), M_ELI, M_WAITOK | M_ZERO);
735 gp->start = g_eli_start;
737 * Spoiling can happen even though we have the provider open
738 * exclusively, e.g. through media change events.
740 gp->spoiled = g_eli_orphan;
741 gp->orphan = g_eli_orphan;
742 gp->dumpconf = g_eli_dumpconf;
744 * If detach-on-last-close feature is not enabled and we don't operate
745 * on read-only provider, we can simply use g_std_access().
747 if (md->md_flags & (G_ELI_FLAG_WO_DETACH | G_ELI_FLAG_RO))
748 gp->access = g_eli_access;
750 gp->access = g_std_access;
752 eli_metadata_softc(sc, md, bpp->sectorsize, bpp->mediasize);
758 bioq_init(&sc->sc_queue);
759 mtx_init(&sc->sc_queue_mtx, "geli:queue", NULL, MTX_DEF);
760 mtx_init(&sc->sc_ekeys_lock, "geli:ekeys", NULL, MTX_DEF);
763 cp = g_new_consumer(gp);
764 error = g_attach(cp, bpp);
767 gctl_error(req, "Cannot attach to %s (error=%d).",
770 G_ELI_DEBUG(1, "Cannot attach to %s (error=%d).",
776 * Keep provider open all the time, so we can run critical tasks,
777 * like Master Keys deletion, without wondering if we can open
779 * We don't open provider for writing only when user requested read-only
782 if (sc->sc_flags & G_ELI_FLAG_RO)
783 error = g_access(cp, 1, 0, 1);
785 error = g_access(cp, 1, 1, 1);
788 gctl_error(req, "Cannot access %s (error=%d).",
791 G_ELI_DEBUG(1, "Cannot access %s (error=%d).",
798 * Remember the keys in our softc structure.
800 g_eli_mkey_propagate(sc, mkey);
802 LIST_INIT(&sc->sc_workers);
804 threads = g_eli_threads;
807 sc->sc_cpubind = (mp_ncpus > 1 && threads == mp_ncpus);
808 for (i = 0; i < threads; i++) {
809 if (g_eli_cpu_is_disabled(i)) {
810 G_ELI_DEBUG(1, "%s: CPU %u disabled, skipping.",
814 wr = malloc(sizeof(*wr), M_ELI, M_WAITOK | M_ZERO);
819 error = g_eli_newsession(wr);
823 gctl_error(req, "Cannot set up crypto session "
824 "for %s (error=%d).", bpp->name, error);
826 G_ELI_DEBUG(1, "Cannot set up crypto session "
827 "for %s (error=%d).", bpp->name, error);
832 error = kproc_create(g_eli_worker, wr, &wr->w_proc, 0, 0,
833 "g_eli[%u] %s", i, bpp->name);
835 g_eli_freesession(wr);
838 gctl_error(req, "Cannot create kernel thread "
839 "for %s (error=%d).", bpp->name, error);
841 G_ELI_DEBUG(1, "Cannot create kernel thread "
842 "for %s (error=%d).", bpp->name, error);
846 LIST_INSERT_HEAD(&sc->sc_workers, wr, w_next);
850 * Create decrypted provider.
852 pp = g_new_providerf(gp, "%s%s", bpp->name, G_ELI_SUFFIX);
853 pp->mediasize = sc->sc_mediasize;
854 pp->sectorsize = sc->sc_sectorsize;
856 g_error_provider(pp, 0);
858 G_ELI_DEBUG(0, "Device %s created.", pp->name);
859 G_ELI_DEBUG(0, "Encryption: %s %u", g_eli_algo2str(sc->sc_ealgo),
861 if (sc->sc_flags & G_ELI_FLAG_AUTH)
862 G_ELI_DEBUG(0, " Integrity: %s", g_eli_algo2str(sc->sc_aalgo));
863 G_ELI_DEBUG(0, " Crypto: %s",
864 sc->sc_crypto == G_ELI_CRYPTO_SW ? "software" : "hardware");
867 mtx_lock(&sc->sc_queue_mtx);
868 sc->sc_flags |= G_ELI_FLAG_DESTROY;
871 * Wait for kernel threads self destruction.
873 while (!LIST_EMPTY(&sc->sc_workers)) {
874 msleep(&sc->sc_workers, &sc->sc_queue_mtx, PRIBIO,
877 mtx_destroy(&sc->sc_queue_mtx);
878 if (cp->provider != NULL) {
880 g_access(cp, -1, -1, -1);
883 g_destroy_consumer(cp);
885 g_eli_key_destroy(sc);
886 bzero(sc, sizeof(*sc));
892 g_eli_destroy(struct g_eli_softc *sc, boolean_t force)
895 struct g_provider *pp;
903 pp = LIST_FIRST(&gp->provider);
904 if (pp != NULL && (pp->acr != 0 || pp->acw != 0 || pp->ace != 0)) {
906 G_ELI_DEBUG(1, "Device %s is still open, so it "
907 "cannot be definitely removed.", pp->name);
908 sc->sc_flags |= G_ELI_FLAG_RW_DETACH;
909 gp->access = g_eli_access;
910 g_wither_provider(pp, ENXIO);
914 "Device %s is still open (r%dw%de%d).", pp->name,
915 pp->acr, pp->acw, pp->ace);
920 mtx_lock(&sc->sc_queue_mtx);
921 sc->sc_flags |= G_ELI_FLAG_DESTROY;
923 while (!LIST_EMPTY(&sc->sc_workers)) {
924 msleep(&sc->sc_workers, &sc->sc_queue_mtx, PRIBIO,
927 mtx_destroy(&sc->sc_queue_mtx);
929 g_eli_key_destroy(sc);
930 bzero(sc, sizeof(*sc));
933 if (pp == NULL || (pp->acr == 0 && pp->acw == 0 && pp->ace == 0))
934 G_ELI_DEBUG(0, "Device %s destroyed.", gp->name);
935 g_wither_geom_close(gp, ENXIO);
941 g_eli_destroy_geom(struct gctl_req *req __unused,
942 struct g_class *mp __unused, struct g_geom *gp)
944 struct g_eli_softc *sc;
947 return (g_eli_destroy(sc, FALSE));
951 g_eli_keyfiles_load(struct hmac_ctx *ctx, const char *provider)
953 u_char *keyfile, *data;
954 char *file, name[64];
959 snprintf(name, sizeof(name), "%s:geli_keyfile%d", provider, i);
960 keyfile = preload_search_by_type(name);
961 if (keyfile == NULL && i == 0) {
963 * If there is only one keyfile, allow simpler name.
965 snprintf(name, sizeof(name), "%s:geli_keyfile", provider);
966 keyfile = preload_search_by_type(name);
969 return (i); /* Return number of loaded keyfiles. */
970 data = preload_fetch_addr(keyfile);
972 G_ELI_DEBUG(0, "Cannot find key file data for %s.",
976 size = preload_fetch_size(keyfile);
978 G_ELI_DEBUG(0, "Cannot find key file size for %s.",
982 file = preload_search_info(keyfile, MODINFO_NAME);
984 G_ELI_DEBUG(0, "Cannot find key file name for %s.",
988 G_ELI_DEBUG(1, "Loaded keyfile %s for %s (type: %s).", file,
990 g_eli_crypto_hmac_update(ctx, data, size);
995 g_eli_keyfiles_clear(const char *provider)
997 u_char *keyfile, *data;
1002 for (i = 0; ; i++) {
1003 snprintf(name, sizeof(name), "%s:geli_keyfile%d", provider, i);
1004 keyfile = preload_search_by_type(name);
1005 if (keyfile == NULL)
1007 data = preload_fetch_addr(keyfile);
1008 size = preload_fetch_size(keyfile);
1009 if (data != NULL && size != 0)
1015 * Tasting is only made on boot.
1016 * We detect providers which should be attached before root is mounted.
1018 static struct g_geom *
1019 g_eli_taste(struct g_class *mp, struct g_provider *pp, int flags __unused)
1021 struct g_eli_metadata md;
1023 struct hmac_ctx ctx;
1024 char passphrase[256];
1025 u_char key[G_ELI_USERKEYLEN], mkey[G_ELI_DATAIVKEYLEN];
1026 u_int i, nkey, nkeyfiles, tries;
1028 struct keybuf *keybuf;
1030 g_trace(G_T_TOPOLOGY, "%s(%s, %s)", __func__, mp->name, pp->name);
1031 g_topology_assert();
1033 if (root_mounted() || g_eli_tries == 0)
1036 G_ELI_DEBUG(3, "Tasting %s.", pp->name);
1038 error = g_eli_read_metadata(mp, pp, &md);
1043 if (strcmp(md.md_magic, G_ELI_MAGIC) != 0)
1045 if (md.md_version > G_ELI_VERSION) {
1046 printf("geom_eli.ko module is too old to handle %s.\n",
1050 if (md.md_provsize != pp->mediasize)
1052 /* Should we attach it on boot? */
1053 if (!(md.md_flags & G_ELI_FLAG_BOOT))
1055 if (md.md_keys == 0x00) {
1056 G_ELI_DEBUG(0, "No valid keys on %s.", pp->name);
1059 if (md.md_iterations == -1) {
1060 /* If there is no passphrase, we try only once. */
1063 /* Ask for the passphrase no more than g_eli_tries times. */
1064 tries = g_eli_tries;
1067 if ((keybuf = get_keybuf()) != NULL) {
1068 /* Scan the key buffer, try all GELI keys. */
1069 for (i = 0; i < keybuf->kb_nents; i++) {
1070 if (keybuf->kb_ents[i].ke_type == KEYBUF_TYPE_GELI) {
1071 memcpy(key, keybuf->kb_ents[i].ke_data,
1074 if (g_eli_mkey_decrypt(&md, key,
1075 mkey, &nkey) == 0 ) {
1076 explicit_bzero(key, sizeof(key));
1083 for (i = 0; i <= tries; i++) {
1084 g_eli_crypto_hmac_init(&ctx, NULL, 0);
1087 * Load all key files.
1089 nkeyfiles = g_eli_keyfiles_load(&ctx, pp->name);
1091 if (nkeyfiles == 0 && md.md_iterations == -1) {
1093 * No key files and no passphrase, something is
1094 * definitely wrong here.
1095 * geli(8) doesn't allow for such situation, so assume
1096 * that there was really no passphrase and in that case
1097 * key files are no properly defined in loader.conf.
1100 "Found no key files in loader.conf for %s.",
1105 /* Ask for the passphrase if defined. */
1106 if (md.md_iterations >= 0) {
1107 /* Try first with cached passphrase. */
1109 if (!g_eli_boot_passcache)
1111 memcpy(passphrase, cached_passphrase,
1112 sizeof(passphrase));
1114 printf("Enter passphrase for %s: ", pp->name);
1115 cngets(passphrase, sizeof(passphrase),
1116 g_eli_visible_passphrase);
1117 memcpy(cached_passphrase, passphrase,
1118 sizeof(passphrase));
1123 * Prepare Derived-Key from the user passphrase.
1125 if (md.md_iterations == 0) {
1126 g_eli_crypto_hmac_update(&ctx, md.md_salt,
1127 sizeof(md.md_salt));
1128 g_eli_crypto_hmac_update(&ctx, passphrase,
1129 strlen(passphrase));
1130 explicit_bzero(passphrase, sizeof(passphrase));
1131 } else if (md.md_iterations > 0) {
1132 u_char dkey[G_ELI_USERKEYLEN];
1134 pkcs5v2_genkey(dkey, sizeof(dkey), md.md_salt,
1135 sizeof(md.md_salt), passphrase, md.md_iterations);
1136 bzero(passphrase, sizeof(passphrase));
1137 g_eli_crypto_hmac_update(&ctx, dkey, sizeof(dkey));
1138 explicit_bzero(dkey, sizeof(dkey));
1141 g_eli_crypto_hmac_final(&ctx, key, 0);
1144 * Decrypt Master-Key.
1146 error = g_eli_mkey_decrypt(&md, key, mkey, &nkey);
1147 bzero(key, sizeof(key));
1151 "Wrong key for %s. No tries left.",
1153 g_eli_keyfiles_clear(pp->name);
1158 "Wrong key for %s. Tries left: %u.",
1159 pp->name, tries - i);
1163 } else if (error > 0) {
1165 "Cannot decrypt Master Key for %s (error=%d).",
1167 g_eli_keyfiles_clear(pp->name);
1170 g_eli_keyfiles_clear(pp->name);
1171 G_ELI_DEBUG(1, "Using Master Key %u for %s.", nkey, pp->name);
1177 * We have correct key, let's attach provider.
1179 gp = g_eli_create(NULL, mp, pp, &md, mkey, nkey);
1180 bzero(mkey, sizeof(mkey));
1181 bzero(&md, sizeof(md));
1183 G_ELI_DEBUG(0, "Cannot create device %s%s.", pp->name,
1191 g_eli_dumpconf(struct sbuf *sb, const char *indent, struct g_geom *gp,
1192 struct g_consumer *cp, struct g_provider *pp)
1194 struct g_eli_softc *sc;
1196 g_topology_assert();
1200 if (pp != NULL || cp != NULL)
1201 return; /* Nothing here. */
1203 sbuf_printf(sb, "%s<KeysTotal>%ju</KeysTotal>\n", indent,
1204 (uintmax_t)sc->sc_ekeys_total);
1205 sbuf_printf(sb, "%s<KeysAllocated>%ju</KeysAllocated>\n", indent,
1206 (uintmax_t)sc->sc_ekeys_allocated);
1207 sbuf_printf(sb, "%s<Flags>", indent);
1208 if (sc->sc_flags == 0)
1209 sbuf_printf(sb, "NONE");
1213 #define ADD_FLAG(flag, name) do { \
1214 if (sc->sc_flags & (flag)) { \
1216 sbuf_printf(sb, ", "); \
1219 sbuf_printf(sb, name); \
1222 ADD_FLAG(G_ELI_FLAG_SUSPEND, "SUSPEND");
1223 ADD_FLAG(G_ELI_FLAG_SINGLE_KEY, "SINGLE-KEY");
1224 ADD_FLAG(G_ELI_FLAG_NATIVE_BYTE_ORDER, "NATIVE-BYTE-ORDER");
1225 ADD_FLAG(G_ELI_FLAG_ONETIME, "ONETIME");
1226 ADD_FLAG(G_ELI_FLAG_BOOT, "BOOT");
1227 ADD_FLAG(G_ELI_FLAG_WO_DETACH, "W-DETACH");
1228 ADD_FLAG(G_ELI_FLAG_RW_DETACH, "RW-DETACH");
1229 ADD_FLAG(G_ELI_FLAG_AUTH, "AUTH");
1230 ADD_FLAG(G_ELI_FLAG_WOPEN, "W-OPEN");
1231 ADD_FLAG(G_ELI_FLAG_DESTROY, "DESTROY");
1232 ADD_FLAG(G_ELI_FLAG_RO, "READ-ONLY");
1233 ADD_FLAG(G_ELI_FLAG_NODELETE, "NODELETE");
1234 ADD_FLAG(G_ELI_FLAG_GELIBOOT, "GELIBOOT");
1237 sbuf_printf(sb, "</Flags>\n");
1239 if (!(sc->sc_flags & G_ELI_FLAG_ONETIME)) {
1240 sbuf_printf(sb, "%s<UsedKey>%u</UsedKey>\n", indent,
1243 sbuf_printf(sb, "%s<Version>%u</Version>\n", indent, sc->sc_version);
1244 sbuf_printf(sb, "%s<Crypto>", indent);
1245 switch (sc->sc_crypto) {
1246 case G_ELI_CRYPTO_HW:
1247 sbuf_printf(sb, "hardware");
1249 case G_ELI_CRYPTO_SW:
1250 sbuf_printf(sb, "software");
1253 sbuf_printf(sb, "UNKNOWN");
1256 sbuf_printf(sb, "</Crypto>\n");
1257 if (sc->sc_flags & G_ELI_FLAG_AUTH) {
1259 "%s<AuthenticationAlgorithm>%s</AuthenticationAlgorithm>\n",
1260 indent, g_eli_algo2str(sc->sc_aalgo));
1262 sbuf_printf(sb, "%s<KeyLength>%u</KeyLength>\n", indent,
1264 sbuf_printf(sb, "%s<EncryptionAlgorithm>%s</EncryptionAlgorithm>\n",
1265 indent, g_eli_algo2str(sc->sc_ealgo));
1266 sbuf_printf(sb, "%s<State>%s</State>\n", indent,
1267 (sc->sc_flags & G_ELI_FLAG_SUSPEND) ? "SUSPENDED" : "ACTIVE");
1271 g_eli_shutdown_pre_sync(void *arg, int howto)
1274 struct g_geom *gp, *gp2;
1275 struct g_provider *pp;
1276 struct g_eli_softc *sc;
1281 LIST_FOREACH_SAFE(gp, &mp->geom, geom, gp2) {
1285 pp = LIST_FIRST(&gp->provider);
1286 KASSERT(pp != NULL, ("No provider? gp=%p (%s)", gp, gp->name));
1287 if (pp->acr + pp->acw + pp->ace == 0)
1288 error = g_eli_destroy(sc, TRUE);
1290 sc->sc_flags |= G_ELI_FLAG_RW_DETACH;
1291 gp->access = g_eli_access;
1294 g_topology_unlock();
1298 g_eli_init(struct g_class *mp)
1301 g_eli_pre_sync = EVENTHANDLER_REGISTER(shutdown_pre_sync,
1302 g_eli_shutdown_pre_sync, mp, SHUTDOWN_PRI_FIRST);
1303 if (g_eli_pre_sync == NULL)
1304 G_ELI_DEBUG(0, "Warning! Cannot register shutdown event.");
1308 g_eli_fini(struct g_class *mp)
1311 if (g_eli_pre_sync != NULL)
1312 EVENTHANDLER_DEREGISTER(shutdown_pre_sync, g_eli_pre_sync);
1315 DECLARE_GEOM_CLASS(g_eli_class, g_eli);
1316 MODULE_DEPEND(g_eli, crypto, 1, 1, 1);