PolkitUnixProcess

## PolkitUnixProcess PolkitUnixProcess — Unix processs |

## Synopsis

                        PolkitUnixProcess;
    PolkitSubject *     polkit_unix_process_new             (gint pid);
    PolkitSubject *     polkit_unix_process_new_full        (gint pid,
                                                             guint64 start_time);
    PolkitSubject *     polkit_unix_process_new_for_owner   (gint pid,
                                                             guint64 start_time,
                                                             gint uid);
    void                polkit_unix_process_set_pid         (PolkitUnixProcess *process,
                                                             gint pid);
    gint                polkit_unix_process_get_pid         (PolkitUnixProcess *process);
    void                polkit_unix_process_set_start_time  (PolkitUnixProcess *process,
                                                             guint64 start_time);
    guint64             polkit_unix_process_get_start_time  (PolkitUnixProcess *process);
    void                polkit_unix_process_set_uid         (PolkitUnixProcess *process,
                                                             gint uid);
    gint                polkit_unix_process_get_uid         (PolkitUnixProcess *process);

## Object Hierarchy

      GObject
       +----PolkitUnixProcess

## Implemented Interfaces

PolkitUnixProcess implements PolkitSubject.

## Properties

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

## 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.

## Details

### PolkitUnixProcess

    typedef struct _PolkitUnixProcess PolkitUnixProcess;

The PolkitUnixProcess struct should not be accessed directly.

### polkit_unix_process_new ()

    PolkitSubject *     polkit_unix_process_new             (gint pid);

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.

`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);

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.

`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`.

`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`.

`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`.

`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`.

`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`.

`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`.

`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.

`process` : | A PolkitUnixProcess.
Returns : | The user id for `process` or -1 if unknown.

## Property Details

### The `"pid"` property

      "pid"                      gint                  : Read / Write / Construct

The UNIX process id.

Allowed values: >= 0

Default value: 0

### The `"start-time"` property

      "start-time"               guint64               : Read / Write / Construct

The start time of the process.

Default value: 0

### The `"uid"` property

      "uid"                      gint                  : Read / Write / Construct

The UNIX user id of the process or -1 if unknown.

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

Allowed values: >= -1

Default value: -1