PolkitUnixProcess: polkit Reference Manual

PolkitUnixProcess

PolkitUnixProcess — Unix processs

Functions

PolkitSubject *	polkit_unix_process_new ()
PolkitSubject *	polkit_unix_process_new_full ()
PolkitSubject *	polkit_unix_process_new_for_owner ()
void	polkit_unix_process_set_pid ()
gint	polkit_unix_process_get_pid ()
void	polkit_unix_process_set_start_time ()
guint64	polkit_unix_process_get_start_time ()
void	polkit_unix_process_set_uid ()
gint	polkit_unix_process_get_uid ()
gint	polkit_unix_process_get_owner ()

Properties

gint	pid	Read / Write / Construct
guint64	start-time	Read / Write / Construct
gint	uid	Read / Write / Construct

Types and Values

PolkitUnixProcess

Object Hierarchy

    GObject
    ╰── PolkitUnixProcess

Implemented Interfaces

PolkitUnixProcess implements PolkitSubject.

Description

An object for representing a UNIX process.

To uniquely identify processes, both the process id and the start time of the process (a monotonic increasing value representing the time since the kernel was started) is used.

Functions

polkit_unix_process_new ()

PolkitSubject *
polkit_unix_process_new (gint pid);

polkit_unix_process_new is deprecated and should not be used in newly-written code.

Creates a new PolkitUnixProcess for pid .

The uid and start time of the process will be looked up in using e.g. the /proc filesystem depending on the platform in use.

Parameters

pid

The process id.

Returns

A PolkitSubject. Free with g_object_unref().

[transfer full]

polkit_unix_process_new_full ()

PolkitSubject *
polkit_unix_process_new_full (gint pid,
                              guint64 start_time);

polkit_unix_process_new_full is deprecated and should not be used in newly-written code.

Creates a new PolkitUnixProcess object for pid and start_time .

The uid of the process will be looked up in using e.g. the /proc filesystem depending on the platform in use.

Parameters

pid	The process id.
start_time	The start time for `pid` .

Returns

A PolkitSubject. Free with g_object_unref().

[transfer full]

polkit_unix_process_new_for_owner ()

PolkitSubject *
polkit_unix_process_new_for_owner (gint pid,
                                   guint64 start_time,
                                   gint uid);

Creates a new PolkitUnixProcess object for pid , start_time and uid .

Parameters

pid	The process id.
start_time	The start time for `pid` or 0 to look it up in e.g. `/proc`.
uid	The (real, not effective) uid of the owner of `pid` or -1 to look it up in e.g. `/proc`.

Returns

A PolkitSubject. Free with g_object_unref().

[transfer full]

polkit_unix_process_set_pid ()

void
polkit_unix_process_set_pid (PolkitUnixProcess *process,
                             gint pid);

Sets pid for process .

Parameters

process	A PolkitUnixProcess.
pid	A process id.

polkit_unix_process_get_pid ()

gint
polkit_unix_process_get_pid (PolkitUnixProcess *process);

Gets the process id for process .

Parameters

process

A PolkitUnixProcess.

Returns

The process id for process .

polkit_unix_process_set_start_time ()

void
polkit_unix_process_set_start_time (PolkitUnixProcess *process,
                                    guint64 start_time);

Set the start time of process .

Parameters

process	A PolkitUnixProcess.
start_time	The start time for `pid` .

polkit_unix_process_get_start_time ()

guint64
polkit_unix_process_get_start_time (PolkitUnixProcess *process);

Gets the start time of process .

Parameters

process

A PolkitUnixProcess.

Returns

The start time of process .

polkit_unix_process_set_uid ()

void
polkit_unix_process_set_uid (PolkitUnixProcess *process,
                             gint uid);

Sets the (real, not effective) user id for process .

Parameters

process	A PolkitUnixProcess.
uid	The user id to set for `process` or -1 to unset it.

polkit_unix_process_get_uid ()

gint
polkit_unix_process_get_uid (PolkitUnixProcess *process);

Gets the user id for process . Note that this is the real user-id, not the effective user-id.

Parameters

process

A PolkitUnixProcess.

Returns

The user id for process or -1 if unknown.

polkit_unix_process_get_owner ()

gint
polkit_unix_process_get_owner (PolkitUnixProcess *process,
                               GError **error);

polkit_unix_process_get_owner is deprecated and should not be used in newly-written code.

(deprecated)

Parameters

process	A PolkitUnixProcess.
error	Return location for error.

Types and Values