Blame doc/reference/html/libgtop-Process-List.html

Packit d37888
Packit d37888
<html>
Packit d37888
<head>
Packit d37888
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit d37888
<title>Process List: Libgtop Reference Manual</title>
Packit d37888
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit d37888
<link rel="home" href="index.html" title="Libgtop Reference Manual">
Packit d37888
<link rel="up" href="libgtop-lib.html" title="Libgtop Library Reference">
Packit d37888
<link rel="prev" href="libgtop-version.html" title="version">
Packit d37888
<link rel="next" href="libgtop-sem-limits.html" title="sem_limits">
Packit d37888
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
Packit d37888
<link rel="stylesheet" href="style.css" type="text/css">
Packit d37888
</head>
Packit d37888
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit d37888
Packit d37888
Packit d37888
Top  | 
Packit d37888
                  Description
Packit d37888
Packit d37888
Home
Packit d37888
Up
Packit d37888
Prev
Packit d37888
Next
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Process List

Packit d37888

Process List — List running processes

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Stability Level

Packit d37888
Stable, unless otherwise indicated
Packit d37888
Packit d37888
Packit d37888

Functions

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
pid_t *
Packit d37888
Packit d37888
Packit d37888
glibtop_get_proclist ()
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Types and Values

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_ALL
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_PID
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_PGRP
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_SESSION
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_TTY
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_UID
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_RUID
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_KERN_PROC_MASK
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_EXCLUDE_IDLE
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_EXCLUDE_SYSTEM
Packit d37888
Packit d37888
Packit d37888
#define
Packit d37888
GLIBTOP_EXCLUDE_NOTTY
Packit d37888
Packit d37888
Packit d37888
struct
Packit d37888
glibtop_proclist
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Includes

Packit d37888
#include <glibtop/proclist.h>
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Description

Packit d37888
Packit d37888
Packit d37888

Functions

Packit d37888
Packit d37888

glibtop_get_proclist ()

Packit d37888
pid_t *
Packit d37888
glibtop_get_proclist (glibtop_proclist *buf,
Packit d37888
                      gint64 which,
Packit d37888
                      gint64 arg);
Packit d37888
Packit d37888

Parameters

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

buf

Packit d37888

Extra return information, see glibtop_proclist.

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888

which

Packit d37888

Criteria for processes in returned list. See the GLIBTOP_KERN_PROC_* and GLIBTOP_EXCLUDE_* constants.

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888

arg

Packit d37888

Extra arguments applied to which

Packit d37888
.  Only GLIBTOP_KERN_PROC_* constants take arguments, see each constant definition for particular arg
Packit d37888
description.

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Returns

Packit d37888

A list of running processes or NULL on error. The

Packit d37888
returned list is allocated using g_malloc and must be
Packit d37888
freed using g_free to avoid a memory leak.

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Types and Values

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_ALL

Packit d37888
#define GLIBTOP_KERN_PROC_ALL		0
Packit d37888
Packit d37888

Return information about all processes

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_PID

Packit d37888
#define GLIBTOP_KERN_PROC_PID		1
Packit d37888
Packit d37888

Return all processes with the pid which is passed in arg

Packit d37888
. You can use this to find out whether some process still exists.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_PGRP

Packit d37888
#define GLIBTOP_KERN_PROC_PGRP		2
Packit d37888
Packit d37888

Return all processes in the process group passed in arg

Packit d37888
.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_SESSION

Packit d37888
#define GLIBTOP_KERN_PROC_SESSION 3
Packit d37888
Packit d37888

Return all processes in the session passed in arg

Packit d37888
.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_TTY

Packit d37888
#define GLIBTOP_KERN_PROC_TTY		4
Packit d37888
Packit d37888

Return all processes which have the controlling tty passed in arg

Packit d37888
Packit d37888
(which is interpreted as the device number).

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_UID

Packit d37888
#define GLIBTOP_KERN_PROC_UID		5
Packit d37888
Packit d37888

Return all processes with the effective uid passed in arg

Packit d37888
.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_RUID

Packit d37888
#define GLIBTOP_KERN_PROC_RUID		6
Packit d37888
Packit d37888

Return all processes with the real uid passed in arg

Packit d37888
.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_KERN_PROC_MASK

Packit d37888
#define GLIBTOP_KERN_PROC_MASK		15
Packit d37888
Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_EXCLUDE_IDLE

Packit d37888
#define GLIBTOP_EXCLUDE_IDLE		0x1000
Packit d37888
Packit d37888

Exclude idle processes.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_EXCLUDE_SYSTEM

Packit d37888
#define GLIBTOP_EXCLUDE_SYSTEM		0x2000
Packit d37888
Packit d37888

Exclude system (on most UNIXes root's) processes.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

GLIBTOP_EXCLUDE_NOTTY

Packit d37888
#define GLIBTOP_EXCLUDE_NOTTY		0x4000
Packit d37888
Packit d37888

Exclude processes without a controlling terminal.

Packit d37888
Packit d37888

Packit d37888
Packit d37888

struct glibtop_proclist

Packit d37888
struct glibtop_proclist {
Packit d37888
	guint64 flags;
Packit d37888
	guint64 number;			/* GLIBTOP_PROCLIST_NUMBER */
Packit d37888
	guint64 total;			/* GLIBTOP_PROCLIST_TOTAL */
Packit d37888
	guint64 size;			/* GLIBTOP_PROCLIST_SIZE */
Packit d37888
};
Packit d37888
Packit d37888
Packit d37888

Members

Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

guint64 flags;

Packit d37888
 
Packit d37888
 
Packit d37888
Packit d37888
Packit d37888

guint64 number;

Packit d37888

Number of entries in the returned list.

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888

guint64 total;

Packit d37888

Total size of the returned list (this equals number

Packit d37888
* size
Packit d37888
).

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888

guint64 size;

Packit d37888

Size of a single entry in the returned list

Packit d37888
(this equals sizeof(unsigned)).

Packit d37888
 
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888
Packit d37888

Generated by GTK-Doc V1.25
Packit d37888
</body>
Packit d37888
</html>