.\"Man page for condor_ping 
.\"Generated by makeman on Tue May 29 00:38:53 2018
.TH condor_ping  1 "May 2018"
.SH Name
.P
condor_ping Attempt \- a security negotiation to determine if it succeeds 
.P

.SH Synopsis
condor_ping [-help -version] 
.P
condor_ping[-debug] [-address <a.b.c.d:port>] [-pool host name] [-name daemon name] [-type subsystem] [-config filename] [-quiet | -table | -verbose] token[token [...]] 
.P
.SH Description
condor_ping attempts a security negotiation to discover whether the configuration is set such that the negotiation succeeds. The target of the negotiation is defined by one or a combination of the address, pool, name, or typeoptions. If no target is specified, the default target is the condor_schedddaemon on the local machine. 
.P
One or more tokens may be listed, thereby specifying one or more authorization level to impersonate in security negotiation. A token is the value  ALL , an authorization level, a command name, or the integer value of a command. The many command names and their associated integer values will more likely be used by experts, and they are defined in the file  condor_includes/condor_commands.h . 
.P
An authorization level may be one of the following strings. If  ALL is listed, then negotiation is attempted for each of these possible authorization levels. 
.P

.B READ
.IP "" 3
.IP "" 3
.P
.B WRITE
.IP "" 3
.IP "" 3
.P
.B ADMINISTRATOR
.IP "" 3
.IP "" 3
.P
.B SOAP
.IP "" 3
.IP "" 3
.P
.B CONFIG
.IP "" 3
.IP "" 3
.P
.B OWNER
.IP "" 3
.IP "" 3
.P
.B DAEMON
.IP "" 3
.IP "" 3
.P
.B NEGOTIATOR
.IP "" 3
.IP "" 3
.P
.B ADVERTISE_MASTER
.IP "" 3
.IP "" 3
.P
.B ADVERTISE_STARTD
.IP "" 3
.IP "" 3
.P
.B ADVERTISE_SCHEDD
.IP "" 3
.IP "" 3
.P
.B CLIENT
.IP "" 3
.IP "" 3
.P
.SH Options
.P

.B -help
.IP "" 3
Display usage information 
.IP "" 3
.P
.B -version
.IP "" 3
Display version information 
.IP "" 3
.P
.B -debug
.IP "" 3
Print extra debugging information as the command executes. 
.IP "" 3
.P
.B -config filename
.IP "" 3
Attempt the negotiation based on the contents of the configuration file contents in file filename. 
.IP "" 3
.P
.B -address <a.b.c.d:port>
.IP "" 3
Target the given IP address with the negotiation attempt. 
.IP "" 3
.P
.B -pool hostname
.IP "" 3
Target the given hostwith the negotiation attempt. May be combined with specifications defined by nameand typeoptions. 
.IP "" 3
.P
.B -name daemonname
.IP "" 3
Target the daemon given by daemonnamewith the negotiation attempt. 
.IP "" 3
.P
.B -type subsystem
.IP "" 3
Target the daemon identified by subsystem, one of the values of the predefined  $(SUBSYSTEM) macro. 
.IP "" 3
.P
.B -quiet
.IP "" 3
Set exit status only; no output displayed. 
.IP "" 3
.P
.B -table
.IP "" 3
Output is displayed with one result per line, in a table format. 
.IP "" 3
.P
.B -verbose
.IP "" 3
Display all available output. 
.IP "" 3
.P

.SH Examples
.P
The example Unix command 
.P

.br
condor_ping   -address "<127.0.0.1:9618>" -table READ WRITE DAEMON
.P
places double quote marks around the sinful string to prevent the less than and the greater than characters from causing redirect of input and output. The given IP address is targeted with 3 attempts to negotiate: one at the  READ authorization level, one at the  WRITE authorization level, and one at the  DAEMON authorization level. 
.P
.SH Exit Status
.P
condor_pingwill exit with the status value of the negotiation it attempted, where 0 (zero) indicates success, and 1 (one) indicates failure. If multiple security negotiations were attempted, the exit status will be the logical OR of all values. 
.P
.SH Author
Center for High Throughput Computing, University of Wisconsin-Madison 
.SH Copyright
Copyright (C) 1990-2016 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.