osinfo-query - Man Page

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

-s PROPERTY, --sort-key PROPERTY

Set the data sorting key. Defaults sorting the first column

-f PROPERTY1,PROPERTY2,..., --fields PROPERTY1,PROPERTY2,...

Set the visibility of properties in output

Property Names

OS

Valid property names for the os type are:

short-id

The short OS identifier

name

The long OS name

version

The OS version string

family

The OS kernel family

vendor

The OS vendor

release-date

The OS release date

eol-date

The OS end-of-life date

codename

The OS code name

id

The OS identifier

Platform

Valid property names for the platform type are:

short-id

The short platform identifier

name

The long platform name

version

The platform version string

vendor

The platform vendor

release-date

The platform release date

eol-date

The platform end-of-life date

codename

The platform code name

id

The platform identifier

Device

Valid property names for the device type are:

name

The device name

product

The device product name

product-id

The device product ID string

vendor

The device vendor name

vendor-id

The device vendor ID string

class

The device type class

bus

The device bus type

id

The device identifier

Deployment

Valid property names for the deployment type are:

id

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>

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

Info

2026-09-16 libosinfo-1.12.0