OSINFO-QUERY.C

Section: Virtualization Support (1)
Updated: 2019-11-08
Page Index
 

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

-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>  

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
PROPERTY NAMES
OS
PLATFORM
DEVICE
DEPLOYMENT
EXIT STATUS
SEE ALSO
AUTHORS
COPYRIGHT
LICENSE
LinuxReviews : manual page archive : man1