glibc/resource/sys/resource.h

155 lines
5.7 KiB
C

/* Copyright (C) 1992, 1994 Free Software Foundation, Inc.
This file is part of the GNU C Library.
The GNU C Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
The GNU C 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with the GNU C Library; see the file COPYING.LIB. If
not, write to the Free Software Foundation, Inc., 675 Mass Ave,
Cambridge, MA 02139, USA. */
#ifndef _SYS_RESOURCE_H
#define _SYS_RESOURCE_H 1
#include <features.h>
__BEGIN_DECLS
/* Get the system-dependent definitions of RLIM_*. */
#include <resourcebits.h>
struct rlimit
{
/* The current (soft) limit. */
int rlim_cur;
/* The hard limit. */
int rlim_max;
};
/* Value used to indicate that there is no limit. */
#define RLIM_INFINITY 0x7fffffff
/* Put the soft and hard limits for RESOURCE in *RLIMITS.
Returns 0 if successful, -1 if not (and sets errno). */
int getrlimit __P ((enum __rlimit_resource __resource,
struct rlimit * __rlimits));
/* Set the soft and hard limits for RESOURCE to *RLIMITS.
Only the super-user can increase hard limits.
Return 0 if successful, -1 if not (and sets errno). */
int setrlimit __P ((enum __rlimit_resource __resource,
struct rlimit * __rlimits));
/* Whose usage statistics do you want? */
enum __rusage_who
/* The macro definitions are necessary because some programs want
to test for operating system features with #ifdef RUSAGE_SELF.
In ANSI C the reflexive definition is a no-op. */
{
/* The calling process. */
RUSAGE_SELF = 0,
#define RUSAGE_SELF RUSAGE_SELF
/* All of its terminated child processes. */
RUSAGE_CHILDREN = -1,
#define RUSAGE_CHILDREN RUSAGE_CHILDREN
};
#include <sys/time.h> /* For `struct timeval'. */
/* Structure which says how much of each resource has been used. */
struct rusage
{
/* Total amount of user time used. */
struct timeval ru_utime;
/* Total amount of system time used. */
struct timeval ru_stime;
/* Maximum resident set size (in kilobytes). */
long ru_maxrss;
/* Amount of sharing of text segment memory
with other processes (kilobyte-seconds). */
long ru_ixrss;
/* Amount of data segment memory used (kilobyte-seconds). */
long ru_idrss;
/* Amount of stack memory used (kilobyte-seconds). */
long ru_isrss;
/* Number of soft page faults (i.e. those serviced by reclaiming
a page from the list of pages awaiting reallocation. */
long ru_minflt;
/* Number of hard page faults (i.e. those that required I/O). */
long ru_majflt;
/* Number of times a process was swapped out of physical memory. */
long ru_nswap;
/* Number of input operations via the file system. Note: This
and `ru_oublock' do not include operations with the cache. */
long ru_inblock;
/* Number of output operations via the file system. */
long ru_oublock;
/* Number of IPC messages sent. */
long ru_msgsnd;
/* Number of IPC messages received. */
long ru_msgrcv;
/* Number of signals delivered. */
long ru_nsignals;
/* Number of voluntary context switches, i.e. because the process
gave up the process before it had to (usually to wait for some
resource to be available). */
long ru_nvcsw;
/* Number of involuntary context switches, i.e. a higher priority process
became runnable or the current process used up its time slice. */
long ru_nivcsw;
};
/* Return resource usage information on process indicated by WHO
and put it in *USAGE. Returns 0 for success, -1 for failure. */
int __getrusage __P ((enum __rusage_who __who, struct rusage * __usage));
int getrusage __P ((enum __rusage_who __who, struct rusage * __usage));
/* Function depends on CMD:
1 = Return the limit on the size of a file, in units of 512 bytes.
2 = Set the limit on the size of a file to NEWLIMIT. Only the
super-user can increase the limit.
3 = Return the maximum possible address of the data segment.
4 = Return the maximum number of files that the calling process can open.
Returns -1 on errors. */
long int __ulimit __P ((int __cmd, long int __newlimit));
long int ulimit __P ((int __cmd, long int __newlimit));
/* Priority limits. */
#define PRIO_MIN -20 /* Minimum priority a process can have. */
#define PRIO_MAX 20 /* Maximum priority a process can have. */
/* The type of the WHICH argument to `getpriority' and `setpriority',
indicating what flavor of entity the WHO argument specifies. */
enum __priority_which
{
PRIO_PROCESS = 0, /* WHO is a process ID. */
PRIO_PGRP = 1, /* WHO is a process group ID. */
PRIO_USER = 2, /* WHO is a user ID. */
};
/* Return the highest priority of any process specified by WHICH and WHO
(see above); if WHO is zero, the current process, process group, or user
(as specified by WHO) is used. A lower priority number means higher
priority. Priorities range from PRIO_MIN to PRIO_MAX (above). */
extern int getpriority __P ((enum __priority_which __which, int __who));
/* Set the priority of all processes specified by WHICH and WHO (see above)
to PRIO. Returns 0 on success, -1 on errors. */
extern int setpriority __P ((enum __priority_which __which, int __who,
int __prio));
__END_DECLS
#endif /* resource.h */