NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO
cc [ flag ... ] file ... -ldoor [ library ... ] #include <door.h>int door_info(int d, struct door_info *info);
The door_info() 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 structure pointed to by the info argument contains the following members:
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 */
The di_target member is the process ID of the door server, or -1 if the door server process has exited.
The values for di_attributes may be composed of the following:
The door descriptor refers to a service procedure in this process.
The door has requested notification when all but the last reference has gone away.
Similar to DOOR_UNREF, except multiple unreferenced notifications may be delivered for this door.
There is currently only one descriptor referring to the door.
The door descriptor refers to a door that has been revoked.
The door has a separate pool of server threads associated with it.
The di_proc and di_data members are returned as door_ptr_t 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 door_create(). This number is returned in di_uniquifier.
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.
The door_info() function will fail if:
The address of argument info is an invalid address.
d is not a door descriptor.
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO