[Rpm-maint] [rpm-software-management/rpm] Add a man page for rpm sysusers integration (PR #4126)

[Michal Domonkos]

@dmnks commented on this pull request.



> +at installation time. This eliminates the need for the manual creation of such
+accounts in transaction scriptlets.
+
+This works implicitly if a package ships one or more files in this format under
+*%\_sysusersdir* (typically _/usr/lib/sysusers.d/_). RPM will then automatically
+invoke the *%\_\_systemd_sysusers* binary (typically *systemd-sysusers*(8)) with
+the correct arguments in order to create the user and/or group accounts when the
+package is installed. This is the recommended method on systemd native platforms
+and requires no intervention from the package beyond shipping those files.
+
+RPM also allows for declaring sysusers.d entries explicitly in the spec file
+with the *%add_sysuser* macro. This macro takes a sysusers.d line with its
+fields passed as separate arguments and must be declared in the (sub-)package
+context. This method is primarily intended for platforms without systemd where
+it is typically also coupled with a custom *%\_\_systemd_sysusers* binary (see
+*DECODING* for details).

Turns out, reading Fedora's [User and Groups](https://docs.fedoraproject.org/en-US/packaging-guidelines/UsersAndGroups/) packaging guidelines is also enlightening - rpm's sysusers.d integration is now the recommended mechanism. It also mentions the previous mechanism, which was based on the manual invocation of special systemd macros (as theorized in my previous comments) :+1:

There's also one interesting troubleshooting tip that we should probably steal for this man page:
> Use rpm -q --qf='[%{SYSUSERS}\n]' … to view the definitions of users and groups decoded from the virtual Provides.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/rpm-software-management/rpm/pull/4126#discussion_r2865080103
You are receiving this because you are subscribed to this thread.

Message ID: <rpm-software-management/rpm/pull/4126/review/3867777722 at github.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rpm.org/pipermail/rpm-maint/attachments/20260227/945c9881/attachment-0001.htm>