bionic (1) osinfo-query.1.gz

Provided by: libosinfo-bin_1.1.0-1_amd64 bug

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