---
name: "catalog_query"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/catalog_query"
---

# catalog\_query(1)

query records from the catalog server

## NAME

**catalog\_query** - query records from the catalog server

## SYNOPSIS

FCcatalog\_query \[--where \[expr\]\] \[--catalog \[host\]\] \[-d \[flag\]\] \[-o \[file\]\] \[-O \[size\]\] \[-t \[timeout\]\] \[-h\] FT

## DESCRIPTION

**catalog\_query** is a tool that queries the catalog server for running services. The output can be filtered by an arbitrary expression, and displayed in raw JSON form, or in tabular form. This tool is handy for querying custom record types not handled by other tools.

## ARGUMENTS

- **--where=*\<expr\>***

   Only records matching this expression will be displayed.

- **--output=*\<expr\>***

   Display this expression for each record.

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

## EXAMPLES

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´

To show all records of WQ applications with name, port, and owner in tabular form:

```

```

-

  % catalog\_query --where ´type=="wq\_master

To show all records of WQ applications with name, port, and owner as JSON records:

```

```

-

  % catalog\_query --where ´type=="wq\_master

## COPYRIGHT

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

## SEE ALSO

- •

  **Cooperative Computing Tools Documentation**

- •

  **[catalog\_server(1)](/catalog_server/1.md)**  **[catalog\_update(1)](/catalog_update/1.md)**  **[catalog\_query(1)](/catalog_query/1.md)**  **[chirp\_status(1)](/chirp_status/1.md)**  **[work\_queue\_status(1)](/work_queue_status/1.md)**   **[deltadb\_query(1)](/deltadb_query/1.md)**