---

   org.freedesktop.systemd1    ( 5 )

---

SCOPE UNIT OBJECTS

All scope unit objects implement the org.freedesktop.systemd1.Scope interface (described here) in addition to the generic org.freedesktop.systemd1.Unit interface (see above).

node /org/freedesktop/systemd1/unit/session_2d1_2escope { interface org.freedesktop.systemd1.Scope { methods: Abandon(); GetProcesses(out a(sus) processes); AttachProcesses(in s subcgroup, in au pids); signals: RequestStop(); properties: readonly s Controller = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly t TimeoutStopUSec = ...; readonly s Result = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly t RuntimeMaxUSec = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s Slice = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s ControlGroup = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryCurrent = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryAvailable = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t CPUUsageNSec = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly ay EffectiveMemoryNodes = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t TasksCurrent = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IPIngressBytes = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IPIngressPackets = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IPEgressBytes = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IPEgressPackets = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IOReadBytes = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IOReadOperations = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IOWriteBytes = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IOWriteOperations = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b Delegate = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly as DelegateControllers = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b CPUAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t CPUWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t StartupCPUWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t CPUShares = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t StartupCPUShares = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t CPUQuotaPerSecUSec = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t CPUQuotaPeriodUSec = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly ay AllowedCPUs = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly ay AllowedMemoryNodes = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b IOAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t IOWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t StartupIOWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IODeviceWeight = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IOReadBandwidthMax = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IOWriteBandwidthMax = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IOReadIOPSMax = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IOWriteIOPSMax = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) IODeviceLatencyTargetUSec = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b BlockIOAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t BlockIOWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t StartupBlockIOWeight = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) BlockIODeviceWeight = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) BlockIOReadBandwidth = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(st) BlockIOWriteBandwidth = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b MemoryAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t DefaultMemoryLow = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t DefaultMemoryMin = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryMin = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryLow = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryHigh = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryMax = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemorySwapMax = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t MemoryLimit = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s DevicePolicy = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(ss) DeviceAllow = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b TasksAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly t TasksMax = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly b IPAccounting = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(iayu) IPAddressAllow = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(iayu) IPAddressDeny = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly as IPIngressFilterPath = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly as IPEgressFilterPath = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly as DisableControllers = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s ManagedOOMSwap = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s ManagedOOMMemoryPressure = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly u ManagedOOMMemoryPressureLimit = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly s ManagedOOMPreference = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(ss) BPFProgram = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(iiqq) SocketBindAllow = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly a(iiqq) SocketBindDeny = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly (bas) RestrictNetworkInterfaces = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s KillMode = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly i KillSignal = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly i RestartKillSignal = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly i FinalKillSignal = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly b SendSIGKILL = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly b SendSIGHUP = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly i WatchdogSignal = ...; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; interface org.freedesktop.systemd1.Unit { ... }; };

Methods Abandon() may be used to place a scope unit in the "abandoned" state. This may be used to inform the system manager that the manager that created the scope lost interest in the scope (for example, because it is terminating), without wanting to shut down the scope entirely.

Signals RequestStop is sent to the peer that is configured in the Controller property when systemd is requested to terminate the scope unit. A program registering a scope can use this to cleanly shut down the processes it added to the scope instead of letting systemd do it with the usual SIGTERM logic.

Properties All properties correspond directly with the matching properties of service units.

Controller contains the bus name (unique or well-known) that is notified when the scope unit is to be shut down via a RequestStop signal (see below). This is set when the scope is created. If not set, the scope's processes will terminated with SIGTERM directly.