shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2024-11-06 16:59:03 +03:00
Code
976c46f84f
systemd/src/core/dbus-unit.h

143 lines
8.6 KiB
C
Raw Normal View History

emacs: disable tabs in .h files, too
2010-08-17 05:33:07 +04:00
/*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
#ifndef foodbusunithfoo
#define foodbusunithfoo
/***
This file is part of systemd.
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
2012-04-12 02:20:58 +04:00
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
2012-04-12 02:20:58 +04:00
Lesser General Public License for more details.
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
2012-04-12 02:20:58 +04:00
You should have received a copy of the GNU Lesser General Public License
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
along with systemd; If not, see <http://www.gnu.org/licenses/>.
***/
#include <dbus/dbus.h>
#include "manager.h"
dbus: more efficient implementation of properties The way the various properties[] arrays are initialized is inefficient: - only the .data members change at runtime, yet the whole arrays of properties with all the fields are constructed on the stack one by one by the code. - there's duplication, eg. the properties of "org.freedesktop.systemd1.Unit" are repeated in several unit types. Fix it by moving the information about properties into static const sections. Instead of storing the .data directly in the property, store a constant offset from a run-time base. The small arrays of struct BusBoundProperties bind together the constant information with the right runtime information (the base pointer). On my system the code shrinks by 60 KB, data increases by 10 KB.
2012-01-16 03:23:59 +04:00
#include "dbus-common.h"
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
#define BUS_UNIT_INTERFACE \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <interface name=\"org.freedesktop.systemd1.Unit\">\n" \
" <method name=\"Start\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
" <method name=\"Stop\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
systemctl: introduce try-restart and reload-or-restart commands
2010-07-13 22:20:36 +04:00
" <method name=\"Reload\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <method name=\"Restart\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
install: implement --start option
2010-07-06 07:06:40 +04:00
" <method name=\"TryRestart\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
systemctl: introduce try-restart and reload-or-restart commands
2010-07-13 22:20:36 +04:00
" <method name=\"ReloadOrRestart\">\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
" <method name=\"ReloadOrTryRestart\">\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"job\" type=\"o\" direction=\"out\"/>\n" \
" </method>\n" \
systemctl: introduce systemctl kill
2010-10-22 18:11:50 +04:00
" <method name=\"Kill\">\n" \
" <arg name=\"who\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"mode\" type=\"s\" direction=\"in\"/>\n" \
" <arg name=\"signal\" type=\"i\" direction=\"in\"/>\n" \
" </method>\n" \
" <method name=\"ResetFailed\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Id\" type=\"s\" access=\"read\"/>\n" \
" <property name=\"Names\" type=\"as\" access=\"read\"/>\n" \
device: do not merge devices Don't try to merge devices that have been created via dependencies when they appear in the system and can be recognized as the same. Instead, simply continue to maintain them independently of each other, however with the same state cycle. Why? Because otherwise we'd have a hard time to seperate the dependencies after the devices are unplugged again and we hence cannot be sure anymore that next time the device is plugged in it will carry the same names. Example: if one depndency refers to dev-sda.device and another one to dev-by-id-xxxyyy.device we only learn at time of plug in of the device that it is actually the same device that was ment. In the moment the device is unplugged again we won't know anymore their relation to each other and the next time the harddisk is plugged it might even appear as dev-by-id-xxxyyy.device and dev-sdb.service. To ensure the dependencies continue to have the meaning they were intended to have let's hence keep the .device objects seperate all the time, even when they are plugged in. This patch also introduces a new Following= property which points from the various .device units of a specific device to the main .device unit for it. This can be used by the client side to figure out the relation of the .device units to each other and even filter units from display.
2010-07-20 22:33:19 +04:00
" <property name=\"Following\" type=\"s\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Requires\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"RequiresOverridable\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"Requisite\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"RequisiteOverridable\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"Wants\" type=\"as\" access=\"read\"/>\n" \
unit: replace StopRetroactively= by BindTo= dependencies The property StopRetroactively= needs to be per-dependency, not per-unit, in order to properly express dependencies between .mount units and its .device and fsck .service units. If the .device unit is unplugged the mount should go away, but if the fsck process terminates the .mount should stay.
2010-10-29 01:18:47 +04:00
" <property name=\"BindTo\" type=\"as\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"RequiredBy\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"RequiredByOverridable\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"WantedBy\" type=\"as\" access=\"read\"/>\n" \
unit: replace StopRetroactively= by BindTo= dependencies The property StopRetroactively= needs to be per-dependency, not per-unit, in order to properly express dependencies between .mount units and its .device and fsck .service units. If the .device unit is unplugged the mount should go away, but if the fsck process terminates the .mount should stay.
2010-10-29 01:18:47 +04:00
" <property name=\"BoundBy\" type=\"as\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Conflicts\" type=\"as\" access=\"read\"/>\n" \
manager: when two pending jobs conflict, keep the one that "conflicts", remove the one that is "conflicted" This gives the writer of units control which unit is kept and which is stopped when two units conflict.
2010-08-10 00:32:30 +04:00
" <property name=\"ConflictedBy\" type=\"as\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Before\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"After\" type=\"as\" access=\"read\"/>\n" \
unit: introduce OnFailure dependencies to activate units on failure of other units, as a way to implement an automatic rescue shell
2010-07-17 02:58:47 +04:00
" <property name=\"OnFailure\" type=\"as\" access=\"read\"/>\n" \
unit: implement new PropagateReloadTo=/PropagateReloadFrom= operations
2012-01-11 05:47:14 +04:00
" <property name=\"Triggers\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"TriggeredBy\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"PropagateReloadTo\" type=\"as\" access=\"read\"/>\n" \
" <property name=\"PropagateReloadFrom\" type=\"as\" access=\"read\"/>\n" \
unit: add new dependency type RequiresMountsFor= RequiresMountsFor= is a shortcut for adding requires and after dependencies to all mount units neeed for the specified paths. This solves a couple of issues regarding dep loop cycles for encrypted swap.
2012-04-29 16:26:07 +04:00
" <property name=\"RequiresMountsFor\" type=\"as\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Description\" type=\"s\" access=\"read\"/>\n" \
units: remove service sysv_path variable and replace it by generic unit_path UnitPath= is also writable via native units and may be used by generators to clarify from which file a unit is generated. This patch also hooks up the cryptsetup and fstab generators to set UnitPath= accordingly.
2012-05-23 01:08:24 +04:00
" <property name=\"SourcePath\" type=\"s\" access=\"read\"/>\n" \
units: introduce new Documentation= field and make use of it everywhere This should help making the boot process a bit easier to explore and understand for the administrator. The simple idea is that "systemctl status" now shows a link to documentation alongside the other status and decriptionary information of a service. This patch adds the necessary fields to all our shipped units if we have proper documentation for them.
2012-05-21 17:12:18 +04:00
" <property name=\"Documentation\" type=\"as\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"LoadState\" type=\"s\" access=\"read\"/>\n" \
" <property name=\"ActiveState\" type=\"s\" access=\"read\"/>\n" \
" <property name=\"SubState\" type=\"s\" access=\"read\"/>\n" \
" <property name=\"FragmentPath\" type=\"s\" access=\"read\"/>\n" \
dbus: export unit file state
2011-07-31 20:28:02 +04:00
" <property name=\"UnitFileState\" type=\"s\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"InactiveExitTimestamp\" type=\"t\" access=\"read\"/>\n" \
dbus: expose monotonic timestamps on the bus
2011-04-07 23:35:37 +04:00
" <property name=\"InactiveExitTimestampMonotonic\" type=\"t\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"ActiveEnterTimestamp\" type=\"t\" access=\"read\"/>\n" \
dbus: expose monotonic timestamps on the bus
2011-04-07 23:35:37 +04:00
" <property name=\"ActiveEnterTimestampMonotonic\" type=\"t\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"ActiveExitTimestamp\" type=\"t\" access=\"read\"/>\n" \
dbus: expose monotonic timestamps on the bus
2011-04-07 23:35:37 +04:00
" <property name=\"ActiveExitTimestampMonotonic\" type=\"t\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"InactiveEnterTimestamp\" type=\"t\" access=\"read\"/>\n" \
dbus: expose monotonic timestamps on the bus
2011-04-07 23:35:37 +04:00
" <property name=\"InactiveEnterTimestampMonotonic\" type=\"t\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"CanStart\" type=\"b\" access=\"read\"/>\n" \
unit: rename OnlyByDependency= to RefuseManualStart= and introduce RefuseManualStop= Some unit shall never be start on user request (e.g. shutdown.target) others never be stopped on user request (e.g. auditd.servce), hence offer options for both.
2010-08-10 22:57:21 +04:00
" <property name=\"CanStop\" type=\"b\" access=\"read\"/>\n" \
manager: introduce IgnoreOnIsolate flag so that we can keep systemd-logger around when isolating
2011-04-14 05:55:03 +04:00
" <property name=\"CanReload\" type=\"b\" access=\"read\"/>\n" \
unit: introduce AllowIsolate= switch
2010-08-31 00:45:46 +04:00
" <property name=\"CanIsolate\" type=\"b\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"Job\" type=\"(uo)\" access=\"read\"/>\n" \
fix spelling of 'unneeded' at various places
2010-09-28 01:27:21 +04:00
" <property name=\"StopWhenUnneeded\" type=\"b\" access=\"read\"/>\n" \
unit: rename OnlyByDependency= to RefuseManualStart= and introduce RefuseManualStop= Some unit shall never be start on user request (e.g. shutdown.target) others never be stopped on user request (e.g. auditd.servce), hence offer options for both.
2010-08-10 22:57:21 +04:00
" <property name=\"RefuseManualStart\" type=\"b\" access=\"read\"/>\n" \
" <property name=\"RefuseManualStop\" type=\"b\" access=\"read\"/>\n" \
manager: introduce IgnoreOnIsolate flag so that we can keep systemd-logger around when isolating
2011-04-14 05:55:03 +04:00
" <property name=\"AllowIsolate\" type=\"b\" access=\"read\"/>\n" \
dbus: complete coverage for unit interface
2010-07-04 06:24:07 +04:00
" <property name=\"DefaultDependencies\" type=\"b\" access=\"read\"/>\n" \
manager: introduce IgnoreOnIsolate flag so that we can keep systemd-logger around when isolating
2011-04-14 05:55:03 +04:00
" <property name=\"OnFailureIsolate\" type=\"b\" access=\"read\"/>\n" \
" <property name=\"IgnoreOnIsolate\" type=\"b\" access=\"read\"/>\n" \
unit: make ignoring in snapshots a per unit property, instead of a per unit type property
2011-05-05 12:58:55 +04:00
" <property name=\"IgnoreOnSnapshot\" type=\"b\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" <property name=\"DefaultControlGroup\" type=\"s\" access=\"read\"/>\n" \
dbus: use ControlGroup as property name to match config option
2011-02-08 13:13:32 +03:00
" <property name=\"ControlGroup\" type=\"as\" access=\"read\"/>\n" \
cgroup: expose cgroup attributes as unit properties on the bus
2011-08-20 02:42:50 +04:00
" <property name=\"ControlGroupAttributes\" type=\"a(sss)\" access=\"read\"/>\n" \
systemctl: warn when operating on service files that changed on disk but haven't been reloaded
2010-07-17 02:57:51 +04:00
" <property name=\"NeedDaemonReload\" type=\"b\" access=\"read\"/>\n" \
job: timeout every job independently of the unit
2010-07-17 06:09:28 +04:00
" <property name=\"JobTimeoutUSec\" type=\"t\" access=\"read\"/>\n" \
condition: take a timestamp and store last result of conditions
2011-03-10 01:58:17 +03:00
" <property name=\"ConditionTimestamp\" type=\"t\" access=\"read\"/>\n" \
dbus: expose monotonic timestamps on the bus
2011-04-07 23:35:37 +04:00
" <property name=\"ConditionTimestampMonotonic\" type=\"t\" access=\"read\"/>\n" \
condition: take a timestamp and store last result of conditions
2011-03-10 01:58:17 +03:00
" <property name=\"ConditionResult\" type=\"b\" access=\"read\"/>\n" \
dbus: export load error on unit objects
2011-07-31 20:13:03 +04:00
" <property name=\"LoadError\" type=\"(ss)\" access=\"read\"/>\n" \
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
" </interface>\n"
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
dbus: properly generate UnknownInterface, UnknownProperty and PropertyReadOnly errors
2011-03-09 22:01:53 +03:00
#define BUS_UNIT_INTERFACES_LIST \
BUS_GENERIC_INTERFACES_LIST \
"org.freedesktop.systemd1.Unit\0"
dbus: more efficient implementation of properties The way the various properties[] arrays are initialized is inefficient: - only the .data members change at runtime, yet the whole arrays of properties with all the fields are constructed on the stack one by one by the code. - there's duplication, eg. the properties of "org.freedesktop.systemd1.Unit" are repeated in several unit types. Fix it by moving the information about properties into static const sections. Instead of storing the .data directly in the property, store a constant offset from a run-time base. The small arrays of struct BusBoundProperties bind together the constant information with the right runtime information (the base pointer). On my system the code shrinks by 60 KB, data increases by 10 KB.
2012-01-16 03:23:59 +04:00
extern const BusProperty bus_unit_properties[];
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
void bus_unit_send_change_signal(Unit *u);
void bus_unit_send_removed_signal(Unit *u);
extern const DBusObjectPathVTable bus_unit_vtable;
dbus: automatically generate and install introspection files
2010-05-23 05:45:33 +04:00
extern const char bus_unit_interface[];
dbus: greatly extend dbus coverage
2010-04-18 05:08:16 +04:00
#endif
Copy Permalink