Source code for systemd.daemon

from socket import AF_UNSPEC as _AF_UNSPEC

from ._daemon import (__version__,
                      booted,
                      notify,
                      _listen_fds,
                      _listen_fds_with_names,
                      _is_fifo,
                      _is_socket,
                      _is_socket_inet,
                      _is_socket_sockaddr,
                      _is_socket_unix,
                      _is_mq,
                      LISTEN_FDS_START)

def _convert_fileobj(fileobj):
    try:
        return fileobj.fileno()
    except AttributeError:
        return fileobj

[docs]def is_fifo(fileobj, path=None): fd = _convert_fileobj(fileobj) return _is_fifo(fd, path)
[docs]def is_socket(fileobj, family=_AF_UNSPEC, type=0, listening=-1): fd = _convert_fileobj(fileobj) return _is_socket(fd, family, type, listening)
[docs]def is_socket_inet(fileobj, family=_AF_UNSPEC, type=0, listening=-1, port=0): fd = _convert_fileobj(fileobj) return _is_socket_inet(fd, family, type, listening, port)
[docs]def is_socket_sockaddr(fileobj, address, type=0, flowinfo=0, listening=-1): """Check socket type, address and/or port, flowinfo, listening state. Wraps sd_is_socket_inet_sockaddr(3). `address` is a systemd-style numerical IPv4 or IPv6 address as used in ListenStream=. A port may be included after a colon (":"). See systemd.socket(5) for details. Constants for `family` are defined in the socket module. """ fd = _convert_fileobj(fileobj) return _is_socket_sockaddr(fd, address, type, flowinfo, listening)
[docs]def is_socket_unix(fileobj, type=0, listening=-1, path=None): fd = _convert_fileobj(fileobj) return _is_socket_unix(fd, type, listening, path)
[docs]def is_mq(fileobj, path=None): fd = _convert_fileobj(fileobj) return _is_mq(fd, path)
[docs]def listen_fds(unset_environment=True): """Return a list of socket activated descriptors Example:: (in primary window) $ systemd-socket-activate -l 2000 python3 -c \\ 'from systemd.daemon import listen_fds; print(listen_fds())' (in another window) $ telnet localhost 2000 (in primary window) ... Execing python3 (...) [3] """ num = _listen_fds(unset_environment) return list(range(LISTEN_FDS_START, LISTEN_FDS_START + num))
[docs]def listen_fds_with_names(unset_environment=True): """Return a dictionary of socket activated descriptors as {fd: name} Example:: (in primary window) $ systemd-socket-activate -l 2000 -l 4000 --fdname=2K:4K python3 -c \\ 'from systemd.daemon import listen_fds_with_names; print(listen_fds_with_names())' (in another window) $ telnet localhost 2000 (in primary window) ... Execing python3 (...) [3] """ composite = _listen_fds_with_names(unset_environment) retval = {} for i in range(0, composite[0]): retval[i+LISTEN_FDS_START] = composite[1+i] return retval