1 This file is ulimit.def, from which is created ulimit.c.
2 It implements the builtin "ulimit" in Bash.
4 Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
6 This file is part of GNU Bash, the Bourne Again SHell.
8 Bash is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 1, or (at your option) any later
13 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License along
19 with Bash; see the file COPYING. If not, write to the Free Software
20 Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
25 $FUNCTION ulimit_builtin
27 $SHORT_DOC ulimit [-SHacdflmnpstuv] [limit]
28 Ulimit provides control over the resources available to processes
29 started by the shell, on systems that allow such control. If an
30 option is given, it is interpreted as follows:
32 -S use the `soft' resource limit
33 -H use the `hard' resource limit
34 -a all current limits are reported
35 -c the maximum size of core files created
36 -d the maximum size of a process's data segment
37 -f the maximum size of files created by the shell
38 -l the maximum size a process may lock into memory
39 -m the maximum resident set size
40 -n the maximum number of open file descriptors
41 -p the pipe buffer size
42 -s the maximum stack size
43 -t the maximum amount of cpu time in seconds
44 -u the maximum number of user processes
45 -v the size of virtual memory
47 If LIMIT is given, it is the new value of the specified resource.
48 Otherwise, the current value of the specified resource is printed.
49 If no option is given, then -f is assumed. Values are in 1024-byte
50 increments, except for -t, which is in seconds, -p, which is in
51 increments of 512 bytes, and -u, which is an unscaled number of
59 #include "../bashtypes.h"
61 # include <sys/param.h>
64 #if defined (HAVE_UNISTD_H)
73 #include "bashgetopt.h"
80 /* For some reason, HPUX chose to make these definitions visible only if
81 _KERNEL is defined, so we define _KERNEL before including <sys/resource.h>
82 and #undef it afterward. */
83 #if defined (HAVE_RESOURCE)
84 # include <sys/time.h>
85 # if defined (HPUX) && defined (RLIMIT_NEEDS_KERNEL)
88 # include <sys/resource.h>
89 # if defined (HPUX) && defined (RLIMIT_NEEDS_KERNEL)
93 # include <sys/times.h>
96 #if defined (HAVE_LIMITS_H)
100 /* Check for the most basic symbols. If they aren't present, this
101 system's <sys/resource.h> isn't very useful to us. */
102 #if !defined (RLIMIT_FSIZE) || !defined (HAVE_GETRLIMIT)
103 # undef HAVE_RESOURCE
106 #if !defined (RLIMTYPE)
107 # define RLIMTYPE long
108 # define string_to_rlimtype(s) strtol(s, (char **)NULL, 10)
109 # define print_rlimtype(num, nl) printf ("%ld%s", num, nl ? "\n" : "")
112 #define DESCFMT "%-28s"
114 /* Some systems use RLIMIT_NOFILE, others use RLIMIT_OFILE */
115 #if defined (HAVE_RESOURCE) && defined (RLIMIT_OFILE) && !defined (RLIMIT_NOFILE)
116 # define RLIMIT_NOFILE RLIMIT_OFILE
117 #endif /* HAVE_RESOURCE && RLIMIT_OFILE && !RLIMIT_NOFILE */
119 /* Some systems have these, some do not. */
121 # define RLIMIT_FILESIZE RLIMIT_FSIZE
123 # define RLIMIT_FILESIZE 256
126 #define RLIMIT_PIPESIZE 257
129 # define RLIMIT_OPENFILES RLIMIT_NOFILE
131 # define RLIMIT_OPENFILES 258
135 # define RLIMIT_VIRTMEM RLIMIT_VMEM
136 # define RLIMIT_VMBLKSZ 1024
139 # define RLIMIT_VIRTMEM RLIMIT_AS
140 # define RLIMIT_VMBLKSZ 1024
142 # define RLIMIT_VIRTMEM 259
143 # define RLIMIT_VMBLKSZ 1
148 # define RLIMIT_MAXUPROC RLIMIT_NPROC
150 # define RLIMIT_MAXUPROC 260
153 #if !defined (RLIM_INFINITY)
154 # define RLIM_INFINITY 0x7fffffff
157 #define LIMIT_HARD 0x01
158 #define LIMIT_SOFT 0x02
160 static int ulimit_internal __P((int, char *, int, int));
161 static void printone __P((int, RLIMTYPE, int));
162 static void print_all_limits __P((int));
164 static int get_limit __P((int, int, RLIMTYPE *));
165 static int set_limit __P((int, RLIMTYPE, int));
167 static int filesize __P((RLIMTYPE *));
168 static int pipesize __P((RLIMTYPE *));
169 static int getmaxuprc __P((int, RLIMTYPE *));
170 static int getmaxvm __P((int, RLIMTYPE *));
173 int option; /* The ulimit option for this limit. */
174 int parameter; /* Parameter to pass to get_limit (). */
175 int block_factor; /* Blocking factor for specific limit. */
176 char *description; /* Descriptive string to output. */
179 static RESOURCE_LIMITS limits[] = {
181 { 'c', RLIMIT_CORE, 1024, "core file size (blocks)" },
184 { 'd', RLIMIT_DATA, 1024, "data seg size (kbytes)" },
186 { 'f', RLIMIT_FILESIZE, 1024, "file size (blocks)" },
187 #ifdef RLIMIT_MEMLOCK
188 { 'l', RLIMIT_MEMLOCK, 1024, "max locked memory (kbytes)" },
191 { 'm', RLIMIT_RSS, 1024, "max memory size (kbytes)" },
192 #endif /* RLIMIT_RSS */
193 { 'n', RLIMIT_OPENFILES, 1, "open files" },
194 { 'p', RLIMIT_PIPESIZE, 512, "pipe size (512 bytes)" },
196 { 's', RLIMIT_STACK, 1024, "stack size (kbytes)" },
199 { 't', RLIMIT_CPU, 1, "cpu time (seconds)" },
200 #endif /* RLIMIT_CPU */
201 { 'u', RLIMIT_MAXUPROC, 1, "max user processes" },
202 #if defined (HAVE_RESOURCE)
203 { 'v', RLIMIT_VIRTMEM, RLIMIT_VMBLKSZ, "virtual memory (kbytes)" },
205 { -1, -1, -1, (char *)NULL }
207 #define NCMDS (sizeof(limits) / sizeof(limits[0]))
209 typedef struct _cmd {
214 static ULCMD *cmdlist;
216 static int cmdlistsz;
218 #if !defined (HAVE_RESOURCE) && !defined (HAVE_ULIMIT)
227 #endif /* !HAVE_RESOURCE && !HAVE_ULIMIT */
235 for (i = 0; limits[i].option > 0; i++)
236 if (limits[i].option == opt)
241 static char optstring[4 + 2 * NCMDS];
243 /* Report or set limits associated with certain per-process resources.
244 See the help documentation in builtins.c for a full description. */
246 ulimit_builtin (list)
247 register WORD_LIST *list;
250 int c, limind, mode, opt, all_limits;
256 /* Idea stolen from pdksh -- build option string the first time called. */
257 if (optstring[0] == 0)
260 *s++ = 'a'; *s++ = 'S'; *s++ = 'H';
261 for (c = 0; limits[c].option > 0; c++)
263 *s++ = limits[c].option;
269 /* Initialize the command list. */
271 cmdlist = (ULCMD *)xmalloc ((cmdlistsz = 16) * sizeof (ULCMD));
274 reset_internal_getopt ();
275 while ((opt = internal_getopt (list, optstring)) != -1)
283 /* -S and -H are modifiers, not real options. */
297 if (ncmd >= cmdlistsz)
298 cmdlist = (ULCMD *)xrealloc (cmdlist, (cmdlistsz *= 2) * sizeof (ULCMD));
299 cmdlist[ncmd].cmd = opt;
300 cmdlist[ncmd++].arg = list_optarg;
308 print_all_limits (mode == 0 ? LIMIT_SOFT : mode);
309 return (EXECUTION_SUCCESS);
312 /* default is `ulimit -f' */
315 cmdlist[ncmd].cmd = 'f';
316 /* `ulimit something' is same as `ulimit -f something' */
317 cmdlist[ncmd++].arg = list ? list->word->word : (char *)NULL;
322 /* verify each command in the list. */
323 for (c = 0; c < ncmd; c++)
325 limind = _findlim (cmdlist[c].cmd);
328 builtin_error ("bad command: `%c'", cmdlist[c].cmd);
333 for (c = 0; c < ncmd; c++)
334 if (ulimit_internal (cmdlist[c].cmd, cmdlist[c].arg, mode, ncmd > 1) == EXECUTION_FAILURE)
335 return (EXECUTION_FAILURE);
337 return (EXECUTION_SUCCESS);
341 ulimit_internal (cmd, cmdarg, mode, multiple)
346 int opt, limind, setting;
348 RLIMTYPE current_limit, real_limit, limit;
350 setting = cmdarg != 0;
351 limind = _findlim (cmd);
353 mode = setting ? (LIMIT_HARD|LIMIT_SOFT) : LIMIT_SOFT;
354 opt = get_limit (limind, mode, ¤t_limit);
357 builtin_error ("cannot get limit: %s", strerror (errno));
358 return (EXECUTION_FAILURE);
361 if (setting == 0) /* print the value of the specified limit */
363 printone (limind, current_limit, multiple);
364 return (EXECUTION_SUCCESS);
367 /* Setting the limit. */
368 if (STREQ (cmdarg, "unlimited"))
369 limit = RLIM_INFINITY;
370 else if (all_digits (cmdarg))
371 limit = string_to_rlimtype (cmdarg);
374 builtin_error ("bad non-numeric arg `%s'", cmdarg);
375 return (EXECUTION_FAILURE);
378 block_factor = (limit == RLIM_INFINITY) ? 1 : limits[limind].block_factor;
379 real_limit = limit * block_factor;
381 if (real_limit < 0 || (real_limit == 0 && limit != 0))
383 builtin_error ("limit out of range: %d", limit);
384 return (EXECUTION_FAILURE);
387 if (set_limit (limind, real_limit, mode) < 0)
389 builtin_error ("cannot modify limit: %s", strerror (errno));
390 return (EXECUTION_FAILURE);
392 return (EXECUTION_SUCCESS);
396 get_limit (ind, mode, limptr)
401 #if defined (HAVE_RESOURCE)
405 if (limits[ind].parameter >= 256)
407 switch (limits[ind].parameter)
409 case RLIMIT_FILESIZE:
410 if (filesize (&value) < 0)
413 case RLIMIT_PIPESIZE:
414 if (pipesize (&value) < 0)
417 case RLIMIT_OPENFILES:
418 value = (RLIMTYPE)getdtablesize ();
421 if (getmaxvm (mode, &value) < 0)
424 case RLIMIT_MAXUPROC:
425 if (getmaxuprc (mode, &value) < 0)
437 #if defined (HAVE_RESOURCE)
438 if (getrlimit (limits[ind].parameter, &limit) < 0)
440 value = (mode & LIMIT_SOFT) ? limit.rlim_cur : limit.rlim_max;
442 if (limits[ind].parameter == RLIMIT_FILESIZE)
443 *limptr = value * 512; /* Ugh. */
456 set_limit (ind, newlim, mode)
461 #if defined (HAVE_RESOURCE)
466 if (limits[ind].parameter >= 256)
467 switch (limits[ind].parameter)
469 case RLIMIT_FILESIZE:
470 #if !defined (HAVE_RESOURCE)
471 return (ulimit (2, newlim / 512L));
477 case RLIMIT_OPENFILES:
478 #if defined (HAVE_SETDTABLESIZE)
479 return (setdtablesize (newlim));
481 case RLIMIT_PIPESIZE:
483 case RLIMIT_MAXUPROC:
490 #if defined (HAVE_RESOURCE)
491 if (getrlimit (limits[ind].parameter, &limit) < 0)
494 if (limits[ind].parameter == RLIMIT_FILESIZE)
495 newlim /= 512; /* Ugh. */
497 val = (current_user.euid != 0 && newlim == RLIM_INFINITY &&
498 (limit.rlim_cur <= limit.rlim_max))
499 ? limit.rlim_max : newlim;
500 if (mode & LIMIT_SOFT)
501 limit.rlim_cur = val;
502 if (mode & LIMIT_HARD)
503 limit.rlim_max = val;
505 return (setrlimit (limits[ind].parameter, &limit));
514 getmaxvm (mode, valuep)
518 #if defined (HAVE_RESOURCE)
520 RLIMTYPE maxdata, maxstack;
522 if (getrlimit (RLIMIT_DATA, &rl) < 0)
525 maxdata = (mode & LIMIT_SOFT) ? rl.rlim_cur : rl.rlim_max;
527 if (getrlimit (RLIMIT_STACK, &rl) < 0)
530 maxstack = (mode & LIMIT_SOFT) ? rl.rlim_cur : rl.rlim_max;
532 /* Protect against overflow. */
533 *valuep = (maxdata / 1024L) + (maxstack / 1024L);
538 #endif /* HAVE_RESOURCE */
545 #if !defined (HAVE_RESOURCE)
547 if ((result = ulimit (1, 0L)) < 0)
550 *valuep = (RLIMTYPE) result;
562 #if defined (PIPE_BUF)
563 /* This is defined on Posix systems. */
564 *valuep = (RLIMTYPE) PIPE_BUF;
567 # if defined (PIPESIZE)
568 /* This is defined by running a program from the Makefile. */
569 *valuep = (RLIMTYPE) PIPESIZE;
574 # endif /* PIPESIZE */
575 #endif /* PIPE_BUF */
579 getmaxuprc (mode, valuep)
583 # if defined (HAVE_SYSCONF) && defined (_SC_CHILD_MAX)
585 maxchild = sysconf (_SC_CHILD_MAX);
589 *valuep = (RLIMTYPE) maxchild;
591 # else /* !HAVE_SYSCONF || !_SC_CHILD_MAX */
592 # if defined (MAXUPRC)
593 *valuep = (RLIMTYPE) MAXUPRC;
598 # endif /* !MAXUPRC */
599 # endif /* !HAVE_SYSCONF || !_SC_CHILD_MAX */
603 print_all_limits (mode)
612 for (i = 0; limits[i].option > 0; i++)
614 if (get_limit (i, mode, &value) < 0)
616 fprintf (stderr, DESCFMT, limits[i].description);
617 builtin_error ("cannot get limit: %s", strerror (errno));
620 printone (i, value, 1);
625 printone (limind, curlim, pdesc)
631 printf (DESCFMT, limits[limind].description);
632 if (curlim == RLIM_INFINITY)
635 print_rlimtype ((curlim / limits[limind].block_factor), 1);