NAME

       condor_ping - HTCondor Manual

       Attempt a security negotiation to determine if it succeeds

SYNOPSIS

       condor_ping [-help | -version ]

       condor_ping  [-debug  ]  [-address  <a.b.c.d:port>]  [-pool host name] [-name daemon name]
       [-type subsystem] [-config filename] [-quiet | -table | -verbose ] token [token [...] ]

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 type options. If no target  is  specified,  the
       default target is the condor_schedd daemon on the local machine.

       One  or  more token s 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.

       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.  Note that OWNER
       is  no  longer  used  in  HTCondor, but is kept here for use when talking to older daemons
       (prior to 9.9.0).
          READ  WRITE  ADMINISTRATOR  SOAP  CONFIG  OWNER  DAEMON   NEGOTIATOR   ADVERTISE_MASTER
          ADVERTISE_STARTD ADVERTISE_SCHEDD CLIENT

OPTIONS

          -help  Display usage information

          -version
                 Display version information

          -debug Print extra debugging information as the command executes.

          -config filename
                 Attempt the negotiation based on the contents of the configuration file contents
                 in file filename.

          -address <a.b.c.d:port>
                 Target the given IP address with the negotiation attempt.

          -pool hostname
                 Target the given host  with  the  negotiation  attempt.  May  be  combined  with
                 specifications defined by name and type options.

          -name daemonname
                 Target the daemon given by daemonname with the negotiation attempt.

          -type subsystem
                 Target  the  daemon identified by subsystem, one of the values of the predefined
                 $(SUBSYSTEM) macro.

          -quiet Set exit status only; no output displayed.

          -table Output is displayed with one result per line, in a table format.

          -verbose
                 Display all available output.

EXAMPLES

       The example Unix command

          $ condor_ping  -address "<127.0.0.1:9618>" -table READ WRITE DAEMON

       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.

EXIT STATUS

       condor_ping  will  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.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024,  Center for High Throughput Computing, Computer Sciences Department, University
       of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                           Apr 14, 2024                            CONDOR_PING(1)