osinfo-db-import(1)

📦
version 1.12.0 · 13 versions
, in opensuse-leap 16.0

🎀 osinfo-db-import — the Osinfo DB Tools era 🎀

okay bestie, so this whole thing lives in the Osinfo DB Tools family (that's the manual name, iykyk) and it's called osinfo-db-import. it's the little tool that takes an osinfo database archive and unpacks it for you. let's get into it 💅

✨ NAME ✨

osinfo-db-import — import an osinfo database archive. literally its whole job. no cap 💖

🌸 SYNOPSIS 🌸

osinfo-db-import [OPTIONS...] [ARCHIVE-FILE]

🦋 DESCRIPTION 🦋

so the osinfo-db-import tool takes an osinfo database archive and extracts its contents into one of the standard database locations on the current host. iconic behaviour, honestly:

  • system — this is the primary system-wide database location, intended for use by operating system vendors distributing database files in the native package format.
  • local — this is the secondary system-wide database location, intended for use by system administrators wishing to provide an updated database for all users.
  • user — this is the user private database location, intended for use by unprivileged local users wishing to provide applications they use with an updated database.

if it's run by a privileged account (ie root), the local database location will be used by default, otherwise the user location will be used. that's the vibe check on defaults ✨

when passing a non local ARCHIVE-FILE, only http:// and https:// protocols are supported. like, those two only, don't try anything else 🙈

with no ARCHIVE-FILE, or when ARCHIVE-FILE is -, read standard input. yes queen, stdin is always an option 💜

🔥 OPTIONS 🔥

  • --user — override the default behaviour to force installation into the user database location.
  • --local — override the default behaviour to force installation into the local database location.
  • --system — override the default behaviour to force installation into the system database location.
  • --dir=PATH — override the default behaviour to force installation into the custom directory PATH. your path, your rules 💅
  • --root=PATH — prefix the installation location with the root directory given by "PATH". this is useful when wishing to install into a chroot environment or equivalent. lowkey genius for chroots 🧚
  • --latest — downloads the latest osinfo-db release from libosinfo's official releases website and installs it in the desired location. the latest osinfo-db release is only downloaded and installed when it's newer than the one installed in the desired location. note that this option is mutually exclusive with '--nightly'. so pick one, bestie, no double dipping 🍓
  • --nightly — downloads the nightly (unreleased) osinfo-db build from libosinfo's website and installs it in the desired location. unlike with '--latest' with this option the nightly archive always downloaded and installed regardless of the version installed in the desired location. note that this option is mutually exclusive with '--latest'. always fresh, always downloading, no thoughts head empty 🌈
  • -v, --verbose — display verbose progress information when installing files. love a progress update, keep me fed 👑

💀 EXIT STATUS 💀

the exit status will be 0 if all files were installed successfully, or 1 if at least one file could not be installed. that's it, that's the whole mood 😭

🫶 SEE ALSO 🫶

"osinfo-db-export(1)", "osinfo-db-path(1)" — go read those too, they're giving main character energy ✨

🌟 AUTHORS 🌟

Daniel P. Berrange <berrange@redhat.com> — thank you legend 🎀

Copyright (C) 2016 Red Hat, Inc.

👑 LICENSE 👑

"osinfo-db-import" is distributed under the terms of the GNU LGPL v2+ license. this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like fr fr, zero warranty, don't come for us 💀

okay that's the whole page! this little masterpiece is from osinfo-db-tools-1.12.0, dated 2025-05-02 🦋 so you know it's fresh, slay, periodt 💅✨

📦 where this page comes from