|
Elektra
0.9.3
|
The curlget plugin is a resolver using libcurl to upload and download files from/to remote hosts. When mounted with a URL as configuration file there will be no changes to the file system. When mounted with a (local) path to a configuration a copy of the remote configuration is kept and used as fallback in kdbGet() if fetching the remote file from the server fails.
URL:
an URL has to be prefixed with the protocol. valid protocols: http://, https://, ftp://, ftps://, scp://, sftp://, smb:// (currently not supported)
Filename:
can bei either an URL or a local configuration file.
if the filename is an URL the plugin operates on temporary files only and keeps no local copy of the configuration. unless specified otherwise the URL is used for both upload and download.
url:
URL used for both upload and download of the configuration. might be overwritten by url/get and url/put.
url/get:
the URL of the remote configuration file.
url/put:
the URL used to upload the configuration on kdbSet
upload/method:
only used for HTTP requests. use POST for POST-requests, or PUT for PUT-requests.
upload/postfield:
for HTTP POST-requests: the name of the field containing the file
upload/filename:
name of the uploaded file. if present it will be appended to url/put on uploads except for HTTP POST uploads where it overrides the filename field of the header. if not specified the value defaults to url/put is assumed to be a valid upload URL already containing the filename, except for HTTP POST-requests where the basename(3) of the local mounted configuration file is used if present, or of url/get
user:
username for authentication
password:
password for authentication
ssl/verify:
if set 1 enforce the use of SSL. HOSTNAME and PEER verifications are enabled but might be overwritten by ssl/verify/host and ssl/verify/peer.
if not set or set to 0 the plugin will try to use SSL but not fail if not possible.
ssl/verify/host:
if set to 1 use hostname verification, if set to 0, skip it.
ssl/verify/peer:
if set to 1 verify the ssl certificate, if set to 0, skip the verification.
prefer:
if set to local don't update the configuration if the remote version has changed within succeeding kdbGet() calls.
ssh/auth:
ssh authentication method for sftp and scp. possible values: agent for using ssh-agent, password for password authentication, pubkey for public key authentication and pubkeypw for public key + password authentication.
ssh/key:
path of the private key file for ssh public key authentication. if not set, default to $HOME/.ssh/id_dsa or $HOME/.ssh/id_rsa
ssh/key/passwd:
password for the private key file
1.8.13