Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3c/door_info.3c
Real path: /usr/share/man/man3c/door_info.3c
Zurück

'\" te
.\" Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
.TH door_info 3C "04 May 2016" "Oracle Solaris 11.4" "Standard C Library Functions"
.SH NAME
door_info \- return information associated with a door descriptor
.SH SYNOPSIS

.LP
.nf
#include <door.h>

\fBint\fR \fBdoor_info\fR(\fBint\fR \fId\fR, \fBstruct door_info *\fR\fIinfo\fR);
.fi
.SH DESCRIPTION
.sp
.LP
The \fBdoor_info()\fR function returns information associated with a door descriptor. It obtains information about the door descriptor \fId\fR and places the information that is relevant to the door in the structure pointed to by the \fIinfo\fR argument. 
.sp
.LP
The \fBdoor_info\fR structure pointed to by the \fIinfo\fR argument contains the following members:
.sp
.in +2
.nf
pid_t           di_target;      /* door server pid */
door_ptr_t      di_proc;        /* server function */
door_ptr_t      di_data;        /* data cookie for invocation */
door_attr_t     di_attributes;  /* door attributes */
door_id_t       di_uniquifier;  /* unique id among all doors */
.fi
.in -2
.sp
.sp
.LP
The \fBdi_target\fR member is the process \fBID\fR of the door server, or \fB\(mi1\fR if the door server process has exited.
.sp
.LP
The values for \fBdi_attributes\fR may be composed of the following:
.sp
.ne 2
.mk
.na
\fB\fBDOOR_LOCAL\fR\fR
.ad
.RS 20n
.rt
The door descriptor refers to a service procedure in this process.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_UNREF\fR\fR
.ad
.RS 20n
.rt
The door has requested notification when all but the last reference has gone away.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_UNREF_MULTI\fR\fR
.ad
.RS 20n
.rt
Similar to \fBDOOR_UNREF\fR, except multiple unreferenced notifications may be delivered for this door.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_IS_UNREF\fR\fR
.ad
.RS 20n
.rt
There is currently only one descriptor referring to the door.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_REFUSE_DESC\fR\fR
.ad
.RS 20n
.rt
The door refuses any attempt to \fBdoor_call\fR(3C) it with argument descriptors.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_NO_CANCEL\fR\fR
.ad
.RS 20n
.rt
Clients who abort a \fBdoor_call\fR(3C) call on this door will not cause the \fBcancellation\fR(7) of the server thread handling the request.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_REVOKED\fR\fR
.ad
.RS 20n
.rt
The door descriptor refers to a door that has been revoked.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_PRIVATE\fR\fR
.ad
.RS 20n
.rt
The door has a separate pool of server threads associated with it.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDOOR_ON_TPD\fR\fR
.ad
.RS 20n
.rt
The door server is run in the TPD process. For more information, see the \fBtpd\fR(7) man page.
.RE

.sp
.LP
The \fBdi_proc\fR and \fBdi_data\fR members are returned as \fBdoor_ptr_t\fR objects rather than \fBvoid\fR  \fB*\fR pointers to allow clients and servers to interoperate in environments where the pointer sizes may vary in size (for example, 32-bit clients and 64-bit servers). Each door has a system-wide unique number associated with it that is set when the door is created by \fBdoor_create()\fR. This number is returned in \fBdi_uniquifier\fR.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fB0\fR is returned. Otherwise, \fB\(mi1\fR is returned and \fBerrno\fR is set to indicate the error.
.SH ERRORS
.sp
.LP
The \fBdoor_info()\fR function will fail if:
.sp
.ne 2
.mk
.na
\fB\fBEFAULT\fR\fR
.ad
.RS 10n
.rt
The address of argument \fIinfo\fR is an invalid address.
.RE

.sp
.ne 2
.mk
.na
\fB\fBEBADF\fR\fR
.ad
.RS 10n
.rt
\fId\fR is not a door descriptor.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Architecture
all
_
Availability
system/core-os
_
Interface Stability
Committed
_
MT-Level
Safe
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBdoor_bind\fR(3C), \fBdoor_call\fR(3C), \fBdoor_create\fR(3C), \fBdoor_server_create\fR(3C), \fBattributes\fR(7), \fBcancellation\fR(7), \fBtpd\fR(7)