share/man/man1/plimit.1

   1 '\" te
   2 .\"  Copyright (c) 1998 by Sun Microsystems, Inc.  All rights reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH PLIMIT 1 "Jun 8, 1998"
   7 .SH NAME
   8 plimit \- get or set the resource limits of running processes
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBplimit\fR [\fB-km\fR] \fIpid\fR...
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBplimit\fR {\fB-cdfnstv\fR} \fIsoft\fR,\fIhard\fR... pid...
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 If one or more of the \fBcdfnstv\fR options is specified, \fBplimit\fR sets the
  24 soft (current) limit and/or the hard (maximum) limit of the indicated
  25 resource(s) in the processes identified by the process-ID list, \fIpid\fR.
  26 Otherwise \fBplimit\fR reports the resource limits of the processes identified
  27 by the process-ID list, \fIpid\fR.
  28 .sp
  29 .LP
  30 Only the owner of a process or the super-user is permitted either to get or to
  31 set the resource limits of a process. Only the super-user can increase the hard
  32 limit.
  33 .SH OPTIONS
  34 .sp
  35 .LP
  36 The following options are supported:
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fB-k\fR\fR
  41 .ad
  42 .RS 6n
  43 On output, show file sizes in kilobytes (1024 bytes) rather than in 512-byte
  44 blocks.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fB-m\fR\fR
  51 .ad
  52 .RS 6n
  53 On output, show file and memory sizes in megabytes (1024*1024 bytes).
  54 .RE
  55
  56 .sp
  57 .LP
  58 The remainder of the options are used to change specified resource limits. They
  59 each accept an argument of the form:
  60 .sp
  61 .LP
  62 \fIsoft\fR,\fIhard\fR
  63 .sp
  64 .LP
  65 where \fIsoft\fR specifies the soft (current) limit and \fIhard\fR specifies
  66 the hard (maximum) limit. If the hard limit is not specified, the comma may be
  67 omitted. If the soft limit is an empty string, only the hard limit is set. Each
  68 limit is either the literal string \fBunlimited\fR, or a number, with an
  69 optional scaling factor, as follows:
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fIn\fR\fBk\fR\fR
  74 .ad
  75 .RS 9n
  76 \fIn\fR kilobytes
  77 .RE
  78
  79 .sp
  80 .ne 2
  81 .na
  82 \fB\fIn\fR\fBm\fR\fR
  83 .ad
  84 .RS 9n
  85 \fIn\fR megabytes (minutes for CPU time)
  86 .RE
  87
  88 .sp
  89 .ne 2
  90 .na
  91 \fB\fIn\fR\fBh\fR\fR
  92 .ad
  93 .RS 9n
  94 \fIn\fR hours (for CPU time only)
  95 .RE
  96
  97 .sp
  98 .ne 2
  99 .na
 100 \fB\fImm\fR\fB:\fR\fIss\fR\fR
 101 .ad
 102 .RS 9n
 103 minutes and seconds (for CPU time only)
 104 .RE
 105
 106 .sp
 107 .LP
 108 The soft limit cannot exceed the hard limit.
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB-c\fR\fI soft,hard\fR\fR
 113 .ad
 114 .RS 16n
 115 Set core file size limits (default unit is 512-byte blocks).
 116 .RE
 117
 118 .sp
 119 .ne 2
 120 .na
 121 \fB\fB-d\fR\fI soft,hard\fR\fR
 122 .ad
 123 .RS 16n
 124 Set data segment (heap) size limits (default unit is kilobytes).
 125 .RE
 126
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB-f\fR\fI soft,hard\fR\fR
 131 .ad
 132 .RS 16n
 133 Set file size limits (default unit is 512-byte blocks).
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB-n\fR\fI soft,hard\fR\fR
 140 .ad
 141 .RS 16n
 142 Set file descriptor limits (no default unit).
 143 .RE
 144
 145 .sp
 146 .ne 2
 147 .na
 148 \fB\fB-s\fR\fI soft,hard\fR\fR
 149 .ad
 150 .RS 16n
 151 Set stack segment size limits (default unit is kilobytes).
 152 .RE
 153
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fB-t\fR\fI soft,hard\fR\fR
 158 .ad
 159 .RS 16n
 160 Set CPU time limits (default unit is seconds).
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fB-v\fR\fI soft,hard\fR\fR
 167 .ad
 168 .RS 16n
 169 Set virtual memory size limits (default unit is kilobytes).
 170 .RE
 171
 172 .SH OPERANDS
 173 .sp
 174 .LP
 175 The following operands are supported.
 176 .sp
 177 .ne 2
 178 .na
 179 \fBpid\fR
 180 .ad
 181 .RS 7n
 182 Process ID list.
 183 .RE
 184
 185 .SH EXIT STATUS
 186 .sp
 187 .LP
 188 \fBplimit\fR returns the exit value zero on success, non-zero on failure (such
 189 as no such process, permission denied, or invalid option).
 190 .SH FILES
 191 .sp
 192 .ne 2
 193 .na
 194 \fB\fB/proc/\fR\fIpid\fR\fB/*\fR\fR
 195 .ad
 196 .RS 15n
 197 process information and control files
 198 .RE
 199
 200 .SH SEE ALSO
 201 .sp
 202 .LP
 203 \fBulimit\fR(1), \fBproc\fR(1), \fBgetrlimit\fR(2), \fBsetrlimit\fR(2),
 204 \fBproc\fR(4), \fBattributes\fR(5),