411
424
.format(self.name)))
427
def call_pipe(connection, # : multiprocessing.Connection
428
func, *args, **kwargs):
429
"""This function is meant to be called by multiprocessing.Process
431
This function runs func(*args, **kwargs), and writes the resulting
432
return value on the provided multiprocessing.Connection.
434
connection.send(func(*args, **kwargs))
415
437
class Client(object):
416
438
"""A representation of a client host served by this server.
443
465
last_checker_status: integer between 0 and 255 reflecting exit
444
466
status of last checker. -1 reflects crashed
445
467
checker, -2 means no checker completed yet.
468
last_checker_signal: The signal which killed the last checker, if
469
last_checker_status is -1
446
470
last_enabled: datetime.datetime(); (UTC) or None
447
471
name: string; from the config file, used in log messages and
448
472
D-Bus identifiers
622
646
# Also start a new checker *right now*.
623
647
self.start_checker()
625
def checker_callback(self, pid, condition, command):
649
def checker_callback(self, source, condition, connection,
626
651
"""The checker has completed, so take appropriate actions."""
627
652
self.checker_callback_tag = None
628
653
self.checker = None
629
if os.WIFEXITED(condition):
630
self.last_checker_status = os.WEXITSTATUS(condition)
654
# Read return code from connection (see call_pipe)
655
returncode = connection.recv()
659
self.last_checker_status = returncode
660
self.last_checker_signal = None
631
661
if self.last_checker_status == 0:
632
662
logger.info("Checker for %(name)s succeeded",
636
666
logger.info("Checker for %(name)s failed", vars(self))
638
668
self.last_checker_status = -1
669
self.last_checker_signal = -returncode
639
670
logger.warning("Checker for %(name)s crashed?",
642
674
def checked_ok(self):
643
675
"""Assert that the client has been seen, alive and well."""
644
676
self.last_checked_ok = datetime.datetime.utcnow()
645
677
self.last_checker_status = 0
678
self.last_checker_signal = None
646
679
self.bump_timeout()
648
681
def bump_timeout(self, timeout=None):
674
707
# than 'timeout' for the client to be disabled, which is as it
677
# If a checker exists, make sure it is not a zombie
679
pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
680
except AttributeError:
682
except OSError as error:
683
if error.errno != errno.ECHILD:
687
logger.warning("Checker was a zombie")
688
gobject.source_remove(self.checker_callback_tag)
689
self.checker_callback(pid, status,
690
self.current_checker_command)
710
if self.checker is not None and not self.checker.is_alive():
711
logger.warning("Checker was not alive; joining")
691
714
# Start a new checker if needed
692
715
if self.checker is None:
693
716
# Escape attributes for the shell
703
726
return True # Try again later
704
727
self.current_checker_command = command
706
logger.info("Starting checker %r for %s", command,
708
# We don't need to redirect stdout and stderr, since
709
# in normal mode, that is already done by daemon(),
710
# and in debug mode we don't want to. (Stdin is
711
# always replaced by /dev/null.)
712
# The exception is when not debugging but nevertheless
713
# running in the foreground; use the previously
716
if (not self.server_settings["debug"]
717
and self.server_settings["foreground"]):
718
popen_args.update({"stdout": wnull,
720
self.checker = subprocess.Popen(command,
725
except OSError as error:
726
logger.error("Failed to start subprocess",
729
self.checker_callback_tag = gobject.child_watch_add(
730
self.checker.pid, self.checker_callback, data=command)
731
# The checker may have completed before the gobject
732
# watch was added. Check for this.
734
pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
735
except OSError as error:
736
if error.errno == errno.ECHILD:
737
# This should never happen
738
logger.error("Child process vanished",
743
gobject.source_remove(self.checker_callback_tag)
744
self.checker_callback(pid, status, command)
728
logger.info("Starting checker %r for %s", command,
730
# We don't need to redirect stdout and stderr, since
731
# in normal mode, that is already done by daemon(),
732
# and in debug mode we don't want to. (Stdin is
733
# always replaced by /dev/null.)
734
# The exception is when not debugging but nevertheless
735
# running in the foreground; use the previously
737
popen_args = { "close_fds": True,
740
if (not self.server_settings["debug"]
741
and self.server_settings["foreground"]):
742
popen_args.update({"stdout": wnull,
744
pipe = multiprocessing.Pipe(duplex = False)
745
self.checker = multiprocessing.Process(
747
args = (pipe[1], subprocess.call, command),
750
self.checker_callback_tag = gobject.io_add_watch(
751
pipe[0].fileno(), gobject.IO_IN,
752
self.checker_callback, pipe[0], command)
745
753
# Re-run this periodically if run by gobject.timeout_add
1098
1099
interface_names.add(alt_interface)
1099
1100
# Is this a D-Bus signal?
1100
1101
if getattr(attribute, "_dbus_is_signal", False):
1101
# Extract the original non-method undecorated
1102
# function by black magic
1103
nonmethod_func = (dict(
1104
zip(attribute.func_code.co_freevars,
1105
attribute.__closure__))
1106
["func"].cell_contents)
1102
if sys.version_info.major == 2:
1103
# Extract the original non-method undecorated
1104
# function by black magic
1105
nonmethod_func = (dict(
1106
zip(attribute.func_code.co_freevars,
1107
attribute.__closure__))
1108
["func"].cell_contents)
1110
nonmethod_func = attribute
1107
1111
# Create a new, but exactly alike, function
1108
1112
# object, and decorate it to be a new D-Bus signal
1109
1113
# with the alternate D-Bus interface name
1114
if sys.version_info.major == 2:
1115
new_function = types.FunctionType(
1116
nonmethod_func.func_code,
1117
nonmethod_func.func_globals,
1118
nonmethod_func.func_name,
1119
nonmethod_func.func_defaults,
1120
nonmethod_func.func_closure)
1122
new_function = types.FunctionType(
1123
nonmethod_func.__code__,
1124
nonmethod_func.__globals__,
1125
nonmethod_func.__name__,
1126
nonmethod_func.__defaults__,
1127
nonmethod_func.__closure__)
1110
1128
new_function = (dbus.service.signal(
1111
alt_interface, attribute._dbus_signature)
1112
(types.FunctionType(
1113
nonmethod_func.func_code,
1114
nonmethod_func.func_globals,
1115
nonmethod_func.func_name,
1116
nonmethod_func.func_defaults,
1117
nonmethod_func.func_closure)))
1130
attribute._dbus_signature)(new_function))
1118
1131
# Copy annotations, if any
1120
1133
new_function._dbus_annotations = dict(
1343
1356
DBusObjectWithProperties.__del__(self, *args, **kwargs)
1344
1357
Client.__del__(self, *args, **kwargs)
1346
def checker_callback(self, pid, condition, command,
1348
self.checker_callback_tag = None
1350
if os.WIFEXITED(condition):
1351
exitstatus = os.WEXITSTATUS(condition)
1359
def checker_callback(self, source, condition,
1360
connection, command, *args, **kwargs):
1361
ret = Client.checker_callback(self, source, condition,
1362
connection, command, *args,
1364
exitstatus = self.last_checker_status
1352
1366
# Emit D-Bus signal
1353
1367
self.CheckerCompleted(dbus.Int16(exitstatus),
1354
dbus.Int64(condition),
1355
1369
dbus.String(command))
1357
1371
# Emit D-Bus signal
1358
1372
self.CheckerCompleted(dbus.Int16(-1),
1359
dbus.Int64(condition),
1374
self.last_checker_signal),
1360
1375
dbus.String(command))
1362
return Client.checker_callback(self, pid, condition, command,
1365
1378
def start_checker(self, *args, **kwargs):
1366
1379
old_checker_pid = getattr(self.checker, "pid", None)
2169
2183
# avoid excessive use of external libraries.
2171
2185
# New type for defining tokens, syntax, and semantics all-in-one
2172
Token = collections.namedtuple("Token",
2173
("regexp", # To match token; if
2174
# "value" is not None,
2175
# must have a "group"
2177
"value", # datetime.timedelta or
2179
"followers")) # Tokens valid after
2181
2186
Token = collections.namedtuple("Token", (
2182
2187
"regexp", # To match token; if "value" is not None, must have
2183
2188
# a "group" containing digits