.TH "chirp_status" 1 "" "CCTools 7.0.9 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBchirp_status\fP - get current status of a one or more Chirp server(s)

.SH SYNOPSIS
.LP
\FC\fBchirp_status [options] <nane> <value>\fP\FT

.SH DESCRIPTION
.LP
\fBchirp_status\fP is a tool for checking status of Chirp server(s).
.PP
\fBchirp_status\fP can look up Chirp server(s) using type, name, port, owner and version.
.PP
\fBchirp_status\fP by default lists type, name, port, owner, version, total and available storage of Chirp server(s)
.PP
When using \FCchirp_status\FT with long form option (-l), it lists additional information such as average load, available memory, operating system, up time, etc...

.SH OPTIONS
.LP
.LP
.TP
.BI \ --where \ <expr>
.
 Show only servers matching this expression.
.TP
\fB-c\fP, \fB-\-catalog\fP=\fI<host>\fP
.
Query the catalog on this host.
.TP
\fB-A\fP, \fB-\-server-space\fP=\fI<size>\fP
.
Only show servers with this space available. (example: -A 100MB).
.TP
.BI \ --server-project \ <name>
.
Only servers with this project name.
.TP
\fB-t\fP, \fB-\-timeout\fP=\fI<time>\fP
.
Timeout.
.TP
.B \ -s, --brief
.
Short output.
.TP
.B \ -l, --verbose
.
Long output.
.TP
.B \ -T, --totals
.
Totals output.
.TP
.B \ -v, --version
.
Show program version.
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this subsystem.
.TP
\fB-o\fP, \fB-\-debug-file\fP=\fI<file>\fP
.
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").
.TP
\fB-O\fP, \fB-\-debug-rotate-max\fP=\fI<bytes>\fP
.
Rotate file once it reaches this size.
.TP
.B \ -h, --help
.
Show help text.


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCHIRP_CLIENT_TICKETS\fP\FT Comma delimited list of tickets to authenticate with (same as \FC-i\FT).


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP

To show status of all available Chirp servers using \fBchirp_status\fP:

.fam C
.nf
.nh
.IP "" 8
% chirp_status
.fi
.hy
.fam
.P

To show status of a particular Chirp server:

.fam C
.nf
.nh
.IP "" 8
% chirp_status --where 'name=="server1.somewhere.edu"'
.fi
.hy
.fam
.P

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

.fam C
.nf
.nh
.IP "" 8
% chirp_status --where 'owner=="fred"'
.fi
.hy
.fam
.P

To show all details in JSON format:

.fam C
.nf
.nh
.IP "" 8
% chirp_status --long
.fi
.hy
.fam
.P

To show aggregate status of all Chirp servers using  \fBchirp_status\fP:

.fam C
.nf
.nh
.IP "" 8
% chirp_status -T
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP


.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBChirp User Manual\fP
.IP \(bu 4
\fBchirp(1)\fP  \fBchirp_status(1)\fP  \fBchirp_fuse(1)\fP  \fBchirp_get(1)\fP  \fBchirp_put(1)\fP  \fBchirp_stream_files(1)\fP  \fBchirp_distribute(1)\fP  \fBchirp_benchmark(1)\fP  \fBchirp_server(1)\fP