X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_bus_creds_get_pid.xml;h=d61ec19cb84ff7f5d8ace5dc7e5d02cb0f0916dd;hp=d7514bb5d1bc0564583628b53a99bff9a42fba87;hb=e45fc5e738b0b7700e8b4f3c4b25c58a49b44b27;hpb=5485de1edbfd442e0727f699a50c489d815d771d diff --git a/man/sd_bus_creds_get_pid.xml b/man/sd_bus_creds_get_pid.xml index d7514bb5d..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,281 +77,284 @@ 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 - UID (user identifier). + sd_bus_creds_get_uid() will retrieve the + numeric UID (user identifier). - sd_bus_creds_get_gid will retrieve the - GID (group identifier). + 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 - the UID (user identifier) of the user who owns the slice + 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 . - 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 - retrieve the SELinux context of the process. + 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,44 +384,44 @@ along with systemd; If not, see . - -ENODATA + -ENODATA Given field is not available in c. - + - -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. - libsystemd-bus might be out of sync with + 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-bus 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