chirp_status(1)

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

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.

SEE ALSO

CCTools