[thirdparty/systemd.git] / src / python-systemd / docs / login.rst

`systemd.login` module
=======================

.. automodule:: systemd.login
   :members:

.. autoclass:: Monitor
   :undoc-members:
   :inherited-members:

Example: polling for events
~~~~~~~~~~~~~~~~~~~~~~~~~~~

This example shows that session/uid/seat/machine events can be waited
for (using e.g. `poll`). This makes it easy to integrate Monitor in an
external event loop:

  >>> import select
  >>> from systemd import login
  >>> m = login.Monitor("machine")
  >>> p = select.poll()
  >>> p.register(m, m.get_events())
  >>> login.machine_names()
  []
  >>> p.poll()
  [(3, 1)]
  >>> login.machine_names()
  ['fedora-19.nspawn']
Commit	Line	Data
539e0a4d ZJS	1	`systemd.login` module
	2	=======================
	3
	4	.. automodule:: systemd.login
	5	:members:
7ecec470 ZJS	6
	7	.. autoclass:: Monitor
	8	:undoc-members:
	9	:inherited-members:
	10
	11	Example: polling for events
	12	~~~~~~~~~~~~~~~~~~~~~~~~~~~
	13
	14	This example shows that session/uid/seat/machine events can be waited
	15	for (using e.g. `poll`). This makes it easy to integrate Monitor in an
	16	external event loop:
	17
	18	>>> import select
	19	>>> from systemd import login
	20	>>> m = login.Monitor("machine")
	21	>>> p = select.poll()
	22	>>> p.register(m, m.get_events())
	23	>>> login.machine_names()
	24	[]
	25	>>> p.poll()
	26	[(3, 1)]
	27	>>> login.machine_names()
	28	['fedora-19.nspawn']