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 be sent to stdout (":stdout"), to the system syslog (":syslog"), or to the systemd journal (":journal").

-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) 2005-2019 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)