Scroll to navigation

osinfo-query(1) Libosinfo osinfo-query(1)

NAME

osinfo-query - Query information in the database

SYNOPSIS

osinfo-query [OPTIONS...] TYPE [CONDITION-1 [CONDITION-2 ...]]

DESCRIPTION

The "osinfo-query" command allows extraction of information from the database. TYPE can be one of "os", "platform", "device", or "deployment". With no conditions specified, all entities of the given type will be listed.

  # List all operating systems
  $ osinfo-query os
   Short ID             | Name       ...
  ----------------------+-----------
   centos-6.0           | CentOS 6.0 ...
   centos-6.1           | CentOS 6.1 ...
   ...

Conditions allow filtering based on specific properties of an entity. For example, to filter only distros from the Fedora Project, use

  # List all operating systems
  $ osinfo-query os vendor="Fedora Project"
   Short ID             | Name          ...
  ----------------------+--------------
   fedora1              | Fedora Core 1 ...
   fedora2              | Fedora Core 2 ...
   ...

The set of fields which are printed can be controlled using the --fields command line argument:

  # List all operating systems
  $ osinfo-query --fields=short-id,version os vendor="Fedora Project"
   Short ID             | Version
  ----------------------+----------
   fedora1              | 1
   fedora2              | 2
   ...

OPTIONS

Set the data sorting key. Defaults sorting the first column
Set the visibility of properties in output

PROPERTY NAMES

OS

Valid property names for the "os" type are:

The short OS identifier
The long OS name
The OS version string
The OS kernel family
The OS vendor
The OS release date
The OS end-of-life date
The OS code name
The OS identifier

PLATFORM

Valid property names for the "platform" type are:

The short platform identifier
The long platform name
The platform version string
The platform vendor
The platform release date
The platform end-of-life date
The platform code name
The platform identifier

DEVICE

Valid property names for the "device" type are:

The device name
The device product name
The device product ID string
The device vendor name
The device vendor ID string
The device type class
The device bus type
The device identifier

DEPLOYMENT

Valid property names for the "deployment" type are:

The deployment identifier

EXIT STATUS

The exit status will be 0 if matching entries were found, or 1 if not matches were found

SEE ALSO

osinfo-db-validate(1), osinfo-detect(1)

AUTHORS

Daniel P. Berrange <berrange@redhat.com>

COPYRIGHT

Copyright (C) 2012, 2014 Red Hat, Inc.

LICENSE

"osinfo-query" is distributed under the termsof 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

2024-11-02 libosinfo-1.12.0