1 '\" te
2 .\" Copyright (c) 2008, 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 PROCESS 4 "Mar 25, 2008"
7 .SH NAME
8 process \- process contract type
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/system/contract/process\fR
13 .fi
14
15 .SH DESCRIPTION
16 .sp
17 .LP
18 Process contracts allow processes to create a fault boundary around a set of
19 subprocesses and observe events which occur within that boundary.
20 .sp
21 .LP
22 Process contracts are managed using the \fBcontract\fR(4) file system and the
23 \fBlibcontract\fR(3LIB) library. The process contract type directory is
24 \fB/system/contract/process\fR.
25 .SS "CREATION"
26 .sp
185 to set this term.
186 .sp
187 The default parameter set is empty.
188 .sp
189 The value is a bit vector comprised of some or all of:
190 .sp
191 .ne 2
192 .na
193 \fB\fBCT_PR_INHERIT\fR\fR
194 .ad
195 .sp .6
196 .RS 4n
197 If set, indicates that the process contract is to be inherited by the process
198 contract the contract owner is a member of if the contract owner exits before
199 explicitly abandoning the process contract.
200 .sp
201 If not set, the process contract is automatically abandoned when the owner
202 exits.
203 .RE
204
205 .sp
206 .ne 2
207 .na
208 \fB\fBCT_PR_NOORPHAN\fR\fR
209 .ad
210 .sp .6
211 .RS 4n
212 If set, all processes in a process contract are sent \fBSIGKILL\fR if the
213 process contract is abandoned, either explicitly or because the holder died and
214 \fBCT_PR_INHERIT\fR was not set. The scope of \fBSIGKILL\fR is limited to those
215 processes which the contract author or the event source could have normally
216 sent signals to.
217 .sp
218 If this is not set and the process contract is abandoned, the process contract
219 is orphaned, that is, continues to exist without owner.
220 .RE
221
222 .sp
223 .ne 2
224 .na
|
1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
3 .\" Copyright 2016, Joyent, Inc.
4 .\" 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.
5 .\" 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.
6 .\" 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]
7 .TH PROCESS 4 "Sept 6, 2016"
8 .SH NAME
9 process \- process contract type
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fB/system/contract/process\fR
14 .fi
15
16 .SH DESCRIPTION
17 .sp
18 .LP
19 Process contracts allow processes to create a fault boundary around a set of
20 subprocesses and observe events which occur within that boundary.
21 .sp
22 .LP
23 Process contracts are managed using the \fBcontract\fR(4) file system and the
24 \fBlibcontract\fR(3LIB) library. The process contract type directory is
25 \fB/system/contract/process\fR.
26 .SS "CREATION"
27 .sp
186 to set this term.
187 .sp
188 The default parameter set is empty.
189 .sp
190 The value is a bit vector comprised of some or all of:
191 .sp
192 .ne 2
193 .na
194 \fB\fBCT_PR_INHERIT\fR\fR
195 .ad
196 .sp .6
197 .RS 4n
198 If set, indicates that the process contract is to be inherited by the process
199 contract the contract owner is a member of if the contract owner exits before
200 explicitly abandoning the process contract.
201 .sp
202 If not set, the process contract is automatically abandoned when the owner
203 exits.
204 .RE
205
206 .sp
207 .ne 2
208 .na
209 \fB\fBCT_PR_KEEP_EXEC\fR\fR
210 .ad
211 .sp .6
212 .RS 4n
213 If set, the process contract template remains active across \fBexec\fR(2).
214 This can be used to setup a contract for children of an application which
215 is not contract-aware. If this is not set then the system clears the active
216 template when the process execs. Because this option is intended for an
217 application which is not contract-aware, new child process contracts will be
218 automatically abandoned by the parent.
219 .RE
220
221 .sp
222 .ne 2
223 .na
224 \fB\fBCT_PR_NOORPHAN\fR\fR
225 .ad
226 .sp .6
227 .RS 4n
228 If set, all processes in a process contract are sent \fBSIGKILL\fR if the
229 process contract is abandoned, either explicitly or because the holder died and
230 \fBCT_PR_INHERIT\fR was not set. The scope of \fBSIGKILL\fR is limited to those
231 processes which the contract author or the event source could have normally
232 sent signals to.
233 .sp
234 If this is not set and the process contract is abandoned, the process contract
235 is orphaned, that is, continues to exist without owner.
236 .RE
237
238 .sp
239 .ne 2
240 .na
|