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