catalog_query - query records from the catalog server


*catalog_query [--where [expr]] [--catalog [host]] [-d [flag]] [-o [file]] [-O [size]] [-t [timeout]] [-h] *


catalog_query is a tool that queries a catalog server for raw JSON records. The records can be filtered by an optional --where expression. This tool is handy for querying custom record types not handled by other tools.


  • --where expr Only records matching this expression will be displayed.
  • --catalog host Query this catalog host.
  • --debug flag Enable debugging for this subsystem.
  • --debug-file file Send debug output to this file.
  • --debug-rotate-max bytes Rotate debug file once it reaches this size.
  • --timeout seconds Abandon the query after this many seconds.
  • --help Show command options.


To show all records in the catalog server:

% catalog_query

To show all records of other catalog servers:

% catalog_query --where \'type=="catalog"\'

To show all records of Chirp servers with more than 4 cpus:

% catalog_query --where \'type=="chirp" && cpus > 4\'

The Cooperative Computing Tools are Copyright (C) 2005-2021 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.


CCTools 7.3.2 FINAL