X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_creds_get_pid.xml;h=d61ec19cb84ff7f5d8ace5dc7e5d02cb0f0916dd;hb=07a0d22f9ec5a0cac2385b73dc08b12a811cead8;hp=635876247077d753ad90555c620c28a9bd24e510;hpb=8474b70c3a3842cdf3d51f331dd117ab6421f6d0;p=elogind.git
diff --git a/man/sd_bus_creds_get_pid.xml b/man/sd_bus_creds_get_pid.xml
index 635876247..d61ec19cb 100644
--- a/man/sd_bus_creds_get_pid.xml
+++ b/man/sd_bus_creds_get_pid.xml
@@ -1,4 +1,4 @@
-
+
@@ -44,7 +44,6 @@ along with systemd; If not, see .
sd_bus_creds_get_pid
- sd_bus_creds_get_pid_starttime
sd_bus_creds_get_tid
sd_bus_creds_get_uid
sd_bus_creds_get_gid
@@ -67,6 +66,7 @@ along with systemd; If not, see .
sd_bus_creds_get_audit_login_uid
sd_bus_creds_get_unique_name
sd_bus_creds_get_well_known_names
+ sd_bus_creds_get_connection_name
Retrieve fields from a credentials object
@@ -81,12 +81,6 @@ along with systemd; If not, see .
pid_t *pid
-
- int sd_bus_creds_get_pid_starttime
- sd_bus_creds *c
- uint64_t *usec
-
-
int sd_bus_creds_get_tid
sd_bus_creds *c
@@ -219,6 +213,12 @@ along with systemd; If not, see .
char ***name
+
+ int sd_bus_creds_get_connection_name
+ sd_bus_creds *c
+ const char **name
+
+
@@ -230,77 +230,73 @@ along with systemd; If not, see .
sd_bus_creds_new_from_pid3,
in which case it will describe the specified process, or it may be
created by
- sd_bus_get_peer_creds3,
+ sd_bus_get_owner_creds3,
in which case it will describe the process at the other endpoint
of a connection.
- sd_bus_creds_get_pid will retrieve the
+ sd_bus_creds_get_pid() will retrieve the
PID (process identifier).
- sd_bus_creds_get_pid_starttime will
- retrieve the time since the start of the epoch in microseconds
- since the process was started.
-
- sd_bus_creds_get_tid will retrieve the
+ sd_bus_creds_get_tid() will retrieve the
TID (thread identifier).
- sd_bus_creds_get_uid will retrieve the
+ sd_bus_creds_get_uid() will retrieve the
numeric UID (user identifier).
- sd_bus_creds_get_gid will retrieve the
+ sd_bus_creds_get_gid() will retrieve the
numeric GID (group identifier).
- sd_bus_creds_get_comm will retrieve the
+ sd_bus_creds_get_comm() will retrieve the
comm field (truncated name of the executable, as stored in
/proc/pid/comm).
- sd_bus_creds_get_tid_comm will retrieve
+ sd_bus_creds_get_tid_comm() will retrieve
the comm field of the thread (as stored in
/proc/pid/task/tid/comm).
- sd_bus_creds_get_exe will retrieve the
+ sd_bus_creds_get_exe() will retrieve the
path to the program (as stored in the
/proc/pid/exe
link, but with (deleted) suffix removed).
- sd_bus_creds_get_cmdline will retrieve
- an array of command-line arguments (as stored in
+ sd_bus_creds_get_cmdline() will retrieve
+ an array of command line arguments (as stored in
/proc/pid/cmdline).
- sd_bus_creds_get_cgroup will retrieve
+ sd_bus_creds_get_cgroup() will retrieve
the cgroup path. See cgroups.txt.
- sd_bus_creds_get_unit will retrieve the
+ sd_bus_creds_get_unit() will retrieve the
systemd unit name (in the system instance of systemd) that the
process is part of. See
systemd.unit5.
- sd_bus_creds_get_user_unit will
+ sd_bus_creds_get_user_unit() will
retrieve the systemd unit name (in the user instance of systemd)
that the process is part of. See
systemd.unit5.
- sd_bus_creds_get_slice will retrieve
+ sd_bus_creds_get_slice() will retrieve
the systemd slice (a unit in the system instance of systemd) that
the process is part of. See
systemd.slice5.
- sd_bus_creds_get_session will retrieve
+ sd_bus_creds_get_session() will retrieve
the logind session that the process is part of. See
systemd-logind.service8.
- sd_bus_creds_get_owner_uid will retrieve
+ sd_bus_creds_get_owner_uid() will retrieve
the numeric UID (user identifier) of the user who owns the slice
that the process is part of. See
systemd.slice5
@@ -308,7 +304,7 @@ along with systemd; If not, see .
systemd-user-sessions.service8 -->.
- sd_bus_creds_has_effective_cap will
+ sd_bus_creds_has_effective_cap() will
check whether the capability specified by
capability was set in the effective
capabilities mask. A positive return value means that is was
@@ -320,38 +316,45 @@ along with systemd; If not, see .
systemd.exec5.
- sd_bus_creds_has_permitted_cap is
- similar to sd_bus_creds_has_effective_cap,
+ sd_bus_creds_has_permitted_cap() is
+ similar to sd_bus_creds_has_effective_cap(),
but will check the permitted capabilities mask.
- sd_bus_creds_has_inheritable_cap is
- similar to sd_bus_creds_has_effective_cap,
+ sd_bus_creds_has_inheritable_cap() is
+ similar to sd_bus_creds_has_effective_cap(),
but will check the inheritable capabilities mask.
- sd_bus_creds_has_bounding_cap is
- similar to sd_bus_creds_has_effective_cap,
+ sd_bus_creds_has_bounding_cap() is
+ similar to sd_bus_creds_has_effective_cap(),
but will check the bounding capabilities mask.
- sd_bus_creds_get_selinux_context will
+ sd_bus_creds_get_selinux_context() will
retrieve the SELinux security context (label) of the process.
- sd_bus_creds_get_audit_session_id will
+ sd_bus_creds_get_audit_session_id() will
retrieve the audit session identifier of the process.
- sd_bus_creds_get_audit_login_uid will
+ sd_bus_creds_get_audit_login_uid() will
retrieve the audit user login identifier (the identifier of the
user who is "responsible" for the session).
- sd_bus_creds_get_unique_name will
+ sd_bus_creds_get_unique_name() will
retrieve the D-Bus unique name. See The
D-Bus specification.
- sd_bus_creds_get_well_known_names will
+ sd_bus_creds_get_well_known_names() will
retrieve the set of D-Bus well-known names. See The
D-Bus specification.
+ sd_bus_creds_get_connection_name() will
+ retrieve a descriptive name of the bus connection of the
+ peer. This name is useful to discern multiple bus connections by
+ the same peer, and may be altered by the peer with the
+ sd_bus_set_name()3
+ call.
+
All functions that take a const
char** parameter will store the answer there as an
address of a NUL-terminated string. It will be valid as long as
@@ -392,11 +395,11 @@ along with systemd; If not, see .
-ENOENT
Given field is not specified for the sender.
- This will be returned by sd_bus_get_unit,
- sd_bus_get_user_unit,
- sd_bus_get_slice,
- sd_bus_get_session, and
- sd_bus_get_owner_uid if the sender is not
+ This will be returned by sd_bus_get_unit(),
+ sd_bus_get_user_unit(),
+ sd_bus_get_slice(),
+ sd_bus_get_session(), and
+ sd_bus_get_name_creds_uid() if the sender is not
part of a systemd system unit, systemd user unit, systemd
slice, logind session, or a systemd user session.