2012-09-24 16:54:51 +00:00
|
|
|
/*
|
|
|
|
* virprocess.h: interaction with processes
|
|
|
|
*
|
2015-01-08 14:36:54 +00:00
|
|
|
* Copyright (C) 2010-2015 Red Hat, Inc.
|
2012-09-24 16:54:51 +00:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library. If not, see
|
|
|
|
* <http://www.gnu.org/licenses/>.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2019-06-18 16:13:08 +00:00
|
|
|
#pragma once
|
2012-09-24 16:54:51 +00:00
|
|
|
|
2019-06-18 16:13:08 +00:00
|
|
|
#include <sys/types.h>
|
2012-09-24 16:54:51 +00:00
|
|
|
|
2019-06-18 16:13:08 +00:00
|
|
|
#include "internal.h"
|
|
|
|
#include "virbitmap.h"
|
|
|
|
#include "virenum.h"
|
2015-01-08 14:36:54 +00:00
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
VIR_PROC_POLICY_NONE = 0,
|
|
|
|
VIR_PROC_POLICY_BATCH,
|
|
|
|
VIR_PROC_POLICY_IDLE,
|
|
|
|
VIR_PROC_POLICY_FIFO,
|
|
|
|
VIR_PROC_POLICY_RR,
|
|
|
|
|
|
|
|
VIR_PROC_POLICY_LAST
|
|
|
|
} virProcessSchedPolicy;
|
|
|
|
|
|
|
|
VIR_ENUM_DECL(virProcessSchedPolicy);
|
2012-09-24 16:54:51 +00:00
|
|
|
|
2012-09-24 17:10:37 +00:00
|
|
|
char *
|
|
|
|
virProcessTranslateStatus(int status);
|
|
|
|
|
|
|
|
void
|
|
|
|
virProcessAbort(pid_t pid);
|
|
|
|
|
2019-10-14 12:07:39 +00:00
|
|
|
void virProcessExitWithStatus(int status) G_GNUC_NORETURN;
|
2014-02-20 03:04:40 +00:00
|
|
|
|
2012-09-24 17:10:37 +00:00
|
|
|
int
|
2014-02-20 03:23:44 +00:00
|
|
|
virProcessWait(pid_t pid, int *exitstatus, bool raw)
|
2019-10-14 12:25:14 +00:00
|
|
|
G_GNUC_WARN_UNUSED_RESULT;
|
2012-09-24 17:10:37 +00:00
|
|
|
|
2012-09-24 16:54:51 +00:00
|
|
|
int virProcessKill(pid_t pid, int sig);
|
|
|
|
|
2012-09-26 14:42:58 +00:00
|
|
|
int virProcessKillPainfully(pid_t pid, bool force);
|
2018-08-02 07:05:18 +00:00
|
|
|
int virProcessKillPainfullyDelay(pid_t pid,
|
|
|
|
bool force,
|
|
|
|
unsigned int extradelay);
|
2012-09-26 14:42:58 +00:00
|
|
|
|
2021-03-11 07:16:13 +00:00
|
|
|
int virProcessSetAffinity(pid_t pid, virBitmap *map, bool quiet);
|
2012-12-13 14:58:41 +00:00
|
|
|
|
2021-03-11 07:16:13 +00:00
|
|
|
virBitmap *virProcessGetAffinity(pid_t pid);
|
2012-09-24 17:10:37 +00:00
|
|
|
|
2015-06-01 12:31:44 +00:00
|
|
|
int virProcessGetPids(pid_t pid, size_t *npids, pid_t **pids);
|
|
|
|
|
2013-04-25 16:05:00 +00:00
|
|
|
int virProcessGetStartTime(pid_t pid,
|
|
|
|
unsigned long long *timestamp);
|
|
|
|
|
2012-12-21 16:50:18 +00:00
|
|
|
int virProcessGetNamespaces(pid_t pid,
|
|
|
|
size_t *nfdlist,
|
|
|
|
int **fdlist);
|
|
|
|
|
|
|
|
int virProcessSetNamespaces(size_t nfdlist,
|
|
|
|
int *fdlist);
|
|
|
|
|
2019-10-15 11:24:34 +00:00
|
|
|
int virProcessSetMaxMemLock(pid_t pid, unsigned long long bytes) G_GNUC_NO_INLINE;
|
2013-04-25 16:10:10 +00:00
|
|
|
int virProcessSetMaxProcesses(pid_t pid, unsigned int procs);
|
|
|
|
int virProcessSetMaxFiles(pid_t pid, unsigned int files);
|
2015-03-18 11:14:55 +00:00
|
|
|
int virProcessSetMaxCoreSize(pid_t pid, unsigned long long bytes);
|
2014-01-30 13:11:23 +00:00
|
|
|
|
2021-03-05 16:55:39 +00:00
|
|
|
int virProcessGetMaxMemLock(pid_t pid, unsigned long long *bytes) G_GNUC_NO_INLINE;
|
2015-11-20 16:06:41 +00:00
|
|
|
|
2014-01-30 13:11:23 +00:00
|
|
|
/* Callback to run code within the mount namespace tied to the given
|
|
|
|
* pid. This function must use only async-signal-safe functions, as
|
|
|
|
* it gets run after a fork of a multi-threaded process. The return
|
|
|
|
* value of this function is passed to _exit(), except that a
|
2014-02-19 19:39:44 +00:00
|
|
|
* negative value is treated as EXIT_CANCELED. */
|
2014-01-30 13:11:23 +00:00
|
|
|
typedef int (*virProcessNamespaceCallback)(pid_t pid, void *opaque);
|
|
|
|
|
|
|
|
int virProcessRunInMountNamespace(pid_t pid,
|
|
|
|
virProcessNamespaceCallback cb,
|
|
|
|
void *opaque);
|
2015-01-08 14:36:54 +00:00
|
|
|
|
2018-10-16 08:50:33 +00:00
|
|
|
/**
|
|
|
|
* virProcessForkCallback:
|
|
|
|
* @ppid: parent's pid
|
|
|
|
* @opaque: opaque data
|
|
|
|
*
|
|
|
|
* Callback to run in fork()-ed process.
|
|
|
|
*
|
|
|
|
* Returns: 0 on success,
|
|
|
|
* -1 on error (treated as EXIT_CANCELED)
|
|
|
|
*/
|
|
|
|
typedef int (*virProcessForkCallback)(pid_t ppid,
|
|
|
|
void *opaque);
|
|
|
|
|
|
|
|
int virProcessRunInFork(virProcessForkCallback cb,
|
2019-04-15 11:45:38 +00:00
|
|
|
void *opaque)
|
2019-10-15 11:24:34 +00:00
|
|
|
G_GNUC_NO_INLINE;
|
2018-10-16 08:50:33 +00:00
|
|
|
|
2016-11-10 13:55:48 +00:00
|
|
|
int virProcessSetupPrivateMountNS(void);
|
|
|
|
|
2015-01-08 14:36:54 +00:00
|
|
|
int virProcessSetScheduler(pid_t pid,
|
|
|
|
virProcessSchedPolicy policy,
|
|
|
|
int priority);
|
2017-01-11 09:23:39 +00:00
|
|
|
typedef enum {
|
|
|
|
VIR_PROCESS_NAMESPACE_MNT = (1 << 1),
|
|
|
|
VIR_PROCESS_NAMESPACE_IPC = (1 << 2),
|
|
|
|
VIR_PROCESS_NAMESPACE_NET = (1 << 3),
|
|
|
|
VIR_PROCESS_NAMESPACE_PID = (1 << 4),
|
|
|
|
VIR_PROCESS_NAMESPACE_USER = (1 << 5),
|
|
|
|
VIR_PROCESS_NAMESPACE_UTS = (1 << 6),
|
|
|
|
} virProcessNamespaceFlags;
|
|
|
|
|
|
|
|
int virProcessNamespaceAvailable(unsigned int ns);
|