NAME

       condor_urlfetch - HTCondor Manual

       fetch configuration given a URL

SYNOPSIS

       condor_urlfetch [-<daemon> ] url local-url-cache-file

DESCRIPTION

       Depending  on the command line arguments, condor_urlfetch sends the result of a query from
       the url to both standard output and to a file specified  by  local-url-cache-file,  or  it
       sends the contents of the file specified by local-url-cache-file to standard output.

       condor_urlfetch  is intended to be used as the program to run when defining configuration,
       such as in the nonfunctional example:

          LOCAL_CONFIG_FILE = $(LIBEXEC)/condor_urlfetch -$(SUBSYSTEM) \
            http://www.example.com/htcondor-baseconfig  local.config |

       The pipe character (|) at the end of this definition of the location  of  a  configuration
       file  changes  the  use  of the definition. It causes the command listed on the right hand
       side of this  assignment  statement  to  be  invoked,  and  standard  output  becomes  the
       configuration. The value of $(SUBSYSTEM) becomes the daemon that caused this configuration
       to be read. If $(SUBSYSTEM) evaluates to MASTER, then the URL query always occurs, and the
       result  is  sent  to  standard output as well as written to the file specified by argument
       local-url-cache-file. When $(SUBSYSTEM) evaluates to a daemon other than MASTER, then  the
       URL query only occurs if the file specified by local-url-cache-file does not exist. If the
       file specified by local-url-cache-file does exist, then the contents of this file is  sent
       to standard output.

       Note  that  if  the  configuration  kept  at  the URL site changes, and reconfiguration is
       requested, the -<daemon> argument needs to be -MASTER. This is the only way  to  guarantee
       that there will be a query of the changed URL contents, such that they will make their way
       into the configuration.

OPTIONS

          -<daemon>
                 The upper case name of the daemon issuing  the  request  for  the  configuration
                 output.  If  -MASTER,  then  the URL query always occurs. If a daemon other than
                 -MASTER, for example STARTD or SCHEDD, then the URL query  only  occurs  if  the
                 file defined by local-url-cache-file does not exist.

EXIT STATUS

       condor_urlfetch  will  exit  with  a  status  value  of 0 (zero) upon success and non zero
       otherwise.

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.

                                           Aug 03, 2024                        CONDOR_URLFETCH(1)