Constructs a new configuration container object and returns
that object. $host is the host to which youre applying
this configuration; you can leave it out (pass in an
undefined or empty argument) if its not applicable to you.
$host is needed for parsing the host-specific sections
of the configuration files; the Host keyword restricts
a set of directives as applying to a particular host (or
set of hosts). When it encounters such a section,
Net::SSH::Perl::Config will skip all of the directives
in the section unless the host matches $host.
%args can contain the same arguments that you can pass
to the new method of Net::SSH::Perl--those arguments
are eventually passed through to this method when setting
up the SSH object. The elements in %args override values
in the configuration files.
Reads in the configuration file $file and adds any
appropriate configuration data to the settings maintained
by the $cfg object. If $file is unreadable, simply
As stated above, values read from the configuration files
are overridden by those passed in to the constructor.
Furthermore, if youre reading from several config files
in sequence, values read from the first files will override
those read from the second, third, fourth, etc. files.
Merges the directive option $line into the configuration
settings in $cfg. $line should be an option in the format
used in the config file, eg. BatchMode yes. This is
useful for merging in directives that are not necessarily
in the config file, similar to how the <B>-oB> option works
in the ssh command line program.
Returns the value of the configuration parameter $key,
and undefined if that parameter has not been set.
Sets the value of the parameter $key to $value, and
returns the new value.