]> git.ipfire.org Git - thirdparty/systemd.git/blob - TODO
mount-util: show mount source in failure log message (#10312)
[thirdparty/systemd.git] / TODO
1 Bugfixes:
2
3 * copy.c: set the right chattrs before copying files and others after
4
5 External:
6
7 * Fedora: add an rpmlint check that verifies that all unit files in the RPM are listed in %systemd_post macros.
8
9 * wiki: update journal format documentation for lz4 additions
10
11 Janitorial Clean-ups:
12
13 * Rearrange tests so that the various test-xyz.c match a specific src/basic/xyz.c again
14
15 * rework mount.c and swap.c to follow proper state enumeration/deserialization
16 semantics, like we do for device.c now
17
18 Before v240:
19
20 * move portablectl into /usr/bin
21
22 * portables: introduce a new unit file directory /etc/systemd/system.attached/
23 or so, where we attach portable services to
24
25 Features:
26
27 * consider splitting out all temporary file creation APIs (we have so many in
28 fileio.h and elsewhere!) into a new util file of its own.
29
30 * set memory.oom.group in cgroupsv2 for all leaf cgroups
31
32 * whenever oom_kill memory.event event is triggered print a nice log message
33
34 * Move RestrictAddressFamily= to the new cgroup create socket
35
36 * support the bind/connect/sendmsg cgroup stuff for sandboxing, and possibly
37 patching around
38
39 * chown() tty a service is attached to after the service goes down
40
41 * optionally, if a per-partition GPT flag is set for the root/home/… partitions
42 format the partition on next boot and unset the flag, in order to implement
43 factory reset. also, add a second flag that simply indicates whether such a
44 scheme is supported. then, add a tool (or maybe beef up systemd-dissect) to
45 show state of these flags, and optionally trigger such a factory reset on
46 next boot by setting the flag.
47
48 * logind: maybe watch utmp asynchronously using inotify, and populate our own
49 tracked session metadata from the fields available therein. Why bother? Right
50 now, all "ssh" sessions will be tracked without their TTY by logind (which is
51 not just unfriendly to users as this means "loginctl session-status" shows
52 less information than "who" in many cases, but also breaks the IdleAction
53 logic, as we never can detect such sessions as idle, as we have no TTY to
54 watch). ssh sets the PAM_TTY field on its PAM sessions to "ssh" rather than
55 the actual pty, because the PAM session is opened early on for new
56 connections, but the PTY only registered much later (if at all). ssh writes
57 the utmp record only after a TTY is actually registered, hence we could use
58 this data then, and use it if it is available. Using utmp for this is ugly of
59 course, and watching things asynchronously even more so, but it should be
60 good enough for the idle detection logic at least.
61
62 * maybe extend .path units to expose fanotify() per-mount change events
63
64 * Add a "systemctl list-units --by-slice" mode or so, which rearranges the
65 output of "systemctl list-units" slightly by showing the tree structure of
66 the slices, and the units attached to them.
67
68 * the a-posteriori stopping of units bound to units that disappeared logic
69 should be reworked: there should be a queue of units, and we should only
70 enqeue stop jobs from a defer event that processes queue instead of
71 right-away when we find a unit that is bound to one that doesn't exist
72 anymore. (similar to how the stop-unneeded queue has been reworked the same
73 way)
74
75 * nspawn: make nspawn suitable for shell pipelines: instead of triggering a
76 hangup when input is finished, send ^D, which synthesizes an EOF. Then wait
77 for hangup or ^D before passing on the EOF.
78
79 * When reloading configuration PID 1 should reset all its properties to the
80 original defaults before calling parse_config()
81
82 * Add OnTimezoneChange= and OnTimeChange= stanzas to .timer units in order to
83 schedule events based on time and timezone changes.
84
85 * nspawn: greater control over selinux label?
86
87 * cgroups: figure out if we can somehow communicate in a cleaner way whether a
88 systemd instance not running in the cgroup root shall or shall not manage the
89 attributes of its top-level cgroup. Currently it assumes it manages all, but
90 then might get EPERM due to permission porblems/userns, which is OK, but this
91 should be revisited to make clearer and also work if the payload systemd runs
92 with full privs and without userns.
93
94 * hibernate/s2h: make this robust and safe to enable in Fedora by default.
95 Specifically:
96
97 1. add resume_offset support to the resume code (i.e. support swap files
98 properly)
99 2. check of swap is on weird storage and refuse if so
100 3. add env-var based option to disable hibernation
101 4. figure out what to do with swap-on-luks
102 5. add autodetection of hibernation images, and add "noresume" to disable
103 this
104
105 * cgroups: use inotify to get notified when somebody else modifies cgroups
106 owned by us, then log a friendly warning.
107
108 * beef up log.c with support for stripping ANSI sequences from strings, so that
109 it is OK to include them in log strings. This would be particularly useful so
110 that our log messages could contain clickable links for example for unit
111 files and suchlike we operate on.
112
113 * add support for "portablectl attach http://foobar.com/waaa.raw (i.e. importd integration)
114
115 * add attach --enable and attach --now (for attach+enable+start)
116
117 * sync dynamic uids/gids between host+portable srvice (i.e. if DynamicUser=1 is set for a service, make sure that the
118 selected user is resolvable in the service even if it ships its own /etc/passwd)
119
120 * Fix DECIMAL_STR_MAX or DECIMAL_STR_WIDTH. One includes a trailing NUL, the
121 other doesn't. What a desaster. Probably to exclude it. Also
122 DECIMAL_STR_WIDTH should probably add an extra "-" into account for negative
123 numbers.
124
125 * Check that users of inotify's IN_DELETE_SELF flag are using it properly, as
126 usually IN_ATTRIB is the right way to watch deleted files, as the former only
127 fires when a file is actually removed from disk, i.e. the link count drops to
128 zero and is not open anymore, while the latter happens when a file is
129 unlinked from any dir.
130
131 * port systemctl, busctl, … over to format-table.[ch]'s table formatters
132
133 * pid1: lock image configured with RootDirectory=/RootImage= using the usual nspawn semantics while the unit is up
134
135 * add --vacuum-xyz options to coredumpctl, matching those journalctl already has.
136
137 * SuccessExitStatus= and friends should probably also accept symbolic exit
138 codes names, i.e. error codes from the list maintained in exit-codes.[ch]
139
140 * introduce Ephemeral= unit file switch, that creates an ephemeral copy of all
141 files and directories that are left writable for a unit, and which are
142 removed after the unit goes down again. A bit like --ephemeral for
143 systemd-nspawn but for system services. If used together with RootImage= this
144 should reflink the image file itself.
145
146 Related: add Ephemeral=<path1> <path2> … which would allow marking
147 specific paths only like this.
148
149 * add CopyFile= or so as unit file setting that may be used to copy files or
150 directory trees from the host to te services RootImage= and RootDirectory=
151 environment. Which we can use for /etc/machine-id and in particular
152 /etc/resolv.conf. Should be smart and do something useful on read-only
153 images, for example fallback to read-only bind mounting the file instead.
154
155 * nspawn's console TTY should be allocated from within the container, not
156 mounted in from the outside
157
158 * show invocation ID in systemd-run output
159
160 * bypass SIGTERM state in unit files if KillSignal is SIGKILL
161
162 * tree-wide: ensure we always block the signals we hook into with
163 sd_event_add_signal() first
164
165 * add proper dbus APIs for the various sd_notify() commands, such as MAINPID=1
166 and so on, which would mean we could report errors and such.
167
168 * teach tmpfiles.d q/Q logic something sensible in the context of XFS/ext4
169 project quota
170
171 * introduce DefaultSlice= or so in system.conf that allows changing where we
172 place our units by default, i.e. change system.slice to something
173 else. Similar, ManagerSlice= should exist so that PID1's own scope unit could
174 be moved somewhere else too. Finally machined and logind should get similar
175 options so that it is possible to move user session scopes and machines to a
176 different slice too by default. Usecase: people who want to put resources on
177 the entire system, with the exception of one specific service. See:
178 https://lists.freedesktop.org/archives/systemd-devel/2018-February/040369.html
179
180 * maybe rework get_user_creds() to query the user database if $SHELL is used
181 for root, but only then.
182
183 * be stricter with fds we receive for the fdstore: close them asynchronously
184
185 * calenderspec: add support for week numbers and day numbers within a
186 year. This would allow us to define "bi-weekly" triggers safely.
187
188 * add bpf-based implementation of devices cgroup controller logic for compat
189 with cgroupsv2 as supported by newest kernel
190
191 * sd-bus: add vtable flag, that may be used to request client creds implicitly
192 and asynchronously before dispatching the operation
193
194 * make use of ethtool veth peer info in machined, for automatically finding out
195 host-side interface pointing to the container.
196
197 * add some special mode to LogsDirectory=/StateDirectory=… that allows
198 declaring these directories without necessarily pulling in deps for them, or
199 creating them when starting up. That way, we could declare that
200 systemd-journald writes to /var/log/journal, which could be useful when we
201 doing disk usage calculations and so on.
202
203 * taint systemd if there are fewer than 65536 users assigned (userns) to the system.
204
205 * deprecate PermissionsStartOnly= and RootDirectoryStartOnly= in favour of the ExecStart= prefix chars
206
207 * add a new RuntimeDirectoryPreserve= mode that defines a similar lifecycle for
208 the runtime dir as we maintain for the fdstore: i.e. keep it around as long
209 as the unit is running or has a job queued.
210
211 * support projid-based quota in machinectl for containers, and then drop
212 implicit btrfs loopback magic in machined
213
214 * Add NetworkNamespacePath= to specify a path to a network namespace
215
216 * maybe use SOURCE_DATE_EPOCH (i.e. the env var the reproducible builds folks
217 introduced) as the RTC epoch, instead of the mtime of NEWS.
218
219 * add a way to lock down cgroup migration: a boolean, which when set for a unit
220 makes sure the processes in it can never migrate out of it
221
222 * blog about fd store and restartable services
223
224 * document Environment=SYSTEMD_LOG_LEVEL=debug drop-in in debugging document
225
226 * rework ExecOutput and ExecInput enums so that EXEC_OUTPUT_NULL loses its
227 magic meaning and is no longer upgraded to something else if set explicitly.
228
229 * in the long run: permit a system with /etc/machine-id linked to /dev/null, to
230 make it lose its identity, i.e. be anonymous. For this we'd have to patch
231 through the whole tree to make all code deal with the case where no machine
232 ID is available.
233
234 * optionally, collect cgroup resource data, and store it in per-unit RRD files,
235 suitable for processing with rrdtool. Add bus API to access this data, and
236 possibly implement a CPULoad property based on it.
237
238 * beef up pam_systemd to take unit file settings such as cgroups properties as
239 parameters
240
241 * a new "systemd-analyze security" tool outputting a checklist of security
242 features a service does and does not implement
243
244 * maybe hook of xfs/ext4 quotactl() with services? i.e. automatically manage
245 the quota of a the user indicated in User= via unit file settings, like the
246 other resource management concepts. Would mix nicely with DynamicUser=1. Or
247 alternatively, do this with projids, so that we can also cover services
248 running as root. Quota should probably cover all the special dirs such as
249 StateDirectory=, LogsDirectory=, CacheDirectory=, as well as RootDirectory= if it
250 is set, plus the whole disk space any image configured with RootImage=.
251
252 * Introduce "exit" as an EmergencyAction value, and allow to configure a
253 per-unit success/failure exit code to configure. This would be useful for
254 running commands inside of services inside of containers, which could then
255 propagate their failure state all the way up.
256
257 * In DynamicUser= mode: before selecting a UID, use disk quota APIs on relevant
258 disks to see if the UID is already in use.
259
260 * add "systemctl wait" or so, which does what "systemd-run --wait" does, but
261 for all units. It should be both a way to pin units into memory as well as a
262 wait to retrieve their exit data.
263
264 * expose IO accounting data on the bus, show it in systemd-run --wait and log
265 about it in the resource log message
266
267 * add "systemctl purge" for flushing out configuration, state, logs, ... of a
268 unit when it is stopped
269
270 * show whether a service has out-of-date configuration in "systemctl status" by
271 using mtime data of ConfigurationDirectory=.
272
273 * replace all uses of fgets() + LINE_MAX by read_line()
274
275 * Add AddUser= setting to unit files, similar to DynamicUser=1 which however
276 creates a static, persistent user rather than a dynamic, transient user. We
277 can leverage code from sysusers.d for this.
278
279 * add some optional flag to ReadWritePaths= and friends, that has the effect
280 that we create the dir in question when the service is started. Example:
281
282 ReadWritePaths=:/var/lib/foobar
283
284 * maybe add call sd_journal_set_block_timeout() or so to set SO_SNDTIMEO for
285 the sd-journal logging socket, and, if the timeout is set to 0, sets
286 O_NONBLOCK on it. That way people can control if and when to block for
287 logging.
288
289 * hostnamed: populate form factor data from a new hwdb database, so that old
290 yogas can be recognized as "convertible" too, even if they predate the DMI
291 "convertible" form factor
292
293 * Maybe add a small tool invoked early at boot, that adds in or resizes
294 partitions automatically, to be used when the media used is actually larger
295 than the image written onto it is.
296
297 * Maybe add PrivatePIDs= as new unit setting, and do minimal PID namespacing
298 after all. Be strict however, only support the equivalent of nspawn's
299 --as-pid2 switch, and sanely proxy sd_notify() messages dropping stuff such
300 as MAINPID.
301
302 * Add ExecMonitor= setting. May be used multiple times. Forks off a process in
303 the service cgroup, which is supposed to monitor the service, and when it
304 exits the service is considered failed by its monitor.
305
306 * track the per-service PAM process properly (i.e. as an additional control
307 process), so that it may be queried on the bus and everything.
308
309 * add a new "debug" job mode, that is propagated to unit_start() and for
310 services results in two things: we raise SIGSTOP right before invoking
311 execve() and turn off watchdog support. Then, use that to implement
312 "systemd-gdb" for attaching to the start-up of any system service in its
313 natural habitat.
314
315 * maybe introduce gpt auto discovery for /var/tmp?
316
317 * maybe add gpt-partition-based user management: each user gets his own
318 LUKS-encrypted GPT partition with a new GPT type. A small nss module
319 enumerates users via udev partition enumeration. UIDs are assigned in a fixed
320 way: the partition index is added as offset to some fixed base uid. User name
321 is stored in GPT partition name. A PAM module authenticates the user via the
322 LUKS partition password. Benefits: strong per-user security, compatibility
323 with stateless/read-only/verity-enabled root. (other idea: do this based on
324 loopback files in /home, without GPT involvement)
325
326 * gpt-auto logic: introduce support for discovering /var matching an image. For
327 that, use a partition type UUID that is hashed from the OS name (as encoded
328 in /etc/os-release), the architecture, and 4 new bits from the gpt flags
329 field of the root partition. This way can easily support multiple OS
330 installations on the same GPT partition table, without problems with
331 unmatched /var partitions.
332
333 * gpt-auto logic: related to the above, maybe support a "secondary" root
334 partition, that is mounted to / and is writable, and where the actual root's
335 /usr is mounted into.
336
337 * gpt-auto logic: support encrypted swap, add kernel cmdline option to force it, and honour a gpt bit about it, plus maybe a configuration file
338
339 * drop nss-myhostname in favour of nss-resolve?
340
341 * add a percentage syntax for TimeoutStopSec=, e.g. TimeoutStopSec=150%, and
342 then use that for the setting used in user@.service. It should be understood
343 relative to the configured default value.
344
345 * in networkd, when matching device types, fix up DEVTYPE rubbish the kernel passes to us
346
347 * enable LockMLOCK to take a percentage value relative to physical memory
348
349 * Permit masking specific netlink APIs with RestrictAddressFamily=
350
351 * nspawn: support that /proc, /sys/, /dev are pre-mounted
352
353 * define gpt header bits to select volatility mode
354
355 * ProtectKernelLogs= (drops CAP_SYSLOG, add seccomp for syslog() syscall, and DeviceAllow to /dev/kmsg) in service files
356
357 * ProtectClock= (drops CAP_SYS_TIMES, adds seecomp filters for settimeofday, adjtimex), sets DeviceAllow o /dev/rtc
358
359 * ProtectTracing= (drops CAP_SYS_PTRACE, blocks ptrace syscall, makes /sys/kernel/tracing go away)
360
361 * ProtectMount= (drop mount/umount/pivot_root from seccomp, disallow fuse via DeviceAllow, imply Mountflags=slave)
362
363 * ProtectKeyRing= to take keyring calls away
364
365 * RemoveKeyRing= to remove all keyring entries of the specified user
366
367 * ProtectReboot= that masks reboot() and kexec_load() syscalls, prohibits kill
368 on PID 1 with the relevant signals, and makes relevant files in /sys and
369 /proc (such as the sysrq stuff) unavailable
370
371 * DeviceAllow= should also generate seccomp filters for mknod()
372
373 * make sure the ratelimit object can deal with USEC_INFINITY as way to turn off things
374
375 * journalctl: make sure -f ends when the container indicated by -M terminates
376
377 * mount: automatically search for "main" partition of an image has multiple
378 partitions
379
380 * expose the "privileged" flag of ExecCommand on the bus, and open it up to
381 transient units
382
383 * in nss-systemd, if we run inside of RootDirectory= with PrivateUsers= set,
384 find a way to map the User=/Group= of the service to the right name. This way
385 a user/group for a service only has to exist on the host for the right
386 mapping to work.
387
388 * add bus API for creating unit files in /etc, reusing the code for transient units
389
390 * add bus API to remove unit files from /etc
391
392 * add bus API to retrieve current unit file contents (i.e. implement "systemctl cat" on the bus only)
393
394 * rework fopen_temporary() to make use of open_tmpfile_linkable() (problem: the
395 kernel doesn't support linkat() that replaces existing files, currently)
396
397 * transient units: don't bother with actually setting unit properties, we
398 reload the unit file anyway
399
400 * journald: sigbus API via a signal-handler safe function that people may call
401 from the SIGBUS handler
402
403 * optionally, also require WATCHDOG=1 notifications during service start-up and shutdown
404
405 * resolved: when routing queries, make sure only look for the *longest* suffix...
406
407 * delay activation of logind until somebody logs in, or when /dev/tty0 pulls it
408 in or lingering is on (so that containers don't bother with it until PAM is used). also exit-on-idle
409
410 * cache sd_event_now() result from before the first iteration...
411
412 * add systemctl stop --job-mode=triggering that follows TRIGGERED_BY deps and adds them to the same transaction
413
414 * PID1: find a way how we can reload unit file configuration for
415 specific units only, without reloading the whole of systemd
416
417 * add an explicit parser for LimitRTPRIO= that verifies
418 the specified range and generates sane error messages for incorrect
419 specifications.
420
421 * when we detect that there are waiting jobs but no running jobs, do something
422
423 * push CPUAffinity= also into the "cpuset" cgroup controller (only after the cpuset controller got ported to the unified hierarchy)
424
425 * PID 1 should send out sd_notify("WATCHDOG=1") messages (for usage in the --user mode, and when run via nspawn)
426
427 * there's probably something wrong with having user mounts below /sys,
428 as we have for debugfs. for exmaple, src/core/mount.c handles mounts
429 prefixed with /sys generally special.
430 http://lists.freedesktop.org/archives/systemd-devel/2015-June/032962.html
431
432 * fstab-generator: default to tmpfs-as-root if only usr= is specified on the kernel cmdline
433
434 * docs: bring http://www.freedesktop.org/wiki/Software/systemd/MyServiceCantGetRealtime up to date
435
436 * add a job mode that will fail if a transaction would mean stopping
437 running units. Use this in timedated to manage the NTP service
438 state.
439 http://lists.freedesktop.org/archives/systemd-devel/2015-April/030229.html
440
441 * Maybe add support for the equivalent of "ethtool advertise" to .link files?
442 http://lists.freedesktop.org/archives/systemd-devel/2015-April/030112.html
443
444 * The udev blkid built-in should expose a property that reflects
445 whether media was sensed in USB CF/SD card readers. This should then
446 be used to control SYSTEMD_READY=1/0 so that USB card readers aren't
447 picked up by systemd unless they contain a medium. This would mirror
448 the behaviour we already have for CD drives.
449
450 * networkd/udev: implement SR_IOV configuration in .link files:
451 http://lists.freedesktop.org/archives/systemd-devel/2015-January/027451.html
452
453 * hostnamectl: show root image uuid
454
455 * Find a solution for SMACK capabilities stuff:
456 http://lists.freedesktop.org/archives/systemd-devel/2014-December/026188.html
457
458 * "systemctl preset-all" should probably order the unit files it
459 operates on lexicographically before starting to work, in order to
460 ensure deterministic behaviour if two unit files conflict (like DMs
461 do, for example)
462
463 * synchronize console access with BSD locks:
464 http://lists.freedesktop.org/archives/systemd-devel/2014-October/024582.html
465
466 * as soon as we have sender timestamps, revisit coalescing multiple parallel daemon reloads:
467 http://lists.freedesktop.org/archives/systemd-devel/2014-December/025862.html
468
469 * in systemctl list-unit-files: show the install value the presets would suggest for a service in a third column
470
471 * figure out when we can use the coarse timers
472
473 * add "systemctl start -v foobar.service" that shows logs of a service
474 while the start command runs. This is non-trivial to do without
475 races though, since we should flush out all journal messages before
476 returning from the "systemctl stop".
477
478 * firstboot: make it useful to be run immediately after yum --installroot to set up a machine. (most specifically, make --copy-root-password work even if /etc/passwd already exists
479
480 * maybe add support for specifier expansion in user.conf, specifically DefaultEnvironment=
481
482 * introduce systemd-timesync-wait.service or so to sync on an NTP fix?
483
484 * consider showing the unit names during boot up in the status output, not just the unit descriptions
485
486 * maybe allow timer units with an empty Units= setting, so that they
487 can be used for resuming the system but nothing else.
488
489 * what to do about udev db binary stability for apps? (raw access is not an option)
490
491 * man: maybe use the word "inspect" rather than "introspect"?
492
493 * systemctl: if some operation fails, show log output?
494
495 * systemctl edit: use equvalent of cat() to insert existing config as a comment, prepended with #.
496 Upon editor exit, lines with one # are removed, lines with two # are left with one #, etc.
497
498 * exponential backoff in timesyncd when we cannot reach a server
499
500 * timesyncd: add ugly bus calls to set NTP servers per-interface, for usage by NM
501
502 * merge ~/.local/share and ~/.local/lib into one similar /usr/lib and /usr/share....
503
504 * systemd.show_status= should probably have a mode where only failed
505 units are shown.
506
507 * add systemd.abort_on_kill or some other such flag to send SIGABRT instead of SIGKILL
508 (throughout the codebase, not only PID1)
509
510 * resolved:
511 - mDNS/DNS-SD
512 - service registration
513 - service/domain/types browsing
514 - avahi compat
515 - DNS-SD service registration from socket units
516 - resolved should optionally register additional per-interface LLMNR
517 names, so that for the container case we can establish the same name
518 (maybe "host") for referencing the server, everywhere.
519 - allow clients to request DNSSEC for a single lookup even if DNSSEC is off (?)
520 - hook up resolved with machined-based address resolution
521
522 * refcounting in sd-resolve is borked
523
524 * Add a new verb "systemctl top"
525
526 * add new gpt type for btrfs volumes
527
528 * support empty /etc boots nicely:
529 - nspawn/gpt-generator: introduce new gpt partition type for /usr
530
531 * generator that automatically discovers btrfs subvolumes, identifies their purpose based on some xattr on them.
532
533 * a way for container managers to turn off getty starting via $container_headless= or so...
534
535 * figure out a nice way how we can let the admin know what child/sibling unit causes cgroup membership for a specific unit
536
537 * For timer units: add some mechanisms so that timer units that trigger immediately on boot do not have the services
538 they run added to the initial transaction and thus confuse Type=idle.
539
540 * add bus api to query unit file's X fields.
541
542 * gpt-auto-generator:
543 - Define new partition type for encrypted swap? Support probed LUKS for encrypted swap?
544 - Make /home automount rather than mount?
545
546 * add generator that pulls in systemd-network from containers when
547 CAP_NET_ADMIN is set, more than the loopback device is defined, even
548 when it is otherwise off
549
550 * MessageQueueMessageSize= (and suchlike) should use parse_iec_size().
551
552 * implement Distribute= in socket units to allow running multiple
553 service instances processing the listening socket, and open this up
554 for ReusePort=
555
556 * socket units: support creating sockets in different namespace,
557 opening it up for JoinsNamespaceOf=. This would require to fork off
558 a tiny process that joins the namespace and creates/binds the socket
559 and passes this back to PID1 via SCM_RIGHTS. This also could be used
560 to allow Chown/chgrp on sockets without requiring NSS in PID 1.
561
562 * introduce bus call FreezeUnit(s, b), as well as "systemctl freeze
563 $UNIT" and "systemctl thaw $UNIT" as wrappers around this. The calls
564 should SIGSTOP all unit processes in a loop until all processes of
565 it are fully stopped. This can later be used for app management by
566 desktop UIs such as gnome-shell to freeze apps that are not visible
567 on screen, not unlike how job control works on the shell
568
569 * cgroups:
570 - implement per-slice CPUFairScheduling=1 switch
571 - handle jointly mounted controllers correctly
572 - introduce high-level settings for RT budget, swappiness
573 - how to reset dynamically changed unit cgroup attributes sanely?
574 - when reloading configuration, apply new cgroup configuration
575 - when recursively showing the cgroup hierarchy, optionally also show
576 the hierarchies of child processes
577
578 * transient units:
579 - add field to transient units that indicate whether systemd or somebody else saves/restores its settings, for integration with libvirt
580
581 * Automatically configure swap partition to use for hibernation by looking for largest swap partition on the root disk?
582
583 * when we detect low battery and no AC on boot, show pretty splash and refuse boot
584
585 * libsystemd-journal, libsystemd-login, libudev: add calls to easily attach these objects to sd-event event loops
586
587 * be more careful what we export on the bus as (usec_t) 0 and (usec_t) -1
588
589 * rfkill,backlight: we probably should run the load tools inside of the udev rules so that the state is properly initialized by the time other software sees it
590
591 * After coming back from hibernation reset hibernation swap partition using the /dev/snapshot ioctl APIs
592
593 * If we try to find a unit via a dangling symlink, generate a clean
594 error. Currently, we just ignore it and read the unit from the search
595 path anyway.
596
597 * refuse boot if /usr/lib/os-release is missing or /etc/machine-id cannot be set up
598
599 * man: the documentation of Restart= currently is very misleading and suggests the tools from ExecStartPre= might get restarted.
600
601 * load .d/*.conf dropins for device units
602
603 * allow implementation of InaccessibleDirectories=/ plus
604 ReadOnlyDirectories=... for whitelisting files for a service.
605
606 * sd-bus:
607 - EBADSLT handling
608 - GetAllProperties() on a non-existing object does not result in a failure currently
609 - port to sd-resolve for connecting to TCP dbus servers
610 - see if we can introduce a new sd_bus_get_owner_machine_id() call to retrieve the machine ID of the machine of the bus itself
611 - see if we can drop more message validation on the sending side
612 - add API to clone sd_bus_message objects
613 - longer term: priority inheritance
614 - dbus spec updates:
615 - NameLost/NameAcquired obsolete
616 - GVariant
617 - path escaping
618 - update systemd.special(7) to mention that dbus.socket is only about the compatibility socket now
619
620 * sd-event
621 - allow multiple signal handlers per signal?
622 - document chaining of signal handler for SIGCHLD and child handlers
623 - define more intervals where we will shift wakeup intervals around in, 1h, 6h, 24h, ...
624 - generate a failure of a default event loop is executed out-of-thread
625 - maybe add support for inotify events (which we can do safely now, with O_PATH)
626
627 * investigate endianness issues of UUID vs. GUID
628
629 * dbus: when a unit failed to load (i.e. is in UNIT_ERROR state), we
630 should be able to safely try another attempt when the bus call LoadUnit() is invoked.
631
632 * add a pam module that passes the hdd passphrase into the PAM stack and then expires it, for usage by gdm auto-login.
633
634 * add a pam module that on password changes updates any LUKS slot where the password matches
635
636 * maybe add a generator that looks for "systemd.run=" on the kernel cmdline for container usercases...
637
638 * test/:
639 - add unit tests for config_parse_device_allow()
640
641 * seems that when we follow symlinks to units we prefer the symlink
642 destination path over /etc and /usr. We should not do that. Instead
643 /etc should always override /run+/usr and also any symlink
644 destination.
645
646 * when isolating, try to figure out a way how we implicitly can order
647 all units we stop before the isolating unit...
648
649 * teach ConditionKernelCommandLine= globs or regexes (in order to match foobar={no,0,off})
650
651 * BootLoaderSpec: Clarify that the kernel has to be in $BOOT. Clarify
652 that the boot loader should be installed to the ESP. Define a way
653 how an installer can figure out whether a BLS compliant boot loader
654 is installed.
655
656 * think about requeuing jobs when daemon-reload is issued? usecase:
657 the initrd issues a reload after fstab from the host is accessible
658 and we might want to requeue the mounts local-fs acquired through
659 that automatically.
660
661 * systemd-inhibit: make taking delay locks useful: support sending SIGINT or SIGTERM on PrepareForSleep()
662
663 * remove any syslog support from log.c — we probably cannot do this before split-off udev is gone for good
664
665 * shutdown logging: store to EFI var, and store to USB stick?
666
667 * merge unit_kill_common() and unit_kill_context()
668
669 * introduce ExecCondition= in services
670
671 * EFI:
672 - honor language efi variables for default language selection (if there are any?)
673 - honor timezone efi variables for default timezone selection (if there are any?)
674 - change bootctl to be backed by systemd-bootd to control temporary and persistent default boot goal plus efi variables
675
676 * maybe do not install getty@tty1.service symlink in /etc but in /usr?
677
678 * print a nicer explanation if people use variable/specifier expansion in ExecStart= for the first word
679
680 * mount: turn dependency information from /proc/self/mountinfo into dependency information between systemd units.
681
682 * logind:
683 - logind: optionally, ignore idle-hint logic for autosuspend, block suspend as long as a session is around
684 - When we update the kernel all kind of hibernation should be prohibited until shutdown/reboot
685 - logind: wakelock/opportunistic suspend support
686 - Add pretty name for seats in logind
687 - logind: allow showing logout dialog from system?
688 - session scopes/user unit: add RequiresMountsFor for the home directory of the user
689 - add Suspend() bus calls which take timestamps to fix double suspend issues when somebody hits suspend and closes laptop quickly.
690 - if pam_systemd is invoked by su from a process that is outside of a
691 any session we should probably just become a NOP, since that's
692 usually not a real user session but just some system code that just
693 needs setuid().
694 - logind: make the Suspend()/Hibernate() bus calls wait for the for
695 the job to be completed. before returning, so that clients can wait
696 for "systemctl suspend" to finish to know when the suspending is
697 complete.
698 - logind: when the power button is pressed short, just popup a
699 logout dialog. If it is pressed for 1s, do the usual
700 shutdown. Inspiration are Macs here.
701 - expose "Locked" property on logind sesison objects
702 - maybe allow configuration of the StopTimeout for session scopes
703 - rename session scope so that it includes the UID. THat way
704 the session scope can be arranged freely in slices and we don't have
705 make assumptions about their slice anymore.
706 - follow PropertiesChanged state more closely, to deal with quick logouts and
707 relogins
708
709 * exec: when deinitializating a tty device fix the perms and group, too, not only when initializing. Set access mode/gid to 0620/tty.
710
711 * journal:
712 - consider introducing implicit _TTY= + _PPID= + _EUID= + _EGID= + _FSUID= + _FSGID= fields
713 - import and delete pstore filesystem content at startup
714 - journald: also get thread ID from client, plus thread name
715 - journal: when waiting for journal additions in the client always sleep at least 1s or so, in order to minimize wakeups
716 - add API to close/reopen/get fd for journal client fd in libsystemd-journal.
717 - fallback to /dev/log based logging in libsystemd-journal, if we cannot log natively?
718 - declare the local journal protocol stable in the wiki interface chart
719 - sd-journal: speed up sd_journal_get_data() with transparent hash table in bg
720 - journald: when dropping msgs due to ratelimit make sure to write
721 "dropped %u messages" not only when we are about to print the next
722 message that works, but alraedy after a short tiemout
723 - check if we can make journalctl by default use --follow mode inside of less if called without args?
724 - maybe add API to send pairs of iovecs via sd_journal_send
725 - journal: add a setgid "systemd-journal" utility to invoke from libsystemd-journal, which passes fds via STDOUT and does PK access
726 - journactl: support negative filtering, i.e. FOOBAR!="waldo",
727 and !FOOBAR for events without FOOBAR.
728 - journal: store timestamp of journal_file_set_offline() int he header,
729 so it is possible to display when the file was last synced.
730 - journal-send.c, log.c: when the log socket is clogged, and we drop, count this and write a message about this when it gets unclogged again.
731 - journal: find a way to allow dropping history early, based on priority, other rules
732 - journal: When used on NFS, check payload hashes
733 - journald: add kernel cmdline option to disable ratelimiting for debug purposes
734 - refuse taking lower-case variable names in sd_journal_send() and friends.
735 - journald: we currently rotate only after MaxUse+MaxFilesize has been reached.
736 - journal: deal nicely with byte-by-byte copied files, especially regards header
737 - journal: sanely deal with entries which are larger than the individual file size, but where the components would fit
738 - Replace utmp, wtmp, btmp, and lastlog completely with journal
739 - journalctl: instead --after-cursor= maybe have a --cursor=XYZ+1 syntax?
740 - when a kernel driver logs in a tight loop, we should ratelimit that too.
741 - journald: optionally, log debug messages to /run but everything else to /var
742 - journald: when we drop syslog messages because the syslog socket is
743 full, make sure to write how many messages are lost as first thing
744 to syslog when it works again.
745 - change systemd-journal-flush into a service that stays around during
746 boot, and causes the journal to be moved back to /run on shutdown,
747 so that we do not keep /var busy. This needs to happen synchronously,
748 hence doing this via signals is not going to work.
749 - optionally support running journald from the command line for testing purposes in external projects
750 - journald: allow per-priority and per-service retention times when rotating/vacuuming
751 - journald: make use of uid-range.h to managed uid ranges to split
752 journals in.
753 - journalctl: add the ability to look for the most recent process of a binary. journalctl /usr/bin/X11 --pid=-1 or so...
754 - improve journalctl performance by loading journal files
755 lazily. Encode just enough information in the file name, so that we
756 do not have to open it to know that it is not interesting for us, for
757 the most common operations.
758 - man: document that corrupted journal files is nothing to act on
759 - rework journald sigbus stuff to use mutex
760 - Set RLIMIT_NPROC for systemd-journal-xyz, and all other of our
761 services that run under their own user ids, and use User= (but only
762 in a world where userns is ubiquitous since otherwise we cannot
763 invoke those daemons on the host AND in a container anymore). Also,
764 if LimitNPROC= is used without User= we should warn and refuse
765 operation.
766 - journalctl --verify: don't show files that are currently being
767 written to as FAIL, but instead show that their are being written to.
768 - add journalctl -H that talks via ssh to a remote peer and passes through
769 binary logs data
770 - add a version of --merge which also merges /var/log/journal/remote
771 - journalctl: -m should access container journals directly by enumerating
772 them via machined, and also watch containers coming and going.
773 Benefit: nspawn --ephemeral would start working nicely with the journal.
774 - assign MESSAGE_ID to log messages about failed services
775
776 * add a test if all entries in the catalog are properly formatted.
777 (Adding dashes in a catalog entry currently results in the catalog entry
778 being silently skipped. journalctl --update-catalog must warn about this,
779 and we should also have a unit test to check that all our message are OK.)
780
781 * document:
782 - document that deps in [Unit] sections ignore Alias= fields in
783 [Install] units of other units, unless those units are disabled
784 - man: clarify that time-sync.target is not only sysv compat but also useful otherwise. Same for similar targets
785 - document that service reload may be implemented as service reexec
786 - add a man page containing packaging guidelines and recommending usage of things like Documentation=, PrivateTmp=, PrivateNetwork= and ReadOnlyDirectories=/etc /usr.
787 - document systemd-journal-flush.service properly
788 - documentation: recommend to connect the timer units of a service to the service via Also= in [Install]
789 - man: document the very specific env the shutdown drop-in tools live in
790 - man: add more examples to man pages
791 - man: maybe sort directives in man pages, and take sections from --help and apply them to man too
792
793 * systemctl:
794 - add systemctl switch to dump transaction without executing it
795 - Add a verbose mode to "systemctl start" and friends that explains what is being done or not done
796 - "systemctl disable" on a static unit prints no message and does
797 nothing. "systemctl enable" does nothing, and gives a bad message
798 about it. Should fix both to print nice actionable messages.
799 - print nice message from systemctl --failed if there are no entries shown, and hook that into ExecStartPre of rescue.service/emergency.service
800 - add new command to systemctl: "systemctl system-reexec" which reexecs as many daemons as virtually possible
801 - systemctl enable: fail if target to alias into does not exist? maybe show how many units are enabled afterwards?
802 - systemctl: "Journal has been rotated since unit was started." message is misleading
803 - systemctl status output should include list of triggering units and their status
804
805 * unit install:
806 - "systemctl mask" should find all names by which a unit is accessible
807 (i.e. by scanning for symlinks to it) and link them all to /dev/null
808
809 * timer units:
810 - timer units should get the ability to trigger when:
811 o CLOCK_REALTIME makes jumps (TFD_TIMER_CANCEL_ON_SET)
812 o DST changes
813 o timezone changes
814 - Modulate timer frequency based on battery state
815
816 * add libsystemd-password or so to query passwords during boot using the password agent logic
817
818 * clean up date formatting and parsing so that all absolute/relative timestamps we format can also be parsed
819
820 * on shutdown: move utmp, wall, audit logic all into PID 1 (or logind?), get rid of systemd-update-utmp-runlevel
821
822 * make repeated alt-ctrl-del presses printing a dump
823
824 * hostnamed: before returning information from /etc/machine-info.conf check the modification data and reread. Similar for localed, ...
825
826 * currently x-systemd.timeout is lost in the initrd, since crypttab is copied into dracut, but fstab is not
827
828 * nspawn:
829 - emulate /dev/kmsg using CUSE and turn off the syslog syscall
830 with seccomp. That should provide us with a useful log buffer that
831 systemd can log to during early boot, and disconnect container logs
832 from the kernel's logs.
833 - as soon as networkd has a bus interface, hook up --network-interface=,
834 --network-bridge= with networkd, to trigger netdev creation should an
835 interface be missing
836 - a nice way to boot up without machine id set, so that it is set at boot
837 automatically for supporting --ephemeral. Maybe hash the host machine id
838 together with the machine name to generate the machine id for the container
839 - fix logic always print a final newline on output.
840 https://github.com/systemd/systemd/pull/272#issuecomment-113153176
841 - should optionally support receiving WATCHDOG=1 messages from its payload
842 PID 1...
843 - optionally automatically add FORWARD rules to iptables whenever nspawn is
844 running, remove them when shut down.
845 - maybe make copying of /etc/resolv.conf optional, and skip it if --read-only
846 is used
847
848 * dissect
849 - refuse mounting over a mount point
850 - automatically discover .roothash files in dissect, similarly to nspawn
851
852 * machined:
853 - add an API so that libvirt-lxc can inform us about network interfaces being
854 removed or added to an existing machine
855 - "machinectl migrate" or similar to copy a container from or to a
856 difference host, via ssh
857 - introduce systemd-nspawn-ephemeral@.service, and hook it into
858 "machinectl start" with a new --ephemeral switch
859 - "machinectl status" should also show internal logs of the container in
860 question
861 - "machinectl list-images" should show os-release data, as well as
862 machine-info data (including deployment level)
863 - "machinectl history"
864 - "machinectl diff"
865 - "machinectl commit" that takes a writable snapshot of a tree, invokes a
866 shell in it, and marks it read-only after use
867
868 * importd:
869 - generate a nice warning if mkfs.btrfs is missing
870
871 * cryptsetup:
872 - cryptsetup-generator: allow specification of passwords in crypttab itself
873 - support rd.luks.allow-discards= kernel cmdline params in cryptsetup generator
874
875 * hw watchdog: optionally try to use the preset watchdog timeout instead of always overriding it
876 https://bugs.freedesktop.org/show_bug.cgi?id=54712
877
878 * add a dependency on standard-conf.xml and other included files to man pages
879
880 * MountFlags=shared acts as MountFlags=slave right now.
881
882 * properly handle loop back mounts via fstab, especially regards to fsck/passno
883
884 * initialize the hostname from the fs label of /, if /etc/hostname does not exist?
885
886 * udev:
887 - move to LGPL
888 - kill scsi_id
889 - add trigger --subsystem-match=usb/usb_device device
890 - reimport udev db after MOVE events for devices without dev_t
891
892 * There's currently no way to cancel fsck (used to be possible via C-c or c on the console)
893
894 * add option to sockets to avoid activation. Instead just drop packets/connections, see http://cyberelk.net/tim/2012/02/15/portreserve-systemd-solution/
895
896 * coredump:
897 - save coredump in Windows/Mozilla minidump format
898 - when truncating coredumps, also log the full size that the process had, and make a metadata field so we can report truncated coredumps
899
900 * support crash reporting operation modes (https://live.gnome.org/GnomeOS/Design/Whiteboards/ProblemReporting)
901
902 * default to actual 32-bit PIDs, via /proc/sys/kernel/pid_max
903
904 * be able to specify a forced restart of service A where service B depends on, in case B
905 needs to be auto-respawned?
906
907 * tmpfiles:
908 - apply "x" on "D" too (see patch from William Douglas)
909 - replace F with f+.
910 - instead of ignoring unknown fields, reject them.
911 - creating new directories/subvolumes/fifos/device nodes
912 should not follow symlinks. None of the other adjustment or creation
913 calls follow symlinks.
914
915 * make sure systemd-ask-password-wall does not shutdown systemd-ask-password-console too early
916
917 * verify that the AF_UNIX sockets of a service in the fs still exist
918 when we start a service in order to avoid confusion when a user
919 assumes starting a service is enough to make it accessible
920
921 * Make it possible to set the keymap independently from the font on
922 the kernel cmdline. Right now setting one resets also the other.
923
924 * and a dbus call to generate target from current state
925
926 * write blog stories about:
927 - hwdb: what belongs into it, lsusb
928 - enabling dbus services
929 - how to make changes to sysctl and sysfs attributes
930 - remote access
931 - how to pass throw-away units to systemd, or dynamically change properties of existing units
932 - testing with Harald's awesome test kit
933 - auto-restart
934 - how to develop against journal browsing APIs
935 - the journal HTTP iface
936 - non-cgroup resource management
937 - dynamic resource management with cgroups
938 - refreshed, longer missions statement
939 - calendar time events
940 - init=/bin/sh vs. "emergency" mode, vs. "rescue" mode, vs. "multi-user" mode, vs. "graphical" mode, and the debug shell
941 - how to create your own target
942 - instantiated apache, dovecot and so on
943 - hooking a script into various stages of shutdown/rearly booot
944
945 * investigate whether the gnome pty helper should be moved into systemd, to provide cgroup support.
946
947 * dot output for --test showing the 'initial transaction'
948
949 * pid1:
950 - When logging about multiple units (stopping BoundTo units, conflicts, etc.),
951 log both units as UNIT=, so that journalctl -u triggers on both.
952 - generate better errors when people try to set transient properties
953 that are not supported...
954 http://lists.freedesktop.org/archives/systemd-devel/2015-February/028076.html
955 - maybe introduce WantsMountsFor=? Usecase:
956 http://lists.freedesktop.org/archives/systemd-devel/2015-January/027729.html
957 - recreate systemd's D-Bus private socket file on SIGUSR2
958 - move PAM code into its own binary
959 - when we automatically restart a service, ensure we restart its rdeps, too.
960 - hide PAM options in fragment parser when compile time disabled
961 - Support --test based on current system state
962 - If we show an error about a unit (such as not showing up) and it has no Description string, then show a description string generated form the reverse of unit_name_mangle().
963 - after deserializing sockets in socket.c we should reapply sockopts and things
964 - drop PID 1 reloading, only do reexecing (difficult: Reload()
965 currently is properly synchronous, Reexec() is weird, because we
966 cannot delay the response properly until we are back, so instead of
967 being properly synchronous we just keep open the fd and close it
968 when done. That means clients do not get a successful method reply,
969 but much rather a disconnect on success.
970 - when breaking cycles drop sysv services first, then services from /run, then from /etc, then from /usr
971 - when a bus name of a service disappears from the bus make sure to queue further activation requests
972
973 * unit files:
974 - allow port=0 in .socket units
975 - maybe introduce ExecRestartPre=
976 - add ReloadSignal= for configuring a reload signal to use
977 - implement Register= switch in .socket units to enable registration
978 in Avahi, RPC and other socket registration services.
979 - allow Type=simple with PIDFile=
980 https://bugzilla.redhat.com/show_bug.cgi?id=723942
981 - allow writing multiple conditions in unit files on one line
982 - load-fragment: when loading a unit file via a chain of symlinks
983 verify that it is not masked via any of the names traversed.
984 - introduce Type=pid-file
985 - introduce mix of BindTo and Requisite
986 - add a concept of RemainAfterExit= to scope units
987 - Allow multiple ExecStart= for all Type= settings, so that we can cover rescue.service nicely
988
989 * udev-link-config:
990 - Make sure ID_PATH is always exported and complete for
991 network devices where possible, so we can safely rely
992 on Path= matching
993 - check MTUBytes parsing (expecting size_t but we are using unsigned)
994
995 * sd-rtnl:
996 - add support for more attribute types
997 - inbuilt piping support (essentially degenerate async)? see loopback-setup.c and other places
998
999 * networkd:
1000 - add more keys to [Route] and [Address] sections
1001 - add support for more DHCPv4 options (and, longer term, other kinds of dynamic config)
1002 - add proper initrd support (in particular generate .network/.link files based on /proc/cmdline)
1003 - add reduced [Link] support to .network files
1004 - add Scope= parsing option for [Network]
1005 - properly handle routerless dhcp leases
1006 - work with non-Ethernet devices
1007 - add support for more bond options
1008 - dhcp: do we allow configuring dhcp routes on interfaces that are not the one we got the dhcp info from?
1009 - the DHCP lease data (such as NTP/DNS) is still made available when
1010 a carrier is lost on a link. It should be removed instantly.
1011 - expose in the API the following bits:
1012 - option 15, domain name and/or option 119, search list
1013 - option 12, host name and/or option 81, fqdn
1014 - option 123, 144, geolocation
1015 - option 252, configure http proxy (PAC/wpad)
1016 - provide a way to define a per-network interface default metric value
1017 for all routes to it. possibly a second default for DHCP routes.
1018 - allow Name= to be specified repeatedly in the [Match] section. Maybe also
1019 support Name=foo*|bar*|baz ?
1020 - duplicate address check for static IPs (like ARPCHECK in network-scripts)
1021 - allow DUID/IAID to be customized, see issue #394.
1022 - whenever uplink info changes, make DHCP server send out FORCERENEW
1023
1024 * networkd-wait-online:
1025 - make operstates to wait for configurable?
1026
1027 * dhcp:
1028 - figure out how much we can increase Maximum Message Size
1029
1030 * dhcp6:
1031 - add functions to set previously stored IPv6 addresses on startup and get
1032 them at shutdown; store them in client->ia_na
1033 - write more test cases
1034 - implement reconfigure support, see 5.3., 15.11. and 22.20.
1035 - implement support for temporary adressess (IA_TA)
1036 - implement dhcpv6 authentication
1037 - investigate the usefulness of Confirm messages; i.e. are there any
1038 situations where the link changes without any loss in carrier detection
1039 or interface down
1040 - some servers don't do rapid commit without a filled in IA_NA, verify
1041 this behavior
1042 - RouteTable= ?
1043
1044 External:
1045
1046 * dbus:
1047 - natively watch for dbus-*.service symlinks (PENDING)
1048 - teach dbus to activate all services it finds in /etc/systemd/services/org-*.service
1049
1050 * fix alsa mixer restore to not print error when no config is stored
1051
1052 * make cryptsetup lower --iter-time
1053
1054 * patch kernel for xattr support in /dev, /proc/, /sys?
1055
1056 * kernel: add device_type = "fb", "fbcon" to class "graphics"
1057
1058 * drop accountsservice's StandardOutput=syslog and Type=dbus fields
1059
1060 * /usr/bin/service should actually show the new command line
1061
1062 * fedora: suggest auto-restart on failure, but not on success and not on coredump. also, ask people to think about changing the start limit logic. Also point people to RestartPreventExitStatus=, SuccessExitStatus=
1063
1064 * fedora: F20: go timer units all the way, leave cron.daily for cron
1065
1066 * neither pkexec nor sudo initialize environ[] from the PAM environment?
1067
1068 * fedora: update policy to declare access mode and ownership of unit files to root:root 0644, and add an rpmlint check for it
1069
1070 * register catalog database signature as file magic
1071
1072 * zsh shell completion:
1073 - <command> <verb> -<TAB> should complete options, but currently does not
1074 - systemctl add-wants,add-requires
1075
1076
1077 Regularly:
1078
1079 * look for close() vs. close_nointr() vs. close_nointr_nofail()
1080
1081 * check for strerror(r) instead of strerror(-r)
1082
1083 * pahole
1084
1085 * set_put(), hashmap_put() return values check. i.e. == 0 does not free()!
1086
1087 * use secure_getenv() instead of getenv() where appropriate
1088
1089 * link up selected blog stories from man pages and unit files Documentation= fields