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