osinfo-query man page

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

-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

2016-07-01 libosinfo-1.0.0 Virtualization Support