illumos/git/illumos-omnios: usr/src/man/man4/process.4 annotate

annotate usr/src/man/man4/process.4 @ 23918:f3c8f3a2a25c

13404 man page spelling errors Reviewed by: Ryan Zezeski <ryan@oxide.computer> Reviewed by: Robert Mustacchi <rm@fingolfin.org> Approved by: Richard Lowe <richlowe@richlowe.net>

author	Peter Tribble <peter.tribble@gmail.com>
date	Thu, 31 Dec 2020 10:47:42 +0000
parents	5b2854ecc12d
children	b40114c2395f

rev	line source
13304 b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	1 '\" te
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	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.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	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.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	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]
23918 f3c8f3a2a25c 13404 man page spelling errors Peter Tribble <peter.tribble@gmail.com> parents: 13476 diff changeset	6 .TH PROCESS 4 "December 28, 2020"
13304 b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	7 .SH NAME
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	8 process \- process contract type
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	9 .SH SYNOPSIS
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	10 .nf
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	11 \fB/system/contract/process\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	12 .fi
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	13
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	14 .SH DESCRIPTION
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	15 Process contracts allow processes to create a fault boundary around a set of
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	16 subprocesses and observe events which occur within that boundary.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	17 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	18 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	19 Process contracts are managed using the \fBcontract\fR(4) file system and the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	20 \fBlibcontract\fR(3LIB) library. The process contract type directory is
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	21 \fB/system/contract/process\fR.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	22 .SS "CREATION"
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	23 A process contract is created when an LWP that has an active process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	24 template calls \fBfork\fR(2). Initially, the child process created by
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	25 \fBfork()\fR is the only resource managed by the contract. When an LWP that
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	26 does not have an active process contract template calls \fBfork()\fR, the child
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	27 process created by \fBfork()\fR is added as a resource to the process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	28 of which the parent was a member.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	29 .SS "EVENT TYPES"
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	30 The following events types are defined:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	31 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	32 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	33 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	34 \fB\fBCT_PR_EV_EMPTY\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	35 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	36 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	37 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	38 The last member of the process contract exited.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	39 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	40
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	41 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	42 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	43 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	44 \fB\fBCT_PR_EV_FORK\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	45 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	46 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	47 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	48 A new process has been added to the process contract.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	49 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	50
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	51 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	52 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	53 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	54 \fB\fBCT_PR_EV_EXIT\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	55 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	56 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	57 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	58 A member of the process contract exited.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	59 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	60
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	61 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	62 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	63 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	64 \fB\fBCT_PR_EV_CORE\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	65 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	66 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	67 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	68 A process failed and dumped core. This could also occur if the process would
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	69 have dumped core had appropriate \fBcoreadm\fR(1M) options been enabled and
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	70 core file size was unlimited.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	71 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	72
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	73 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	74 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	75 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	76 \fB\fBCT_PR_EV_SIGNAL\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	77 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	78 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	79 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	80 A process received a fatal signal from a process, other than the owner of the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	81 process contract, that is a member of a different process contract.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	82 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	83
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	84 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	85 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	86 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	87 \fB\fBCT_PR_EV_HWERR\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	88 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	89 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	90 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	91 A process was killed because of an uncorrectable hardware error.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	92 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	93
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	94 .SS "TERMS"
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	95 The following common contract terms, defined in \fBcontract\fR(4), have
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	96 process-contract specific attributes:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	97 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	98 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	99 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	100 \fBcritical event set\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	101 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	102 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	103 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	104 The default value for the critical event set is \fB(CT_PR_EV_EMPTY \|
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	105 CT_PR_EV_HWERR)\fR.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	106 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	107 An attempt by a user without the \fB{PRIV_CONTRACT_EVENT}\fR privilege in its
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	108 effective set to add an event, other than \fBCT_PR_EV_EMPTY\fR, to the critical
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	109 event set which is not present in the fatal set, or if the \fBCT_PR_PGONLY\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	110 parameter is set and the same user attempts to add any event, other than
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	111 \fBCT_PR_EV_EMPTY\fR, to the critical event set, fails.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	112 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	113
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	114 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	115 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	116 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	117 \fBinformative event set\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	118 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	119 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	120 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	121 The default value for the informative event set is \fB(CT_PR_EV_CORE \|
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	122 CT_PR_EV_SIGNAL)\fR.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	123 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	124
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	125 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	126 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	127 The following contract terms can be read from or written to a process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	128 template using the named \fBlibcontract\fR(3LIB) interfaces. These contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	129 terms are in addition to those described in \fBcontract\fR(4).
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	130 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	131 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	132 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	133 \fBcreator's aux\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	134 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	135 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	136 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	137 Auxiliary contract description. The purpose of this field is to provide the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	138 contract creator with a way to differentiate process contracts it creates under
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	139 the same service FMRI. Use ct_pr_tmpl_set_svc_aux(3CONTRACT) to set this term.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	140 The default value is an empty string. The contents of this field should be
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	141 limited to 7-bit ASCII values.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	142 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	143
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	144 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	145 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	146 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	147 \fBfatal event set\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	148 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	149 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	150 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	151 Defines a set of events which, when generated, causes all members of the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	152 process contract to be killed with \fBSIGKILL\fR, or the intersection of the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	153 contract and the containing process group if the \fBCT_PR_PGRPONLY\fR parameter
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	154 is set. Set this term with \fBct_pr_tmpl_set_fatal\fR(3CONTRACT). The fatal
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	155 event set is restricted to \fBCT_PR_EV_CORE\fR, \fBCT_PR_EV_SIGNAL\fR, and
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	156 \fBCT_PR_EV_HWERR\fR. For \fBCT_PR_EV_CORE\fR and \fBCT_PR_EV_SIGNAL\fR events,
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	157 the scope of \fBSIGKILL\fR is limited to those processes which the contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	158 author or the event source could have normally sent signals to.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	159 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	160 The default value for the fatal event set is \fBCT_PR_EV_HWERR\fR.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	161 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	162 If a user without the \fB{PRIV_CONTRACT_EVENT}\fR privilege in its effective
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	163 set removes an event from the fatal event set which is present in the critical
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	164 event set, the corresponding event is automatically removed from the critical
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	165 event set and added to the informative event set.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	166 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	167
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	168 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	169 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	170 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	171 \fBparameter set\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	172 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	173 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	174 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	175 Defines miscellaneous other settings. Use \fBct_pr_tmpl_set_param\fR(3CONTRACT)
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	176 to set this term.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	177 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	178 The default parameter set is empty.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	179 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	180 The value is a bit vector comprised of some or all of:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	181 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	182 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	183 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	184 \fB\fBCT_PR_INHERIT\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	185 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	186 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	187 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	188 If set, indicates that the process contract is to be inherited by the process
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	189 contract the contract owner is a member of if the contract owner exits before
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	190 explicitly abandoning the process contract.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	191 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	192 If not set, the process contract is automatically abandoned when the owner
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	193 exits.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	194 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	195
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	196 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	197 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	198 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	199 \fB\fBCT_PR_NOORPHAN\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	200 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	201 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	202 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	203 If set, all processes in a process contract are sent \fBSIGKILL\fR if the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	204 process contract is abandoned, either explicitly or because the holder died and
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	205 \fBCT_PR_INHERIT\fR was not set. The scope of \fBSIGKILL\fR is limited to those
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	206 processes which the contract author or the event source could have normally
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	207 sent signals to.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	208 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	209 If this is not set and the process contract is abandoned, the process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	210 is orphaned, that is, continues to exist without owner.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	211 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	212
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	213 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	214 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	215 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	216 \fB\fBCT_PR_PGRPONLY\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	217 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	218 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	219 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	220 If set, only those processes within the same process group and process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	221 as a fatal error-generating process are killed.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	222 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	223 If not set, all processes within the process contract are killed if a member
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	224 process encounters an error specified in the fatal set.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	225 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	226 If a user without the \fB{PRIV_CONTRACT_EVENT}\fR privilege in its effective
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	227 set adds \fBCT_PR_PGRPONLY\fR to a template's parameter set, any events other
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	228 than \fBCT_PR_EV_EMPTY\fR are automatically removed from the critical event set
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	229 and added to the informative event set.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	230 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	231
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	232 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	233 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	234 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	235 \fB\fBCT_PR_REGENT\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	236 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	237 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	238 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	239 If set, the process contract can inherit unabandoned contracts left by exiting
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	240 member processes.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	241 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	242 If not set, indicates that the process contract should not inherit contracts
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	243 from member processes. If a process exits before abandoning a contract it owns
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	244 and is a member of a process contract which does not have \fBCT_PR_REGENT\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	245 set, the system automatically abandons the contract.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	246 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	247 If a regent process contract has inherited contracts and is abandoned by its
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	248 owner, its inherited contracts are abandoned.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	249 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	250
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	251 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	252
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	253 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	254 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	255 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	256 \fBservice FMRI\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	257 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	258 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	259 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	260 Specifies the service FMRI associated with the process contract. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	261 \fBct_pr_tmpl_set_svc_fmri\fR(3CONTRACT) to set this term. The default is to
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	262 inherit the value from the creator's process contract. When this term is
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	263 uninitialized, \fBct_pr_tmpl_get_svc_fmri\fR(3CONTRACT) returns the token
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	264 string \fBinherited:\fR to indicate the value has not been set and is
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	265 inherited. Setting the service FMRI to \fBinherited\fR: clears the current
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	266 (\fBB\fR value and the \fBterm\fR is inherited from the creator's process
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	267 contract. To set this term a process must have \fB{PRIV_CONTRACT_IDENTITY}\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	268 in its effective set.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	269 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	270
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	271 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	272 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	273 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	274 \fBtransfer contract\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	275 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	276 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	277 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	278 Specifies the ID of an empty process contract held by the caller whose
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	279 inherited process contracts are to be transferred to the newly created
23918 f3c8f3a2a25c 13404 man page spelling errors Peter Tribble <peter.tribble@gmail.com> parents: 13476 diff changeset	280 contract. Use \fBct_pr_tmpl_set_transfer\fR(3CONTRACT) to set the transfer
13304 b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	281 contract. Attempts to specify a contract not held by the calling process, or a
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	282 contract which still has processes in it, fail.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	283 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	284 The default transfer term is \fB0\fR, that is, no contract.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	285 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	286
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	287 .SS "STATUS"
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	288 In addition to the standard items, the status object read from a status file
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	289 descriptor contains the following items to obtain this information
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	290 respectively:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	291 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	292 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	293 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	294 \fBservice contract ID\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	295 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	296 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	297 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	298 Specifies the process contract id which defined the service FMRI term. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	299 \fBct_pr_status_get_svc_ctid\fR(3CONTRACT) to read the term's value. It can be
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	300 used to determine if the service FMRI was inherited as in the example below.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	301 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	302 .in +2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	303 .nf
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	304 ctid_t ctid; /* our contract id */
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	305 int fd; /* fd of ctid's status file */
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	306
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	307 ct_stathdl_(Bt status;
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	308 ctid_t svc_ctid;
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	309
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	310 if (ct_status_read(fd, CTD_FIXED, &status) == 0) {
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	311 if (ct_pr_status_get_svc_ctid(status, &svc_ctid) == 0) {
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	312 if (svc_ctid == ctid)
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	313 /* not inherited */
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	314 else
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	315 /* inherited */
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	316 }
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	317 ct_status_free(status);
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	318 }
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	319 .fi
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	320 .in -2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	321 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	322
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	323 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	324
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	325 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	326 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	327 If \fBCTD_ALL\fR is specified, the following items are also available:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	328 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	329 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	330 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	331 \fBMember list\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	332 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	333 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	334 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	335 The PIDs of processes which are members of the process contract. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	336 \fBct_pr_status_get_members\fR(3CONTRACT) for this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	337 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	338
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	339 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	340 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	341 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	342 \fBInherited contract list\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	343 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	344 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	345 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	346 The IDs of contracts which have been inherited by the process contract. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	347 \fBct_pr_status_get_contracts\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	348 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	349
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	350 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	351 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	352 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	353 \fBService FMRI (term)\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	354 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	355 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	356 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	357 Values equal to the terms used when the contract was written. The Service FMRI
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	358 term of the process contract of a process en(\fBBtering\fR a zone has the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	359 value \fBsvc:/system/zone_enter:default\fR when read from the non-global zone.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	360 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	361
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	362 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	363 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	364 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	365 \fBcontract creator\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	366 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	367 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	368 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	369 Specifies the process that created the process contract. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	370 \fBct_pr_status_get_svc_creator\fR(3CONTRACT) to read the term's value.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	371 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	372
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	373 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	374 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	375 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	376 \fBcreator's aux (term)\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	377 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	378 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	379 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	380 Values equal to the terms used when the contract was written.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	381 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	382
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	383 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	384 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	385 The following standard status items have different meanings in some situations:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	386 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	387 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	388 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	389 \fBOwnership state\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	390 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	391 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	392 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	393 If the process contract has a state of \fBCTS_OWNED\fR or \fBCTS_INHERITED\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	394 and is held by an entity in the global zone, but contains processes in a
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	395 non-global zone, it appears to have the state \fBCTS_OWNED\fR when observed by
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	396 processes in the non-global zone.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	397 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	398
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	399 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	400 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	401 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	402 \fBContract holder\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	403 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	404 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	405 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	406 If the process contract has a state of \fBCTS_OWNED\fR or \fBCTS_INHERITED\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	407 and is held by an entity in the global zone, but contains processes in a
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	408 non-global zone, it appears to be held by the non-global zone's \fBzsched\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	409 when observed by processes in the non-global zone.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	410 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	411
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	412 .SS "EVENTS"
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	413 In addition to the standard items, an event generated by a process contract
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	414 contains the following information:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	415 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	416 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	417 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	418 \fBGenerating PID\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	419 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	420 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	421 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	422 The process ID of the member process which experienced the event, or caused the
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	423 contract event to be generated (in the case of \fBCT_PR_EV_EMPTY\fR). Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	424 \fBct_pr_event_get_pid\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	425 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	426
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	427 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	428 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	429 If the event type is \fBCT_PR_EV_FORK\fR, the event contains:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	430 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	431 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	432 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	433 \fBParent PID\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	434 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	435 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	436 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	437 The process ID which forked [Generating PID]. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	438 \fBct_pr_event_get_ppid\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	439 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	440
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	441 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	442 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	443 If the event type is \fBCT_PR_EV_EXIT\fR, the event contains:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	444 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	445 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	446 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	447 \fBExit status\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	448 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	449 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	450 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	451 The exit status of the process. Use \fBct_pr_event_get_exitstatus\fR(3CONTRACT)
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	452 to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	453 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	454
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	455 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	456 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	457 If the event type is \fBCT_PR_EV_CORE\fR, the event can contain:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	458 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	459 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	460 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	461 \fBProcess core name\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	462 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	463 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	464 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	465 The name of the per-process core file. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	466 \fBct_pr_event_get_pcorefile\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	467 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	468
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	469 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	470 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	471 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	472 \fBGlobal core name\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	473 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	474 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	475 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	476 The name of the process's zone's global core file. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	477 \fBct_pr_event_get_gcorefile\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	478 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	479
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	480 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	481 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	482 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	483 \fBZone core name\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	484 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	485 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	486 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	487 The name of the system-wide core file in the global zone. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	488 \fBct_pr_event_get_zcorefile\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	489 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	490
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	491 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	492 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	493 See \fBcoreadm\fR(1M) for more information about per-process, global, and
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	494 system-wide core files.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	495 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	496 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	497 If the event type is \fBCT_PR_EV_SIGNAL\fR, the event contains:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	498 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	499 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	500 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	501 \fBSignal\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	502 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	503 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	504 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	505 The number of the signal which killed the process. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	506 \fBct_pr_event_get_signal\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	507 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	508
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	509 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	510 .LP
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	511 It can contain:
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	512 .sp
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	513 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	514 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	515 \fBsender\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	516 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	517 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	518 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	519 The PID of the process which sent the signal. Use
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	520 \fBct_pr_event_get_sender\fR(3CONTRACT) to obtain this information.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	521 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	522
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	523 .SH FILES
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	524 .ne 2
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	525 .na
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	526 \fB\fB/usr/include/sys/contract/process.h\fR\fR
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	527 .ad
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	528 .sp .6
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	529 .RS 4n
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	530 Contains definitions of event-type macros.
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	531 .RE
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	532
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	533 .SH SEE ALSO
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	534 \fBctrun\fR(1), \fBctstat\fR(1), \fBctwatch\fR(1), \fBcoreadm\fR(1M),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	535 \fBclose\fR(2), \fBfork\fR(2), \fBioctl\fR(2), \fBopen\fR(2), \fBpoll\fR(2),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	536 \fBct_pr_event_get_exitstatus\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	537 \fBct_pr_event_get_gcorefile\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	538 \fBct_pr_event_get_pcorefile\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	539 \fBct_pr_event_get_pid\fR(3CONTRACT), \fBct_pr_event_get_ppid\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	540 \fBct_pr_event_get_signal\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	541 \fBct_pr_event_get_zcorefile\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	542 \fBct_pr_status_get_contracts\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	543 \fBct_pr_status_get_members\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	544 \fBct_pr_status_get_param\fR(3CONTRACT), \fBct_pr_tmpl_set_fatal\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	545 \fBct_pr_tmpl_set_param\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	546 \fBct_pr_tmpl_set_transfer\fR(3CONTRACT), \fBct_tmpl_set_cookie\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	547 \fBct_tmpl_set_critical\fR(3CONTRACT),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	548 \fBct_tmpl_set_informative\fR(3CONTRACT), \fBlibcontract\fR(3LIB),
b54231762cfa 243 system manual pages should live with the software Richard Lowe <richlowe@richlowe.net> parents: diff changeset	549 \fBcontract\fR(4), \fBprivileges\fR(5)

Mercurial > illumos > git > illumos-omnios

annotate usr/src/man/man4/process.4 @ 23918:f3c8f3a2a25c