You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ansible/docs/man/man3/ansible.get_url.3

43 lines
1.4 KiB
Groff

.TH ANSIBLE.GET_URL 5 "2012-10-03" "0.8" "ANSIBLE MODULES"
." generated from library/get_url
.SH NAME
get_url \- Downloads files from HTTP, HTTPS, or FTP to node
." ------ DESCRIPTION
.SH DESCRIPTION
.PP
Downloads files from HTTP, HTTPS, or FTP to the remote server. The remote server must have direct access to the remote resource.
." ------ OPTIONS
."
."
.SH OPTIONS
.IP url
HTTP, HTTPS, or FTP URL(required)
.IP dest
absolute path of where to download the file to.If \fIdest\fR is a directory, the basename of the file on the remote server will be used. If a directory, \fIthirsty=yes\fR must also be set.(required)
.IP thirsty
if \fCyes\fR, will download the file every time and replace the file if the contents change. if \fCno\fR, the file will only be downloaded if the destination does not exist. Generally should be \fCyes\fR only for small local files. prior to 0.6, acts if \fCyes\fR by default.
.IR Choices :
yes,no. (default: no)(Added in Ansible version 0.7.)
.IP others
all arguments accepted by the \fIfile\fR module also work here."
."
." ------ NOTES
.SH NOTES
.PP
This module doesn't yet support configuration for proxies or passwords.
."
."
." ------ EXAMPLES
.SH EXAMPLES
.PP
.nf
get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440
.fi
." ------- AUTHOR
.SH AUTHOR
Jan-Piet Mens
.SH SEE ALSO
.IR ansible (1),
.I http://ansible.github.com/modules.html#get-url