Standard C Library Functions doorinfo(3C)
NAME
doorinfo - return information associated with a door
descriptor
SYNOPSIS
cc -mt [ flag... ] file... [ library... ]
#include
int doorinfo(int d, struct doorinfo *info);
DESCRIPTION
The doorinfo() function returns information associated with
a door descriptor. It obtains information about the door
descriptor d and places the information that is relevant to
the door in the structure pointed to by the info argument.
The doorinfo structure pointed to by the info argument con-
tains the following members:
pidt ditarget; /* door server pid */
doorptrt diproc; /* server function */
doorptrt didata; /* data cookie for invocation */
doorattrt diattributes; /* door attributes */
dooridt diuniquifier; /* unique id among all doors */
The ditarget member is the process ID of the door server,
or -1 if the door server process has exited.
The values for diattributes may be composed of the follow-
ing:
DORLOCAL The door descriptor refers to a service
procedure in this process.
DORUNREF The door has requested notification when
all but the last reference has gone
away.
DORUNREFMULTI Similar to DORUNREF, except multiple
unreferenced notifications may be
delivered for this door.
DORISUNREF There is currently only one descriptor
referring to the door.
SunOS 5.11 Last change: 22 Mar 2005 1
Standard C Library Functions doorinfo(3C)
DOREFUSEDESC The door refuses any attempt to
doorcall(3C) it with argument descrip-
tors.
DORNOCANCEL Clients who abort a doorcall(3C) call
on this door will not cause the cancel-
lation(5) of the server thread handling
the request.
DOREVOKED The door descriptor refers to a door
that has been revoked.
DORPRIVATE The door has a separate pool of server
threads associated with it.
The diproc and didata members are returned as doorptrt
objects rather than void * 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
doorcreate(). This number is returned in diuniquifier.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1
is returned and errno is set to indicate the error.
ERORS
The doorinfo() function will fail if:
EFAULT The address of argument info is an invalid
address.
EBADF d is not a door descriptor.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 22 Mar 2005 2
Standard C Library Functions doorinfo(3C)
ATRIBUTE TYPE ATRIBUTE VALUE
Architecture all
Availability SUNWcsu
Interface Stability Stable
MT-Level Safe
SEE ALSO
doorbind(3C), doorcall(3C), doorcreate(3C),
doorservercreate(3C), attributes(5), cancellation(5)
SunOS 5.11 Last change: 22 Mar 2005 3
|
