---
name: "chirp_status"
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/chirp_status"
---

# chirp\_status(1)

get current status of a one or more Chirp server(s)

## NAME

**chirp\_status** - get current status of a one or more Chirp server(s)

## SYNOPSIS

FCchirp\_status \[options\] *\<nane\>* *\<value\>*FT

## DESCRIPTION

**chirp\_status** is a tool for checking status of Chirp server(s).

**chirp\_status** can look up Chirp server(s) using type, name, port, owner and version.

**chirp\_status** by default lists type, name, port, owner, version, total and available storage of Chirp server(s)

When using FCchirp\_statusFT with long form option (-l), it lists additional information such as average load, available memory, operating system, up time, etc...

## OPTIONS

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

   Show only servers matching this expression.

- **-c,--catalog=*\<host\>***

  Query the catalog on this host.

- **-A,--server-space=*\<size\>***

  Only show servers with this space available. (example: -A 100MB).

- **--server-project=*\<name\>***

  Only servers with this project name.

- **-t,--timeout=*\<time\>***

  Timeout.

- **-s,--brief**

  Short output.

- **-l,--verbose**

  Long output.

- **-T,--totals**

  Totals output.

- **-v,--version**

  Show program version.

- **-d,--debug=*\<flag\>***

  Enable debugging for this subsystem.

- **-o,--debug-file=*\<file\>***

  Write debugging output to this file. By default, debugging is sent to stderr (":stderr"). You may specify logs to be sent to stdout (":stdout") instead.

- **-O,--debug-rotate-max=*\<bytes\>***

  Rotate file once it reaches this size.

- **-h,--help**

  Show help text.

## ENVIRONMENT VARIABLES

- •

  FCCHIRP\_CLIENT\_TICKETSFT Comma delimited list of tickets to authenticate with (same as FC-iFT).

## EXIT STATUS

On success, returns zero.  On failure, returns non-zero.

## EXAMPLES

To show status of all available Chirp servers using **chirp\_status**:

```

```

-

  % chirp\_status

To show status of a particular Chirp server:

```

```

-

  % chirp\_status --where 'name=="server1.somewhere.edu"'

To show status of Chirp servers which belong to a particular owner:

```

```

-

  % chirp\_status --where 'owner=="fred"'

To show all details in JSON format:

```

```

-

  % chirp\_status --long

To show aggregate status of all Chirp servers using  **chirp\_status**:

```

```

-

  % chirp\_status -T

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

- •

  **Chirp User Manual**

- •

  **[chirp(1)](/chirp/1.md)**  **[chirp\_status(1)](/chirp_status/1.md)**  **[chirp\_fuse(1)](/chirp_fuse/1.md)**  **[chirp\_get(1)](/chirp_get/1.md)**  **[chirp\_put(1)](/chirp_put/1.md)**  **[chirp\_stream\_files(1)](/chirp_stream_files/1.md)**  **[chirp\_distribute(1)](/chirp_distribute/1.md)**  **[chirp\_benchmark(1)](/chirp_benchmark/1.md)**  **[chirp\_server(1)](/chirp_server/1.md)**