.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1992 Drew Eckhardt, March 28, 1992
.\" and Copyright (c) 2002 Michael Kerrisk
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt <michael@moria.de>
.\" Modified 1993-07-23 by Rik Faith <faith@cs.unc.edu>
.\" Modified 1996-01-13 by Arnt Gulbrandsen <agulbra@troll.no>
.\" Modified 1996-01-22 by aeb, following a remark by
.\"          Tigran Aivazian <tigran@sco.com>
.\" Modified 1996-04-14 by aeb, following a remark by
.\"          Robert Bihlmeyer <robbe@orcus.ping.at>
.\" Modified 1996-10-22 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 2001-05-04 by aeb, following a remark by
.\"          Havard Lygre <hklygre@online.no>
.\" Modified 2001-04-17 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" Modified 2002-06-13 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"     Added note on non-standard behavior when SIGCHLD is ignored.
.\" Modified 2002-07-09 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"	Enhanced descriptions of 'resource' values for [gs]etrlimit()
.\" Modified 2003-11-28 by aeb, added RLIMIT_CORE
.\" Modified 2004-03-26 by aeb, added RLIMIT_AS
.\" Modified 2004-06-16 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"     Added notes on CAP_SYS_RESOURCE
.\"
.\" 2004-11-16 -- mtk: the getrlimit.2 page, which formally included
.\" coverage of getrusage(2), has been split, so that the latter
.\" is now covered in its own getrusage.2.
.\"
.\" Modified 2004-11-16, mtk: A few other minor changes
.\" Modified 2004-11-23, mtk
.\"	Added notes on RLIMIT_MEMLOCK, RLIMIT_NPROC, and RLIMIT_RSS
.\"		to "CONFORMING TO"
.\" Modified 2004-11-25, mtk
.\"	Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
.\"		2.6.9 changes.
.\"	Added note on RLIMIT_CPU error in older kernels
.\" 2004-11-03, mtk, Added RLIMIT_SIGPENDING
.\" 2005-07-13, mtk, documented RLIMIT_MSGQUEUE limit.
.\" 2005-07-28, mtk, Added descriptions of RLIMIT_NICE and RLIMIT_RTPRIO
.\"
.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated 1997-02-22, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Updated and Modified 2001-06-02, Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated and Modified 2001-08-18, Yuichi SATO
.\" Updated and Modified 2002-08-25, Yuichi SATO
.\" Updated and Modified 2004-01-17, Yuichi SATO
.\" Updated and Modified 2004-12-30, Yuichi SATO
.\" Updated and Modified 2005-09-10, Yuichi SATO
.\" Updated and Modified 2005-10-11, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated and Modified 2005-10-27, Akihiro MOTOKI
.\" Updated and Modified 2006-04-15, Akihiro MOTOKI, Catch up to LDP v2.29
.\"
.\"WORD:	resource		
.\"WORD:	limit			
.\"
.TH GETRLIMIT 2 2005-09-20 "Linux" "Linux Programmer's Manual"
.SH ̾
getrlimit, setrlimit \- 񸻤¤/ꤹ
.SH 
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.sp
.BI "int getrlimit(int " resource ", struct rlimit *" rlim );
.br
.BI "int setrlimit(int " resource ", const struct rlimit *" rlim );
.SH 
.BR getrlimit ()

.BR setrlimit ()
Ϥ줾 (resource)  (limit) ȼԤ
ƥ꥽ˤϡб륽եȡߥåȤȥϡɡߥåȤ롣
ߥåȤ
.RB ( getrlimit ()

.BR setrlimit ()

.I rlim
Ǥ)
.I rlimit
¤Τ:
.PP
.in +4n
.nf
struct rlimit {
    rlim_t rlim_cur;  /* եȡߥå */
    rlim_t rlim_max;  /* ϡɡߥå
                         (rlim_cur 꾮ʤ) */
};

.fi
.in
եȡߥåȤϡͥ뤬б꥽ФƲݤͤǤ롣
ϡɡߥåȤϥեȡߥåȤξ¤ȤƯ
øʤץϡեȡߥåȤͤ
0 ϡɡߥåȤϰϤꤹ뤳Ȥȡ
ϡɡߥåȤ򲼤뤳ȤΤߤǤ
(ٲϡɥߥåȤϾ夲ʤ)
øץ (Linux Ǥ
.B CAP_SYS_RESOURCE
ѥӥƥ (capability) ĥץ) 
եȡߥåȤȥϡɡߥåȤͳѹǤ롣
.PP

.B RLIM_INFINITY
ϥ꥽¤ʤȤɽ
(ͤ
.BR getrlimit ()
֤¤Τ
.BR setrlimit ()
Ϥ¤ΤξǻѤ)
.PP
.I resource
ϼΤ줫 1 ĤǤ롣
.TP
.B RLIMIT_AS
ץβۥ (ɥ쥹) κ祵 (Хñ)
.\" 2.0.27 / 2.1.12 ʹߡ
¤
.BR brk (2),
.BR mmap (2),
.BR mremap (2)
θƤӽФ˱ƶ¤Ķ
顼
.B ENOMEM
ǼԤ롣
ޤưŪʥåĥˤ⼺Ԥ
(
.BR sigaltstack (2)
ȤäإåѲǽˤƤʤäˤϡ
.B SIGSEGV
ƤΥץ kill )
ͤ \fIlong\fP ʤΤǡ32 ӥåȤ \fIlong\fP ĥޥǤϡ
¤Ϻ 2 GiB ˤʤ뤫λ񸻤̵¤ˤʤ롣
.TP
.B RLIMIT_CORE
.I core
եκ祵
0 ξ硢core եʤ
0 ʳξ硢Υ礭פڤͤ롣
.TP
.B RLIMIT_CPU
CPU ֤ξ (ÿ)
ץեȡߥåȤãˡ
.B SIGXCPU
ʥ롣
ΥʥФǥեȤưϡץνλǤ롣
ʥ򥭥åơϥɥ餬ᥤץ
֤ȤǤ롣
ץ CPU ֤Ȥ³ϡ
ϡɥߥåȤãޤ 1 ˥ץ
.B SIGXCPU
ꡢ
ϡɥߥåȤã
.B SIGKILL
롣
եȡߥåȤĶᤷȤưϡ
Linux 2.2  2.4 ΤΤǤ롣
եȡߥåȤĶ CPU ֤Ȥ³ץ
ˤĤƤμѲƤƤ롣
Υʥ򥭥åɬפΤ
ܿͤץꥱǤϡ
ǽ
.B SIGXCPU
äλ٤Ǥ롣
.TP
.B RLIMIT_DATA
ץΥǡ
(줿ǡƤʤǡҡ) κ͡
ΥߥåȤ
.BR brk (2)

.BR sbrk (2)
θƤӽФ˱ƶ롣
δؿϡΥ꥽ΥեȡߥåȤãȡ
顼
.B ENOMEM
ǼԤ롣
.TP
.B RLIMIT_FSIZE
ץǤե륵κ͡
ΥĶƥեĥȡ
.B SIGXFSZ
ʥ롣
ǥեȤǤϡΥʥϥץλ롣
ץ򥭥å뤳ȤǤ뤬
Ϣ륷ƥॳ
.RB ( write (2),
.BR truncate (2)
ʤ) ϥ顼
.B EFBIG
ǼԤ롣
.TP
.BR RLIMIT_LOCKS " ( Linux 2.4 Τ)"
.\" Τˤ Linux 2.4.0-test9 Τߡ2.4.25 / 2.5.65 ǤϤʤʤäƤ롣
Υץ¹ԤǤ
.BR flock (2)
å
.BR fcntl (2)
꡼ιͤ¤롣
.TP
.B RLIMIT_MEMLOCK
RAM ˥åǤκХȿ
ºݤˤϡ¤ϥƥڡκǤᤤܿ
ڤΤƤƴݤ롣
¤
.BR mlock (2),
.BR mlockall (2),
.BR mmap (2)

.B MAP_LOCKED
˱ƶ롣
Linux 2.6.9 ʹߤǤ
.BR shmctl (2)
.B SHM_LOCK
ˤƶ롣
ϸƤӽФץμ (real) 桼 ID ˥å
ͭꥻ
.RB ( shmget (2)
򻲾) ιץХȿκͤꤹ롣
.BR shmctl (2)
.B SHM_LOCK
ˤåϡ
.BR mlock (2),
.BR mlockall (2),
.BR mmap (2)

.B MAP_LOCKED
ˤäƳΩץΥåȤʬƿ롣
1 ĤΥץϤ¤ޤǤΥХȤåǤ롣
¤ˤ 2 Ĥμब롣
2.6.9  Linux ͥ Ǥϡ
¤øץˤäƥåιפ椷Ƥ
Linux 2.6.9 ʹߤǤϡøץåιפ¤Ϥʤ
ˤ¤øץåιפ
ŬѤ褦ˤʤä
.TP
.BR RLIMIT_MSGQUEUE " (Linux 2.6.8 ʹ)"
ƤӽФץμ¥桼 ID Фơ
POSIX å塼Τ˳ݤǤХȿ¤ꤹ롣
¤
.BR mq_open (3)
ФŬѤ롣
桼ơΥå塼ΥХȿ
ʲμˤ׻졢(Υ塼ޤǤδ)
¤η׻оݤ˴ޤ롣
.nf

    bytes = attr.mq_maxmsg * sizeof(struct msg_msg *) +
            attr.mq_maxmsg * attr.mq_msgsize

.fi

.I attr

.I mq_attr
¤ΤǤꡢ
.BR mq_open (3)
 4 Ȥƻꤵ롣

.I "sizeof(struct msg_msg *)"
(Linux/i386 Ǥ 4 Х) ޤǽβÿϡ
桼Ĺ 0 Υå̵¤˺ʤݾڤƤ
(Τ褦ʥåǤäƤ⡢
ϿΤΥСإåɤǥƥ񤹤)
.TP
.BR RLIMIT_NICE " (ͥ 2.6.12 ʹ, Ρ֥Хפ⻲)"
.BR setpriority (2)

.BR nice (2)
Ȥäư夲ץ nice ͤξ¤ꤹ롣
nice ͤμºݤξ¤
.I "20\ \-\ rlim_cur"
Ƿ׻
(Τ褦Ѥʾϡ꥽ͤȤοǤʤ
ȯ롣̾̤ͤʰ̣äƤ뤫Ǥ롣
㤨С̾
.B RLIM_INFINITY
ͤ \-1 Ǥ)
.TP
.B RLIMIT_NOFILE
ΥץץǤեǥץκͤ
1 礭ͤꤹ롣
.RB ( open (2),
.BR pipe (2),
.BR dup (2)
ʤɤˤ) ξ¤Ķ褦Ȥ硢顼
.B EMFILE
ȯ롣
.TP
.B RLIMIT_NPROC
ƤӽФץμ¥桼 ID ǺǤץ
(Τˤ Linux Ǥϥåɿ)
ξ¤ãȡ
.BR fork (2)
ϥ顼
.B EAGAIN
ǼԤ롣
.TP
.B RLIMIT_RSS
ץ resident set (RAM ¸ߤ벾ۥڡο) 
¤ (ڡ) ꤹ롣
¤ 2.4.30 Ǥƶʤ
.BR madvise (2)

.B MADV_WILLNEED
ꤷؿˤƶʤ
.\" ͥ 2.6.12 λǤϡ
.\" ¤ϥͥ 2.6 ǤϤޤԤʤ
.\" 򤵤뤫ˤĤƤ LKML ǻˤʤäƤ롣
.\"       -- MTK, Jul 05
.TP
.BR RLIMIT_RTPRIO " (Linux 2.6.12 ʹ, Х⻲)"
.BR sched_setscheduler (2)

.BR sched_setparam (2)
ȤäǤ롢ΥץΥꥢ륿ͥ٤ξ¤ꤹ롣
.TP
.BR RLIMIT_SIGPENDING " (Linux 2.6.8 ʹ)"
ƤӽФץμ¥桼 ID Ф
塼륷ʥο¤ꤹ롣
¤å뤿ᡢ
ɸॷʥȥꥢ륿ࡦʥξȤ롣
¤
.BR sigqueue (2)
ФƤ줺
.BR kill (2)
ȤȤǡΥץФƤޤ塼Ƥʤ
ʥΥ󥹥󥹤򥭥塼ˤ뤳ȤǤ
(Linux 2.6.8 ʹ)
.\" ϥͥ 2.6.7 ¸ߤ륷ƥΤ
.\" /proc/sys/kernel/rtsig-max ֤롣MTK Dec 04
.TP
.B RLIMIT_STACK
ץåκ祵Хñ̤ǻꤹ롣
ξ¤ãȡ
.B SIGSEGV
ʥ뤬롣
Υʥ򰷤ˤϡ
ץΥʥ륹å
.RB ( sigaltstack (2))
ѤʤФʤʤ
.PP
.B RLIMIT_OFILE

.B RLIMIT_NOFILE
 BSD Ǥ̾Ǥ롣
.PP
.SH ֤
 0 ֤롣顼ξ \-1 ֤졢
.I errno
Ŭڤͤꤵ롣
.SH 顼
.TP
.B EFAULT
.I rlim
ǽʥɥ쥹֤γؤƤ롣
.TP
.B EINVAL
.I resource
ͭǤʤ
ޤϡ
.BR setrlimit ()
ǡ
.I rlim\->rlim_cur

.I rlim\->rlim_max
礭ä
.TP
.B EPERM
øΤʤץ
.BR setrlimit ()
Ѥ
եȡߥåȤޤϥϡɡߥåȤ
ߤΥϡɡߥåȤ礭褦Ȼߤ
Ԥˤ
.B CAP_SYS_RESOURCE
ѥӥƥɬפǤ롣
ޤøΤʤץ
.BR setrlimit ()
Ѥ
եȤޤϥϡ
.B RLIMIT_NOFILE
ߥåȤ򸽺ߤΥͥκ
.RB ( NR_OPEN )
ʾä褦Ȥ
.SH 
SVr4, 4.3BSD, POSIX.1-2001.
.B RLIMIT_MEMLOCK

.B RLIMIT_NPROC
 BSD POSIX.1-2001 ˤϻꤵƤʤ
 BSD Ϥ Linux ¸ߤ뤬¾μϾʤ
.R RLIMIT_RSS
 BSD POSIX.1-2001 ˤϻꤵƤʤ
ˤؤ餺¿μ¸ߤ롣
.BR RLIMIT_MSGQUEUE ,
.BR RLIMIT_NICE ,
.BR RLIMIT_RTPRIO ,
.B RLIMIT_SIGPENDING
 Linux ͭΤΤǤ롣
.SH 
.BR fork (2)
Ǻ줿줿ҥץϡ
ƥץΥ꥽¤Ѿ롣
.BR execve (2)
ǥ꥽¤¸롣
.SH Х
 Linux ͥǤϡץեȤޤϥϡ
.B RLIMIT_CPU
ߥåȤã
.B SIGXCPU

.B SIGKILL
ʥ뤬٤ 1 (CPU) øƤޤ
ϥͥ 2.6.8 ǽ줿

2.6.17  2.6.x ͥǤϡ
.B RLIMIT_CPU
ߥåȤ 0 ξ硢
.RB ( RLIM_INFINITY
Ʊ褦) ¤ʤפȴְäƲᤵƤ
ͥ 2.6.17 ʹߤǤϡߥåȤ 0 ꤷˤ
̤Ĥ褦ˤʤäƤ뤬ºݤˤϥߥåȤͤ 1 äȤʤ롣
.\" see http://marc.theaimsgroup.com/?l=linux-kernel&m=114008066530167&w=2

ͥ 2.6.12 ˤϡ
.B RLIMIT_RTPRIO
ưʤȤХ롣ϥͥ 2.6.13 ǽƤ롣

ͥ 2.6.12 Ǥϡ
.BR getpriority (2)

.B RLIMIT_NICE
֤ͥ٤ϰϤĤƤΤᡢnice ͤμºݤξ¤
.I "19\ \-\ rlim_cur"
ˤʤäƤޤȤƶäϥͥ 2.6.13 ǽ줿
.\" : http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2

2.4.22 ΥͥǤϡ
.I rlim\->rlim_cur

.I rlim\->rlim_max
礭ä硢
.BR setrlimit ()
Ǥ
.B EINVAL
顼򸡽ФǤʤ
.SH Ϣ
.BR dup (2),
.BR fcntl (2),
.BR fork (2),
.BR getrusage (2),
.BR mlock (2),
.BR mmap (2),
.BR open (2),
.BR quotactl (2),
.BR sbrk (2),
.BR shmctl (2),
.BR sigqueue (2),
.BR malloc (3),
.BR ulimit (3),
.BR core (5),
.BR capabilities (7),
.BR signal (7)