xenial (1) condor_urlfetch.1.gz

Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug

Name
       condor_urlfetch fetch - 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  STARTD or  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-Madison


       Copyright (C) 1990-2015 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.

                                                  February 2016                               condor_urlfetch(1)