NAME¶

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

SYNOPSIS¶

chirp_status [options] <nane> <value>

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 chirp_status 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¶

•

CHIRP_CLIENT_TICKETS Comma delimited list of tickets to authenticate with (same as -i).

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_status(1) chirp_fuse(1) chirp_get(1) chirp_put(1) chirp_stream_files(1) chirp_distribute(1) chirp_benchmark(1) chirp_server(1)