condor_urlfetch(1)

Name

condor_urlfetchfetch configuration given a URL

Synopsis
condor_urlfetch[-<daemon>] urllocal-url-cache-file

Description

Depending on the command line arguments, condor_urlfetchsends the result of a query from the urlto 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-fileto standard output.

condor_urlfetchis 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-filedoes notexist. If the file specified by local-url-cache-filedoes 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 STARTDor SCHEDD, then the URL query only occurs if the file defined by local-url-cache-filedoes not exist.

Exit Status

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

Author
Center for High Throughput Computing, University of Wisconsin&ndash;Madison

Copyright
Copyright © 1990-2019 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.