.th K_get_segment_status II 4/21/86
.sh NAME
K_get_segment_status - get type dependent information for a segment
.sh "MODULA SYNOPSIS"
.nh
.na
 CONST segSeid: seid;
.br
 CONST segDes: seg_des;
.br
 VAR status: seg_stat_block;
.br
 VAR stat: K_err_num;
.br
 . . .
.br
 stat := NK_get_segment_status(segSeid, segDes, status);
.br
.hy
.ad
.sp
.sh "C SYNOPSIS"
.nh
.na
 seid segSeid;
.br
 seg_des segDes;
.br
 seg_stat_block status;
.br
 int stat;
.br
 . . .
.br
 stat = K_get_segment_status (segSeid, segDes, &status);
.br
.hy
.ad
.sh DESCRIPTION
K_get_segment_status returns, in the parameter status, the type
dependent information associated with a segment described by segSeid or
SegDes.  The segment descriptor segDes will be used to reference the
segment if it is non-null, otherwise segSeid will indicate the segment.
A process may successfully obtain type dependent status about any
segment from which information could flow to the process.  No
discretionary access checking shall be performed.
.sh EXCEPTIONS
.lp 22 15
XbSgDes	Bad segment descriptor:  This segment descriptor
is inactive.
.lp 22 15
XbSgSd	Bad segment seid:  segSeid is not the seid of an
existing segment or process does not have
mandatory (security) access to the segment.
.lp 22 15
XnSgDes	Not a segment descriptor:  This number is outside
the set of segment descriptors.
.i0
.sh "SEE ALSO"
K_build_segment(II),
K_release_segment(II),
K_rendezvous_segment(II),
K_set_segment_status(II),
seg_stat_block(IIa)
