X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_creds_get_pid.xml;h=d61ec19cb84ff7f5d8ace5dc7e5d02cb0f0916dd;hb=e45fc5e738b0b7700e8b4f3c4b25c58a49b44b27;hp=740082e47851131d05b3b3bc17d57db4bdc5b518;hpb=48b5804a48b2b629fa793cc93bcb4a9c6edf9962;p=elogind.git
diff --git a/man/sd_bus_creds_get_pid.xml b/man/sd_bus_creds_get_pid.xml
index 740082e47..d61ec19cb 100644
--- a/man/sd_bus_creds_get_pid.xml
+++ b/man/sd_bus_creds_get_pid.xml
@@ -1,4 +1,4 @@
-
+
@@ -21,7 +21,7 @@ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+
sd_bus_creds_get_pid
@@ -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
@@ -77,230 +77,226 @@ along with systemd; If not, see .
int sd_bus_creds_get_pid
- sd_bus_creds* c
+ sd_bus_creds *c
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
+ sd_bus_creds *c
pid_t *tid
int sd_bus_creds_get_pid
- sd_bus_creds* c
+ sd_bus_creds *c
uid_t *uid
int sd_bus_creds_get_gid
- sd_bus_creds* c
+ sd_bus_creds *c
gid_t *gid
int sd_bus_creds_get_comm
- sd_bus_creds* c
+ sd_bus_creds *c
const char **comm
int sd_bus_creds_get_tid_comm
- sd_bus_creds* c
+ sd_bus_creds *c
const char **comm
int sd_bus_creds_get_exe
- sd_bus_creds* c
+ sd_bus_creds *c
const char **exe
int sd_bus_creds_get_cmdline
- sd_bus_creds* c
+ sd_bus_creds *c
char ***cmdline
int sd_bus_creds_get_cgroup
- sd_bus_creds* c
+ sd_bus_creds *c
const char **cgroup
int sd_bus_creds_get_unit
- sd_bus_creds* c
+ sd_bus_creds *c
const char **unit
int sd_bus_creds_get_user_unit
- sd_bus_creds* c
+ sd_bus_creds *c
const char **unit
int sd_bus_creds_get_slice
- sd_bus_creds* c
+ sd_bus_creds *c
const char **slice
int sd_bus_creds_get_session
- sd_bus_creds* c
+ sd_bus_creds *c
const char **slice
int sd_bus_creds_get_owner_uid
- sd_bus_creds* c
+ sd_bus_creds *c
uid_t *uid
int sd_bus_creds_has_effective_cap
- sd_bus_creds* c
+ sd_bus_creds *c
int capability
int sd_bus_creds_has_permitted_cap
- sd_bus_creds* c
+ sd_bus_creds *c
int capability
int sd_bus_creds_has_inheritable_cap
- sd_bus_creds* c
+ sd_bus_creds *c
int capability
int sd_bus_creds_has_bounding_cap
- sd_bus_creds* c
+ sd_bus_creds *c
int capability
int sd_bus_creds_get_selinux_context
- sd_bus_creds* c
+ sd_bus_creds *c
const char **context
int sd_bus_creds_get_audit_session_id
- sd_bus_creds* c
+ sd_bus_creds *c
uint32_t *sessionid
int sd_bus_creds_get_audit_login_uid
- sd_bus_creds* c
+ sd_bus_creds *c
uid_t *loginuid
int sd_bus_creds_get_unique_name
- sd_bus_creds* c
+ sd_bus_creds *c
const char **name
int sd_bus_creds_get_well_known_names
- sd_bus_creds* c
+ sd_bus_creds *c
char ***name
+
+ int sd_bus_creds_get_connection_name
+ sd_bus_creds *c
+ const char **name
+
+
Description
- Those functions return information from an
+ These functions return information from an
sd_bus_creds object. It may be created with
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
- comm field (name of the executable, as stored in
+ 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,50 +304,57 @@ 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 were
+ capabilities mask. A positive return value means that is was
set, zero means that it was not set, and a negative return
value signifies an error. See
- capabilities7
+ capabilities7
and Capabilities= and
CapabilityBoundingSet= settings in
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
@@ -381,7 +384,7 @@ along with systemd; If not, see .
- -ENODATA
+ -ENODATA
Given field is not available in
c.
@@ -389,36 +392,36 @@ along with systemd; If not, see .
- -ENOENT
+ -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.
- -ENXIO
+ -ENXIO
- An error occured in parsing cgroup paths.
+ An error occurred in parsing cgroup paths.
libsystemd might be out of sync with
the running systemd version.
- -EINVAL
+ -EINVAL
Specified pointer parameter is NULL.
- -ENOMEM
+ -ENOMEM
Memory allocation failed.
@@ -431,7 +434,7 @@ along with systemd; If not, see .
sd_bus_open_user() and other functions
described here are available as a shared library, which can be
compiled and linked to with the
- libsystemd pkg-config1
+ libsystemd pkg-config1
file.
@@ -441,11 +444,11 @@ along with systemd; If not, see .
systemd1,
sd-bus3,
- credentials7,
fork2,
execve2,
- free3,
- proc5,
+ credentials7,
+ free3,
+ proc5,
systemd.journald-fields7