cdist-type__install_stage(7)
============================
Steven Armstrong <steven-cdist--@--armstrong.cc>


NAME
----
cdist-type__install_stage - download and unpack a stage file


DESCRIPTION
-----------
Downloads a operating system stage using curl and unpacks it to /target
using tar. The stage tarball is expected to be gzip compressed.


REQUIRED PARAMETERS
-------------------
uri::
   The uri from which to fetch the tarball.
   Can be anything understood by curl, e.g:
      http://path/to/stage.tgz
      tftp:///path/to/stage.tgz
      file:///local/path/stage.tgz


OPTIONAL PARAMETERS
-------------------
target::
   where to unpack the tarball to. Defaults to /target.


BOOLEAN PARAMETERS
------------------
insecure::
   run curl in insecure mode so it does not check the servers ssl certificate


EXAMPLES
--------

--------------------------------------------------------------------------------
__install_stage --uri tftp:///path/to/stage.tgz
__install_stage --uri http://path/to/stage.tgz --target /mnt/foobar
__install_stage --uri file:///path/to/stage.tgz --target /target
__install_stage --uri https://path/to/stage.tgz --target /mnt/foobar --insecure
--------------------------------------------------------------------------------


SEE ALSO
--------
- cdist-type(7)


COPYING
-------
Copyright \(C) 2011 - 2013 Steven Armstrong. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).