SOFTHSM2-MIGRATE(1)

💖 SOFTHSM2-MIGRATE 💖

okay bestie, gather round, because this is the SoftHSM v1 migration tool and it's lowkey a whole legend. it lives in the General Commands Manual section of your man pages, and it's here to move your old SoftHSM v1 database into the PKCS#11 era. slay.

✨ NAME ✨

softhsm2-migrate — the SoftHSM v1 migration tool. that's it, that's the whole vibe. it takes your dusty old v1 database and gives it a glow-up into PKCS#11. 💅

🦋 SYNOPSIS 🦋

softhsm2-migrate --db path --token label [--pin PIN --no-public-key]

look at her. minimal. iconic. the way she needs a --db and a --token and then optionally a --pin and --no-public-key in that cute little bracket situation. periodt.

🌸 DESCRIPTION 🌸

so here's the tea, bestie: softhsm2-migrate is a tool that can migrate SoftHSM v1 databases to PKCS#11. that's literally its whole job and it does it gorgeously. 🫶

the default HSM it targets is SoftHSM v2, but ngl you're not locked in — you can point it at other PKCS#11 libraries too by using the --module option. main character energy, honestly.

🎀 OPTIONS 🎀

• --db path — the SoftHSM v1 database that's gonna get migrated. the location of the token database can be found in the configuration file for SoftHSM v1. go look, it's in there, i promise. 🍓
• --help, -h — show the help information. the classic. the "wait what were the flags again" button.
• --module path — use another PKCS#11 library than SoftHSM. go off, choose your own adventure.
• --no-public-key — do not migrate the public key. leave it behind, it's fine, it'll be okay. 😭
• --pin PIN — the PIN for the normal user. yes you need it, no you can't skip it if you want in.
• --serial number — will use the token with a matching serial number. like a little name tag but numbers. 🔥
• --slot number — the database will be migrated to this slot. pick your slot, bestie.
• --token label — will use the token with a matching token label. this is the one you probably want.
• --version, -v — show the version info. for when you need to know exactly which era of this tool you're dealing with.

🌈 EXAMPLE 🌈

a token database can be migrated with the following command:

softhsm2-migrate --db /home/user/token.db --token mytoken

look at her go. --db pointing at the database, --token naming the token, done. ate. 💖

👑 AUTHORS 👑

Written by Rickard Bellgrim, Francis Dupont, René Post, and Roland van Rijswijk. four whole icons collaborated on this and we simply must respect it. 🙈

💜 SEE ALSO 💜

• softhsm2-keyconv(1)
• softhsm2-util(1)
• softhsm2.conf(5)

ok that's the whole page bestie, no cap. every flag, every path, every number, all still exactly where you left them. iykyk. ✨

SoftHSM — 20 April 2016. mwah, that's the version and the date, and that's a wrap. 🦋💖✨