home | help
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 data-
     base. 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

     nameThe 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

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

     nameThe 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

libosinfo-1.12.0		   2024-10-29			 osinfo-query(1)

home | help