| limits.1 (79755) | limits.1 (95124) |
|---|---|
| 1.\" Copyright (c) 1996 David Nugent <davidn@blaze.net.au> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, is permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice immediately at the beginning of the file, without modification, 9.\" this list of conditions, and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. This work was done expressly for inclusion into FreeBSD. Other use 14.\" is permitted provided this notation is included. 15.\" 4. Absolutely no warranty of function or purpose is made by the author 16.\" David Nugent. 17.\" 5. Modifications may be freely made to this file providing the above 18.\" conditions are met. 19.\" | 1.\" Copyright (c) 1996 David Nugent <davidn@blaze.net.au> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, is permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice immediately at the beginning of the file, without modification, 9.\" this list of conditions, and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. This work was done expressly for inclusion into FreeBSD. Other use 14.\" is permitted provided this notation is included. 15.\" 4. Absolutely no warranty of function or purpose is made by the author 16.\" David Nugent. 17.\" 5. Modifications may be freely made to this file providing the above 18.\" conditions are met. 19.\" |
| 20.\" $FreeBSD: head/usr.bin/limits/limits.1 79755 2001-07-15 08:06:20Z dd $ | 20.\" $FreeBSD: head/usr.bin/limits/limits.1 95124 2002-04-20 12:18:28Z charnier $ |
| 21.\" 22.Dd January 15, 1996 23.Dt LIMITS 1 24.Os 25.Sh NAME 26.Nm limits 27.Nd set or display process resource limits 28.Sh SYNOPSIS --- 17 unchanged lines hidden (view full) --- 46.Nm 47.Op Fl U Ar user 48.Op Fl SHB 49.Op Fl cdflmnstu Op val 50.Op Fl E 51.Op Ar name Ns = Ns Ar value ... 52.Op Ar command 53.Sh DESCRIPTION | 21.\" 22.Dd January 15, 1996 23.Dt LIMITS 1 24.Os 25.Sh NAME 26.Nm limits 27.Nd set or display process resource limits 28.Sh SYNOPSIS --- 17 unchanged lines hidden (view full) --- 46.Nm 47.Op Fl U Ar user 48.Op Fl SHB 49.Op Fl cdflmnstu Op val 50.Op Fl E 51.Op Ar name Ns = Ns Ar value ... 52.Op Ar command 53.Sh DESCRIPTION |
| 54.Nm Limits 55either prints or sets kernel resource limits, and may optionally set | 54The 55.Nm 56utility either prints or sets kernel resource limits, and may optionally set |
| 56environment variables like 57.Xr env 1 58and run a program with the selected resources. 59Three uses of the 60.Nm 61command are possible: 62.Pp 63.Bl -tag -width indent --- 231 unchanged lines hidden (view full) --- 295call, only the superuser may raise process "hard" resource limits. 296Non-root users may, however, lower them or change "soft" resource limits 297within to any value below the hard limit. 298When invoked to execute a program, the failure of 299.Nm 300to raise a hard limit is considered a fatal error. 301.El 302.Sh DIAGNOSTICS | 57environment variables like 58.Xr env 1 59and run a program with the selected resources. 60Three uses of the 61.Nm 62command are possible: 63.Pp 64.Bl -tag -width indent --- 231 unchanged lines hidden (view full) --- 296call, only the superuser may raise process "hard" resource limits. 297Non-root users may, however, lower them or change "soft" resource limits 298within to any value below the hard limit. 299When invoked to execute a program, the failure of 300.Nm 301to raise a hard limit is considered a fatal error. 302.El 303.Sh DIAGNOSTICS |
| 303.Nm Limits | 304The 305.Nm 306utility |
| 304exits with EXIT_FAILURE if usage is incorrect in any way; i.e. an invalid 305option, or set/display options are selected in the same invocation, 306.Fl e 307is used when running a program, etc. 308When run in display or eval mode, 309.Nm 310exits with a status of EXIT_SUCCESS. 311When run in command mode and execution of the command succeeds, the exit status --- 4 unchanged lines hidden (view full) --- 316.Xr limit 1 , 317.Xr sh 1 , 318.Xr getrlimit 2 , 319.Xr setrlimit 2 , 320.Xr login_cap 3 , 321.Xr login.conf 5 , 322.Xr sysctl 8 323.Sh BUGS | 307exits with EXIT_FAILURE if usage is incorrect in any way; i.e. an invalid 308option, or set/display options are selected in the same invocation, 309.Fl e 310is used when running a program, etc. 311When run in display or eval mode, 312.Nm 313exits with a status of EXIT_SUCCESS. 314When run in command mode and execution of the command succeeds, the exit status --- 4 unchanged lines hidden (view full) --- 319.Xr limit 1 , 320.Xr sh 1 , 321.Xr getrlimit 2 , 322.Xr setrlimit 2 , 323.Xr login_cap 3 , 324.Xr login.conf 5 , 325.Xr sysctl 8 326.Sh BUGS |
| 324.Nm Limits 325does not handle commands with equal (``='') signs in their | 327The 328.Nm 329utility does not handle commands with equal (``='') signs in their |
| 326names, for obvious reasons. 327.Pp 328When eval output is selected, the 329.Pa /proc 330filesystem must be installed 331and mounted for the shell to be correctly determined, and therefore 332output syntax correct for the running shell. 333The default output is valid for 334.Xr sh 1 , 335so this means that any 336usage of 337.Nm 338in eval mode prior mounting 339.Pa /proc 340may only occur in standard bourne 341shell scripts. 342.Pp | 330names, for obvious reasons. 331.Pp 332When eval output is selected, the 333.Pa /proc 334filesystem must be installed 335and mounted for the shell to be correctly determined, and therefore 336output syntax correct for the running shell. 337The default output is valid for 338.Xr sh 1 , 339so this means that any 340usage of 341.Nm 342in eval mode prior mounting 343.Pa /proc 344may only occur in standard bourne 345shell scripts. 346.Pp |
| 343.Nm Limits 344makes no effort to ensure that resource settings emitted or displayed | 347The 348.Nm 349utility makes no effort to ensure that resource settings emitted or displayed |
| 345are valid and settable by the current user. 346Only a superuser account may raise hard limits, and when doing so 347the 348.Fx 349kernel will silently lower limits to values less than 350specified if the values given are too high. | 350are valid and settable by the current user. 351Only a superuser account may raise hard limits, and when doing so 352the 353.Fx 354kernel will silently lower limits to values less than 355specified if the values given are too high. |