Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
DIRENV-FETCHURL(1)		  User Manuals		      DIRENV-FETCHURL(1)

NAME
     direnv fetchurl - Fetch a URL to disk

SYNOPSIS
     direnv fetchurl  []

DESCRIPTION
     This  command  downloads the given URL into a fixed disk location, based on
     the content of the retrieved file.

     This has been introduced to avoid a dependency on curl or wget, while  also
     promoting	a  more secure way to fetch data from the Internet. Use this in-
     stead of curl <url> | sh.

     This command has two modes of operation:

	      1. Just pass the URL to discover the integrity hash.

	      2. Pass the URL and the integrity hash to get back the on-disk lo-
		 cation.

     Since the on-disk location is based on the hash, it also acts as  a  cache.
     One  implication  of this design is that URLs must be stable and always re-
     turn the same content.

     Downloaded files are marked as read-only and executable so it can	also  be
     used to fetch and execute static binaries.

OPTIONS
	 A HTTP URL that returns content on HTTP GET requests. 301 and other
	 redirects are followed.

	 When passed, the integrity of the retrieved content will be validated
	 against the given hash. The hash encoding is based on the SRI W3C
	 specification (see https://www.w3.org/TR/SRI/ ).

OUTPUT
     direnv fetchurl outputs different content based on the argument.

     If  the  integrity-hash is being passed, it will output the path to the on-
     disk location, if the retrieval was successful.

     If only the url is being passed, it will output the hash as  well	as  some
     human-readable  instruction.  If stdout is not a tty, only the hash will be
     displayed.

EXAMPLE
     $ ./direnv fetchurl https://releases.nixos.org/nix/nix-2.3.7/install
     Found hash: sha256-7Gxl5GzI9juc/U30Igh/pY+p6+gj5Waohfwql3jHIds=

     Invoke fetchurl again with the hash as an argument to get the disk location:

       direnv fetchurl "https://releases.nixos.org/nix/nix-2.3.7/install" "sha256-7Gxl5GzI9juc/U30Igh/pY+p6+gj5Waohfwql3jHIds="
       #=> /home/zimbatm/.cache/direnv/cas/sha256-7Gxl5GzI9juc_U30Igh_pY+p6+gj5Waohfwql3jHIds=

ENVIRONMENT VARIABLES
     XDG_CACHE_HOME
	 This variable is used to select the on-disk  location	of  the  fetched
     URLs
	 as $XDG_CACHE_HOME/direnv/cas. If XDG_CACHE_HOME is unset or empty,
	 defaults to $HOME/.cache.

COPYRIGHT
     MIT licence - Copyright (C) 2019 @zimbatm and contributors

SEE ALSO
     direnv-stdlib(1)

direnv				      2019		      DIRENV-FETCHURL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=direnv-fetchurl&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help