+# In general, this sets the Connection's options to what is in the
+# task's option hash and sets the option-hash entry to the
+# Connection's old value of the option: this means that calling this
+# twice restores the state to how it was before. (That's not quite
+# true as its impossible to unset an option that was previously set:
+# such options are instead set to the empty string.)
+#
+# As a special case, options in the task's option-hash whose names
+# begin with an asterisk are taken to be persistent: they are set into
+# the Connection (with the leading asterisk removed) and deleted from
+# the task's option-hash so that they will NOT be reset the next time
+# this function is called.
+#
+sub set_options {
+ my $this = shift();
+
+ foreach my $key (sort keys %{ $this->{options} }) {
+ my $value = $this->{options}->{$key};
+ my $persistent = ($key =~ s/^\*//);
+ $value = "" if !defined $value;
+ $this->conn()->log("irspy_debug", "$this setting option '$key' -> ",
+ defined $value ? "'$value'" : "undefined");
+ my $old = $this->conn()->option($key, $value);
+ if ($persistent) {
+ delete $this->{options}->{"*$key"}
+ } else {
+ $this->{options}->{$key} = $old;
+ }
+ }
+}
+