csx_MakeDeviceNode(9F) Kernel Functions for Drivers csx_MakeDeviceNode(9F)
NAME
csx_MakeDeviceNode, csx_RemoveDeviceNode - create and remove minor nodes on behalf of the client
SYNOPSIS
#include <sys/pccard.h>
int32_t csx_MakeDeviceNode(client_handle_t ch, make_device_node_t *dn);
int32_t csx_RemoveDeviceNode(client_handle_t ch, remove_device_node_t *dn);
INTERFACE LEVEL
Solaris DDI Specific (Solaris DDI)
PARAMETERS
ch Client handle returned from csx_RegisterClient(9F).
dn Pointer to a make_device_node_t or remove_device_node_t structure.
DESCRIPTION
csx_MakeDeviceNode() and csx_RemoveDeviceNode() are Solaris-specific extensions to allow the client to request that device nodes in the
filesystem are created or removed, respectively, on its behalf.
STRUCTURE MEMBERS
The structure members of make_device_node_t are:
uint32_t Action; /* device operation */
uint32_t NumDevNodes; /* number of nodes to create */
devnode_desc_t *devnode_desc; /* description of device nodes */
The structure members of remove_device_node_t are:
uint32_t Action; /* device operation */
uint32_t NumDevNodes; /* number of nodes to remove */
devnode_desc_t *devnode_desc; /* description of device nodes */
The structure members of devnode_desc_t are:
char *name; /* device node path and name */
int32_t spec_type; /* device special type (block or char) */
int32_t minor_num; /* device node minor number */
char *node_type; /* device node type */
The Action field is used to specify the operation that csx_MakeDeviceNode() and csx_RemoveDeviceNode() should perform.
The following Action values are defined for csx_MakeDeviceNode():
CREATE_DEVICE_NODE Create NumDevNodes minor nodes
The following Action values are defined for csx_RemoveDeviceNode():
REMOVE_DEVICE_NODE Remove NumDevNodes minor nodes
REMOVE_ALL_DEVICE_NODES Remove all minor nodes for this client
For csx_MakeDeviceNode(), if the Action field is:
CREATE_DEVICE_NODE The NumDevNodes field must be set to the number of minor devices to create, and the client must allocate the quan-
tity of devnode_desc_t structures specified by NumDevNodes and fill out the fields in the devnode_desc_t structure
with the appropriate minor node information. The meanings of the fields in the devnode_desc_t structure are identi-
cal to the parameters of the same name to the ddi_create_minor_node(9F) DDI function.
For csx_RemoveDeviceNode(), if the Action field is:
REMOVE_DEVICE_NODE The NumDevNodes field must be set to the number of minor devices to remove, and the client must allocate the
quantity of devnode_desc_t structures specified by NumDevNodes and fill out the fields in the devnode_desc_t
structure with the appropriate minor node information. The meanings of the fields in the devnode_desc_t struc-
ture are identical to the parameters of the same name to the ddi_remove_minor_node(9F) DDI function.
REMOVE_ALL_DEVICE_NODES The NumDevNodes field must be set to 0 and the devnode_desc_t structure pointer must be set to NULL. All device
nodes for this client will be removed from the filesystem.
RETURN VALUES
CS_SUCCESS Successful operation.
CS_BAD_HANDLE Client handle is invalid.
CS_BAD_ATTRIBUTE The value of one or more arguments is invalid.
CS_BAD_ARGS Action is invalid.
CS_OUT_OF_RESOURCE Unable to create or remove device node.
CS_UNSUPPORTED_FUNCTION No PCMCIA hardware installed.
CONTEXT
These functions may be called from user or kernel context.
SEE ALSO
csx_RegisterClient(9F), ddi_create_minor_node(9F), ddi_remove_minor_node(9F)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 19 Jul 1996 csx_MakeDeviceNode(9F)