man: document preference for secure_getenv() in coding style

This commit is contained in:
Lennart Poettering 2024-10-14 11:55:59 +02:00 committed by Luca Boccassi
parent 4881dd5cf5
commit c9b477415a

View File

@ -591,6 +591,14 @@ SPDX-License-Identifier: LGPL-2.1-or-later
important for objects that unprivileged users may allocate, but also matters important for objects that unprivileged users may allocate, but also matters
for everything else any user may allocate. for everything else any user may allocate.
- Please use `secure_getenv()` for all environment variable accesses, unless
it's clear that `getenv()` would be the better choice. This matters in
particular in `src/basic/` and `src/shared/` (i.e. library code that might
end up in unexpected processes), but should be followed everywhere else too
(in order to make it unproblematic to move code around). To say this clearly:
the default should be `secure_getenv()`, the exception should be regular
`getenv()`.
## Types ## Types
- Think about the types you use. If a value cannot sensibly be negative, do not - Think about the types you use. If a value cannot sensibly be negative, do not