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